
    gR                     p    d Z ddlZddlmZmZ  ed          Zdee         dedeee                  fdZdS )	z9Contains a utility to iterate by chunks over an iterator.    N)IterableTypeVarTiterable
chunk_sizereturnc              #     K   t          |t                    r|dk    rt          d          t          |           }	 	 t	          |          }n# t
          $ r Y dS w xY wt          j        |ft          j        ||dz
                      V  Q)a  Iterates over an iterator chunk by chunk.

    Taken from https://stackoverflow.com/a/8998040.
    See also https://github.com/huggingface/huggingface_hub/pull/920#discussion_r938793088.

    Args:
        iterable (`Iterable`):
            The iterable on which we want to iterate.
        chunk_size (`int`):
            Size of the chunks. Must be a strictly positive integer (e.g. >0).

    Example:

    ```python
    >>> from huggingface_hub.utils import chunk_iterable

    >>> for items in chunk_iterable(range(17), chunk_size=8):
    ...     print(items)
    # [0, 1, 2, 3, 4, 5, 6, 7]
    # [8, 9, 10, 11, 12, 13, 14, 15]
    # [16] # smaller last chunk
    ```

    Raises:
        [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)
            If `chunk_size` <= 0.

    <Tip warning={true}>
        The last chunk can be smaller than `chunk_size`.
    </Tip>
    r   z6`chunk_size` must be a strictly positive integer (>0).TN   )	
isinstanceint
ValueErroriternextStopIteration	itertoolschainislice)r   r   iterator	next_items       ^/var/www/html/ai-engine/env/lib/python3.11/site-packages/huggingface_hub/utils/_chunk_utils.pychunk_iterabler      s      @ j#&& S*//QRRRH~~HX	XII 	 	 	FF	oylI,<XzTU~,V,VWWWWWXs   A 
AA)__doc__r   typingr   r   r   r   r        r   <module>r      s    @ ?     $ $ $ $ $ $ $ $ GCLL)XXa[ )Xc )XhxPQ{>S )X )X )X )X )X )Xr   