5pjYA%SrSSKrSSKrSSKrSSKrSSKrSSKJrJr SSK J r J r SSK J r Jr SSKJr SSKJrJrJrJr SSKJr S S KJr 0r\\\4\S '"S S 5r S1S\S-SS4Sjjr!S1S\S-S\4Sjjr"S\#S\S-4Sjr$"SS\5r\RK\RL"55 "SS5r'\ S\\-S\\RP4Sj5r)SS.S\*\S\#S\S-S\4Sjjr+SSSSSSSS.S \S\#S!\#S-S"\#S#\S$\S\S-S%\*\S-S&\S-S\\4S'jjr,\"S(5r-\"S)5r.S*\#S-S+\*\S\ 4S,jr/SSS-.S.\\-/\.4S/\\-S*\#S-S%\*\S-S\0\.4 S0jjr1g)2u Utility helpers to handle progress bars in `huggingface_hub`. Example: 1. Use `huggingface_hub.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_HUB_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_HUB_DISABLE_PROGRESS_BARS` has the priority. Example: ```py >>> from huggingface_hub.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)): ... pass # Still not showing progress bars, as `disable=False` is overwritten to `True`. >>> for _ in tqdm(range(5), disable=False): ... pass >>> are_progress_bars_disabled() True # Re-enable progress bars globally >>> enable_progress_bars() # Progress bar will be shown ! >>> for _ in tqdm(range(5)): ... pass 100%|███████████████████████████████████████| 5/5 [00:00<00:00, 117817.53it/s] ``` Group-based control: ```python # Disable progress bars for a specific group >>> disable_progress_bars("peft.foo") # Check state of different groups >>> assert not are_progress_bars_disabled("peft")) >>> assert not are_progress_bars_disabled("peft.something") >>> assert are_progress_bars_disabled("peft.foo")) >>> assert are_progress_bars_disabled("peft.foo.bar")) # Enable progress bars for a subgroup >>> enable_progress_bars("peft.foo.bar") # Check if enabling a subgroup affects the parent group >>> assert are_progress_bars_disabled("peft.foo")) >>> assert not are_progress_bars_disabled("peft.foo.bar")) # No progress bar for `name="peft.foo"` >>> for _ in tqdm(range(5), name="peft.foo"): ... pass # Progress bar will be shown for `name="peft.foo.bar"` >>> for _ in tqdm(range(5), name="peft.foo.bar"): ... pass 100%|███████████████████████████████████████| 5/5 [00:00<00:00, 117817.53it/s] ``` N)IterableIterator)ThreadPoolExecutor as_completed)contextmanager nullcontext)Path)CallableContextManagerTypeVarcast)tqdm)HF_HUB_DISABLE_PROGRESS_BARSprogress_bar_statescH\rSrSrSrS S\S-SS4SjjrS SjrS SjrS r g) disable_progress_barsma Disable progress bars either globally or for a specified group. This function updates the state of progress bars based on a group name. If no group name is provided, all progress bars are disabled. The operation respects the `HF_HUB_DISABLE_PROGRESS_BARS` environment variable's setting. Works as both a regular call and a context manager: disable_progress_bars() # disables until enable_progress_bars() with disable_progress_bars(): # disables for the block, re-enables on exit ... Args: name (`str`, *optional*): The name of the group for which to disable the progress bars. If None, progress bars are disabled globally. Raises: Warning: If the environment variable precludes changes. NnamereturncfXl[SLa[R"S5 SUlg[ U5(+UlUc[ R5 S[ S'g[ Vs/sHo"RUS35(dMUPM! nnUH n[ U M S[ U'gs snf)NFzlCannot disable progress bars: environment variable `HF_HUB_DISABLE_PROGRESS_BARS=0` is set and has priority._global.) rrwarningswarn_should_reenableare_progress_bars_disabledrclear startswith)selfrkeykeys_to_removes V/var/www/html/pdf-tiff/venv/lib/python3.13/site-packages/huggingface_hub/utils/tqdm.py__init__disable_progress_bars.__init__s '5 0 MM~ %*D ! $>t$D D <  % % '-2  *-@_-@cNNVZU[[\S]D^c-@N_%',&(-  %`s ,B. B.cU$Nr s r# __enter__disable_progress_bars.__enter__ cRUR(a[UR5 ggr')renable_progress_barsr)r excs r#__exit__disable_progress_bars.__exit__s   + !r-)rrr')rr)rN) __name__ __module__ __qualname____firstlineno____doc__strr$r*r1__static_attributes__r(r-r#rrms(*.S4Z.4.(,r-rrrc"[SLa[R"S5 gUc[R 5 S[S'g[Vs/sHoR US35(dMUPM! nnUH n[U M S[U'gs snf)a Enable progress bars either globally or for a specified group. This function sets the progress bars to enabled for the specified group or globally if no group is specified. The operation is subject to the `HF_HUB_DISABLE_PROGRESS_BARS` environment setting. Args: name (`str`, *optional*): The name of the group for which to enable the progress bars. If None, progress bars are enabled globally. Raises: Warning: If the environment variable precludes changes. TzkCannot enable progress bars: environment variable `HF_HUB_DISABLE_PROGRESS_BARS=1` is set and has priority.Nrr)rrrrrr)rr!r"s r#r/r/s $t+ y   |!!#)-I&)<[)<#RVQWWXz@Z#)<[!C#C("$(D!\s B *B c[SLagUc[RSS5(+$U(aDU[;a[U(+$SRUR S5SS5nU(aMD[RSS5(+$)a Check if progress bars are disabled globally or for a specific group. This function returns whether progress bars are disabled for a given group or globally. It checks the `HF_HUB_DISABLE_PROGRESS_BARS` environment variable first, then the programmatic settings. Args: name (`str`, *optional*): The group name to check; if None, checks the global setting. Returns: `bool`: True if progress bars are disabled, False otherwise. TNrr)rrgetjoinsplitrs r#rrs$t+ |&**9d;;;  & &*400 0xx 3,- $ #&&y$7 77r- log_levelcdU[R:Xag[R"S5S:Xagg)z Determine if tqdm progress bars should be disabled based on logging level and environment settings. see https://github.com/huggingface/huggingface_hub/pull/2000 and https://github.com/huggingface/huggingface_hub/pull/2698. T TQDM_POSITIONz-1FN)loggingNOTSETosgetenv)rAs r#is_tqdm_disabledrHs* GNN" yy!T) r-cD^\rSrSrSrU4SjrS\SS4U4SjjrSrU=r $) rz Class to override `disable` argument in case progress bars are globally disabled. Taken from https://github.com/tqdm/tqdm/issues/619#issuecomment-619639324. ct>URSS5n[U5(aSUS'[TU] "U0UD6 g)NrTdisable)poprsuperr$)r argskwargsr __class__s r#r$ tqdm.__init__s:zz&$' %d + + $F9  $)&)r-attrrNcT>[TU]U5 g![a US:waegf=f)zBFix for https://github.com/huggingface/huggingface_hub/issues/1603_lockN)rN __delattr__AttributeError)r rSrQs r#rVtqdm.__delattr__s3  G  % w s ''r() r3r4r5r6r7r$r8rVr9 __classcell__)rQs@r#rrs% * r-rcL\rSrSrSrSrSrSrS S\\ -S-SS4S jjr S r g) silent_tqdmiz#Fake tqdm object that does nothing.cgr'r()r rOrPs r#r$silent_tqdm.__init__  r-cU$r'r(r)s r#r*silent_tqdm.__enter__ r,r-cgr'r()r exc_type exc_value tracebacks r#r1silent_tqdm.__exit__r^r-nNrcgr'r()r rfs r#updatesilent_tqdm.updater^r-r()) r3r4r5r6r7r$r*r1intfloatrhr9r(r-r#r[r[s5-   e d* 4  r-r[pathc #^^# [U[5(a [U5nURS5nUR 5R n[ SSUSURS9mURmS S[S-S[4UU4S jjjnX1lUv TR5 SSS5 g!,(df  g=f7f) u Open a file as binary and wrap the `read` method to display a progress bar when it's streamed. First implemented in `transformers` in 2019 but removed when switched to git-lfs. Used in `huggingface_hub` to show progress bar when uploading an LFS file to the Hub. See github.com/huggingface/transformers/pull/2078#discussion_r354739608 for implementation details. Note: currently implementation handles only files stored on disk as it is the most common use case. Could be extended to stream any `BinaryIO` object but we might have to debug some corner cases. Example: ```py >>> with tqdm_stream_file("config.json") as f: >>> httpx.put(url, data=f) config.json: 100%|█████████████████████████| 8.19k/8.19k [00:02<00:00, 3.72kB/s] ``` rbBTr)unit unit_scaletotalinitialdescsizeNrcL>T"U5nTR[U55 U$r')rhlen)rvdataf_readpbars r# _inner_read%tqdm_stream_file.._inner_read8s!$rsSBH  .?2::&4(*T#t)_)/,/,d)sTz)T)@8S4Z848:  t 84 ioo    *4#:*(23D3D*E**ZUY5h5C5sTz5go54(,!  :      *X%d{D< CL CL 7sTz 7d8n 7Yk 7(#(, 5$!a5$qk5$t 5$ X% 5$ !W5$r-