
    gR                     V    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y)	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	        |      }t        j                  |ft        j                  ||dz
               =# t
        $ r Y yw xY ww)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).N   )	
isinstanceint
ValueErroriternextStopIteration	itertoolschainislice)r   r   iterator	next_items       W/var/www/openai/venv/lib/python3.12/site-packages/huggingface_hub/utils/_chunk_utils.pychunk_iterabler      s~     @ j#&*/QRRH~H
	XI ooylI,<,<XzTU~,VWW   		s'   -A;A, 1A;,	A85A;7A88A;)__doc__r   typingr   r   r   r   r        r   <module>r      sH    @  $ CL)XXa[ )Xc )XhxPQ{>S )Xr   