+ QV-j&4aR#t 0tRt^RIt^RIt^RIt^RIt^RIt^RIHt^RI H t H t ^RI H t ^RIHt^RIHt^RIHt/t]^k!RR 4tR$R R lltR$R R lltRRlt!RR]4t]P5]P6!44!RR4t] RRl4tRR/RRlltRRR^RRRRRRRRR R/R!R"lltR#)%u 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)Iterator)contextmanager nullcontext)Path)ContextManager)tqdm)HF_HUB_DISABLE_PROGRESS_BARSc^a]tRt^ltoRtR V3RlRlltV3RlRltV3RlRltR tVt R#) disable_progress_barsa 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. Nc2<V^8dQhRS[R,RR/#nameNreturnstr)format __classdict__s"k/Volumes/fast/ai/experiments/ui-tars-smoke/.venv/lib/python3.14/site-packages/huggingface_hub/utils/tqdm.py __annotate__"disable_progress_bars.__annotate__s..S4Z.4.cpWn\RJd \P!R4RVnR#\ V4'*VnVf \ P4R\ R&R#\ Uu.uF q"PV R24'gKVNK" ppVF p\ VK R\ V&R#uupi)FzlCannot disable progress bars: environment variable `HF_HUB_DISABLE_PROGRESS_BARS=0` is set and has priority.N_global.) rrwarningswarn_should_reenableare_progress_bars_disabledprogress_bar_statesclear startswith)selfrkeykeys_to_removes&& r__init__disable_progress_bars.__init__s '5 0 MM~ %*D ! $>t$D D <  % % '-2  *-@_-@cNNVZU[[\S]D^cc-@N_%',&(-  %`s 0B3B3c<V^8dQhRR/#)r rr )rrs"rrrs2rcV#Nr(r"s&r __enter__disable_progress_bars.__enter__ rc<V^8dQhRR/#)r rNr()rrs"rrrs,,,rcXVP'd\VP4R#R#r*)renable_progress_barsr)r"excs&*r__exit__disable_progress_bars.__exit__s   + !r)rrr*) __name__ __module__ __qualname____firstlineno____doc__r%r,r3__static_attributes____classdictcell__rs@rr r ls(*..(,,rr c6V^8dQhR\R,RR/#r r)rs"rrrs))sTz)T)rc,\RJd\P!R4R#Vf \P 4R\R&R#\Uu.uF qP V R24'gKVNK" ppVF p\VK R\V&R#uupi)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)rrrrr r!)rr#r$s& rr1r1s $t+ y   |!!#)-I&)<[)<#RVQWWXz@Z##)<[!C#C("$(D!\s B.Bc>V^8dQhR\R,R\/#r )rbool)rs"rrrs88S4Z848rc"\RJdR#Vf\PRR4'*#V'dCV\9d\V,'*#RPVP R4RR4pKJ\PRR4'*#)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)rrgetjoinsplit)rs&rrrsw$t+ |&**9d;;;  & &*400 0xx 3,-"&&y$7 77rc>V^8dQhR\R\R,/#)r log_levelrN)intr@)rs"rrrs   t rcnV\P8XdR#\P!R4R8XdR#R#)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)rGs&ris_tqdm_disabledrOs* GNN" yy!T) rcNaa]tRt^toRtV3RltV3RlV3RlltRtVtV;t #)rz Class to override `disable` argument in case progress bars are globally disabled. Taken from https://github.com/tqdm/tqdm/issues/619#issuecomment-619639324. cx<VPRR4p\V4'dRVR&\SV` !V/VBR#)rNTdisable)poprsuperr%)r"argskwargsr __class__s&*, rr% tqdm.__init__s:zz&$' %d + + $F9  $)&)rc$<V^8dQhRS[RR/#)r attrrNr)rrs"rrtqdm.__annotate__src \<\SV`V4R# \d TR8wdhR#i;i)zBFix for https://github.com/huggingface/huggingface_hub/issues/1603_lockN)rT __delattr__AttributeError)r"rZrWs&&rr^tqdm.__delattr__s3  G  % w s ++r() r5r6r7r8r9r%r^r:r; __classcell__)rWrs@@rrrs * rrcLa]tRtRtoRtRtRtRtR V3RlRlltRt Vt R #) silent_tqdmiz#Fake tqdm object that does nothing.cR#r*r()r"rUrVs&*,rr%silent_tqdm.__init__ rcV#r*r(r+s&rr,silent_tqdm.__enter__ r.rcR#r*r()r"exc_type exc_value tracebacks&&&&rr3silent_tqdm.__exit__rfrcB<V^8dQhRS[S[,R,RR/#)r nNr)rHfloat)rrs"rrsilent_tqdm.__annotate__s$  e d* 4 rcR#r*r()r"ros&&rupdatesilent_tqdm.updaterfrr(N)) r5r6r7r8r9r%r,r3rsr:r;r<s@rrcrcs&-     rrccpV^8dQhR\\,R\\P,/#)r pathr)rrrioBufferedReader)rs"rrrs)**4#:*(23D3D*E*rc #aa"\V\4'd \V4pVPR4;_uu_4pVP 4P p\ RRV^VPR7oVPoRRVV3RlllpW1nVxSP4RRR4R# +'giR#;i5i) 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] ``` rbBT)unit unit_scaletotalinitialdescc>V^8dQhR\R,R\/#)r sizeNr)rHbytes)rs"rr&tqdm_stream_file..__annotate__7s  cDj % rcL<S!V4pSP\V44V#r*)rslen)rdataf_readpbars& r _inner_read%tqdm_stream_file.._inner_read7s!$rsBH  $2!&4(*)/,/,d)@8: 84 ioo    **Z5TX5,     )-"r