U
    +È-eQ  ã                   @   sF   d Z ddlZddlmZmZ edƒZee eeee  dœdd„ZdS )z9Contains a utility to iterate by chunks over an iterator.é    N)ÚIterableÚTypeVarÚT)ÚiterableÚ
chunk_sizeÚreturnc                 c   sh   t |tƒr|dkrtdƒ‚t| ƒ}zt|ƒ}W n tk
rD   Y dS X t |ft ||d ¡¡V  q"dS )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   ÚiteratorZ	next_item© r   úc/var/www/html/Darija-Ai-Train/env/lib/python3.8/site-packages/huggingface_hub/utils/_chunk_utils.pyÚchunk_iterable   s     r   )Ú__doc__r   Útypingr   r   r   r
   r   r   r   r   r   Ú<module>   s   