Ë
    ¦ÙbiÏ  ã                   ó€   — U d Z ddlZddlmZ ddlmZ exs daee	d<   dd	„Z
dd
„Zdefd„Z G d„ de«      ZeZe
Zd„ Zy)aº  Utility helpers to handle progress bars in `datasets`.

Example:
    1. Use `datasets.utils.tqdm` as you would use `tqdm.tqdm` or `tqdm.auto.tqdm`.
    2. To disable progress bars, either use `disable_progress_bars()` helper or set the
       environment variable `HF_DATASETS_DISABLE_PROGRESS_BARS` to 1.
    3. To re-enable progress bars, use `enable_progress_bars()`.
    4. To check whether progress bars are disabled, use `are_progress_bars_disabled()`.

NOTE: Environment variable `HF_DATASETS_DISABLE_PROGRESS_BARS` has the priority.

Example:
    ```py
    from datasets.utils import (
        are_progress_bars_disabled,
        disable_progress_bars,
        enable_progress_bars,
        tqdm,
    )

    # Disable progress bars globally
    disable_progress_bars()

    # Use as normal `tqdm`
    for _ in tqdm(range(5)):
       do_something()

    # Still not showing progress bars, as `disable=False` is overwritten to `True`.
    for _ in tqdm(range(5), disable=False):
       do_something()

    are_progress_bars_disabled() # True

    # Re-enable progress bars globally
    enable_progress_bars()

    # Progress bar will be shown !
    for _ in tqdm(range(5)):
       do_something()
    ```
é    N)Útqdmé   )Ú!HF_DATASETS_DISABLE_PROGRESS_BARSFÚ#_hf_datasets_progress_bars_disabledÚreturnc                  óD   — t         du rt        j                  d«       yday)zË
    Disable globally progress bars used in `datasets` except if `HF_DATASETS_DISABLE_PROGRESS_BAR` environment
    variable has been set.

    Use [`~utils.enable_progress_bars`] to re-enable them.
    FzpCannot disable progress bars: environment variable `HF_DATASETS_DISABLE_PROGRESS_BAR=0` is set and has priority.NT©r   ÚwarningsÚwarnr   © ó    úN/home/cdr/jupyterlab/.venv/lib/python3.12/site-packages/datasets/utils/tqdm.pyÚdisable_progress_barsr   <   s(   € ô )¨EÑ1Ü‰ðô	
ð 	à*.Ñ'r   c                  óD   — t         du rt        j                  d«       yday)zÉ
    Enable globally progress bars used in `datasets` except if `HF_DATASETS_DISABLE_PROGRESS_BAR` environment
    variable has been set.

    Use [`~utils.disable_progress_bars`] to disable them.
    TzoCannot enable progress bars: environment variable `HF_DATASETS_DISABLE_PROGRESS_BAR=1` is set and has priority.NFr	   r   r   r   Úenable_progress_barsr   M   s(   € ô )¨DÑ0Ü‰ðô	
ð 	à*/Ñ'r   c                  ó   — t         S )a!  Return whether progress bars are globally disabled or not.

    Progress bars used in `datasets` can be enable or disabled globally using [`~utils.enable_progress_bars`]
    and [`~utils.disable_progress_bars`] or by setting `HF_DATASETS_DISABLE_PROGRESS_BAR` as environment variable.
    )r   r   r   r   Úare_progress_bars_disabledr   ^   s
   € ô /Ð.r   c                   ó6   ‡ — e Zd ZdZˆ fd„Zdeddfˆ fd„Zˆ xZS )r   z«
    Class to override `disable` argument in case progress bars are globally disabled.

    Taken from https://github.com/tqdm/tqdm/issues/619#issuecomment-619639324.
    c                 óB   •— t        «       rd|d<   t        ‰|   |i |¤Ž y )NTÚdisable)r   ÚsuperÚ__init__)ÚselfÚargsÚkwargsÚ	__class__s      €r   r   ztqdm.__init__o   s%   ø€ Ü%Ô'Ø $ˆF9ÑÜ‰Ñ˜$Ð) &Ó)r   Úattrr   Nc                 óP   •— 	 t         ‰|   |«       y# t        $ r	 |dk7  r‚ Y yw xY w)z;Fix for https://github.com/huggingface/datasets/issues/6066Ú_lockN)r   Ú__delattr__ÚAttributeError)r   r   r   s     €r   r    ztqdm.__delattr__t   s3   ø€ ð	Ü‰GÑ Õ%øÜò 	ØwŠØñ ð	ús   ƒ “%¤%)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r   Ústrr    Ú__classcell__)r   s   @r   r   r   h   s%   ø„ ñô*ð
 ð ¨÷ ñ r   r   c                  ó   — t        «        S )N)r   r   r   r   Úis_progress_bar_enabledr)   ‚   s   € Ü)Ó+Ð+Ð+r   )r   N)r%   r
   Ú	tqdm.autor   Úold_tqdmÚconfigr   r   ÚboolÚ__annotations__r   r   r   Úenable_progress_barÚdisable_progress_barr)   r   r   r   ú<module>r1      s_   ðò(óT å &å 6ð -NÒ,VÐQVÐ # TÓ Vó/ó"0ð"/ Dó /ôˆ8ô ð, +Ð Ø,Ð ó,r   