o {j6hu@svdZddlZddlmZmZddlmZddlmZmZm Z ddl m Z ddl m Z ddl mZdd lmZd d lmZd d lmZmZmZmZmZmZmZmZmZmZmZmZd Z gdZ!Gddde"Z#Gddde$Z%Gddde&Z'Gddde'e(Z)Gddde'e*Z+Gddde'e,Z-ddZ.Gddde/Z0Gdd d e/Z1Gd!d"d"e/Z2Gd#d$d$eZ3d%d&Z4dS)'z Customisable progressbar decorator for iterators. Includes a default `range` iterator printing to `stderr`. Usage: >>> from tqdm import trange, tqdm >>> for i in trange(10): ... ... N) OrderedDict defaultdict)contextmanager)datetime timedeltatimezone)Number)time)warn)WeakSet)TMonitor) CallbackIOWrapper ComparableDisableOnWriteError FormatReplaceSimpleTextIOWrapper _is_ascii_screen_shape_wrapper_supports_unicode _term_move_updisp_len disp_trimenvwrapz*https://github.com/tqdm/tqdm#contributions)tqdmtrange TqdmTypeError TqdmKeyError TqdmWarningTqdmExperimentalWarningTqdmDeprecationWarningTqdmMonitorWarningc@ eZdZdS)rN__name__ __module__ __qualname__r'r'W/var/www/html/chefvision.cloud.itp360.com/venv/lib/python3.10/site-packages/tqdm/std.pyr rc@r")rNr#r'r'r'r(r$r)rcs"eZdZdZdfdd ZZS)rzqbase class for all tqdm warnings. Used for non-external-code-breaking errors, such as garbled printing. NcsN|dur|d|jjdt|ddStj|g|Ri|dS)N : ) __class__r$strrstripsuper__init__)selfmsgfp_writeakr,r'r(r0-s(zTqdmWarning.__init__N)r$r%r&__doc__r0 __classcell__r'r'r6r(r(src@eZdZdZdS)rz(beta feature, unstable API and behaviourNr$r%r&r8r'r'r'r(r4rc@r")r Nr#r'r'r'r(r 9sr c@r:)r!z>tqdm monitor errors which do not affect external functionalityNr;r'r'r'r(r!>r<r!c Os6zddlm}||i|WSttfyYdSw)zthreading RLockrRLockN) threadingr> ImportErrorOSError)argskwargsr>r'r'r(TRLockCs  rDc@sVeZdZdZeZddZddZddZdd Z d d Z e d d Z e ddZ dS)TqdmDefaultWriteLocka Provide a default write lock for thread and multiprocessing safety. Works only on platforms supporting `fork` (so Windows is excluded). You must initialise a `tqdm` or `TqdmDefaultWriteLock` instance before forking in order for the write lock to work. On Windows, you need to supply the lock from the parent to the children as an argument to joblib or the parallelism lib you use. cCsVt|}|j}|dur||dd|j|jfD|_|dur)|dSdS)NcSsg|]}|dur|qSr7r').0lkr'r'r( bsz1TqdmDefaultWriteLock.__init__..)typeth_lockacquirecreate_mp_lockmp_locklocksrelease)r1cls root_lockr'r'r(r0Zs zTqdmDefaultWriteLock.__init__cOs |jD] }|j|i|qdSr7)rNrK)r1r4r5lockr'r'r(rKfs zTqdmDefaultWriteLock.acquirecCs"|jdddD]}|qdS)N)rNrO)r1rRr'r'r(rOjs zTqdmDefaultWriteLock.releasecC |dSr7)rKr1r'r'r( __enter__n zTqdmDefaultWriteLock.__enter__cGrTr7)rO)r1excr'r'r(__exit__qrWzTqdmDefaultWriteLock.__exit__c CsHt|ds"z ddlm}||_WdSttfy!d|_YdSwdS)NrMrr=)hasattrmultiprocessingr>rMr@rA)rPr>r'r'r(rLts   z#TqdmDefaultWriteLock.create_mp_lockcCs t|dsJtdtdddS)NrJz!create_th_lock not needed anymore stacklevel)rZr r rPr'r'r(create_th_lock}sz#TqdmDefaultWriteLock.create_th_lockN)r$r%r&r8rDrJr0rKrOrVrY classmethodrLr`r'r'r'r(rELs   rEc @seZdZdZdZddeeedddZ dZ d Z d Z d d d ddddddZ de dfddZeddZejddZddZdS)Bara `str.format`-able bar with format specifiers: `[width][type]` - `width` + unspecified (default): use `self.default_len` + `int >= 0`: overrides `self.default_len` + `int < 0`: subtract from `self.default_len` - `type` + `a`: ascii (`charset=self.ASCII` override) + `u`: unicode (`charset=self.UTF` override) + `b`: blank (`charset=" "` override) z 123456789# i%i%rSz zz[38;2;%d;%d;%dmzzzzzzzz)BLACKREDGREENYELLOWBLUEMAGENTACYANWHITE NcCs\d|kr dksntdtddtdtd|}|dks J||_||_||_||_dS)Nrr zclamping frac to range [0, 1]r\r])r rmaxminfrac default_lencharsetcolour)r1rprqrrrsr'r'r(r0s  z Bar.__init__cC|jSr7)_colourrUr'r'r(rssz Bar.colourc Cs|sd|_dSz?||jvr|j||_WdS|ddkrEt|dkrE|jtdd|dd|dd|ddfD|_WdStttfydtd |d |jft d d d|_YdSw) Nr#css|]}t|dVqdS)N)int)rFir'r'r( s  zBar.colour..r z7Unknown colour (%s); valid choices: [hex (#00ff00), %s], r\r]) ruupperCOLOURSlen COLOUR_RGBtupleKeyErrorAttributeErrorr joinr)r1valuer'r'r(rss&    c Cs|r<|d}z |j|j|jd|}Wn ty!|j}Ynw|dd}|r8t|}|dkr7||j7}n |j}n|j}|j}t|d}t t|j |||\}}|d|}||krp||||d||d}|j r{|j ||j S|S)NrS)r4ubrr ) lowerASCIIUTFBLANKrrrryrqrdivmodrprs COLOUR_RESET) r1 format_spec_typerrN_BARSnsyms bar_lengthfrac_bar_lengthresr'r'r( __format__s,        zBar.__format__)r$r%r&r8rrmapchrrangerrrrrr0propertyrssetterrr'r'r'r(rbs"    rbc@s$eZdZdZdddZd ddZdS) EMAa[ Exponential moving average: smoothing to give progressively lower weights to older values. Parameters ---------- smoothing : float, optional Smoothing factor in range [0, 1], [default: 0.3]. Increase to give more weight to recent values. Ranges from 0 (yields old value) to 1 (yields new value). 333333?cCs||_d|_d|_dS)Nralphalastcalls)r1 smoothingr'r'r(r0s z EMA.__init__NcCsVd|j}|dur|j|||j|_|jd7_|jr(|jd||jS|jS)zk Parameters ---------- x : float New value to include in EMA. r Nr)r1xbetar'r'r(__call__s  z EMA.__call__)rr7)r$r%r&r8r0rr'r'r'r(rs rc @seZdZdZdZdZeZedaddZ edd Z ed d Z ed d Z e   dbddZ ddZedcddZeddZeddddZeededdZeddZed d!Zed"d#Zed$d%eeeeed&d'      dfd,d-Zd.d/Zd0d1Zd2d3Zd4d5Zd6d7Z d8d9Z!d:d;Z"dd?Z%d@dAZ&dBdCZ'dgdEdFZ(dGdHZ)dhdIdJZ*didKdLZ+dMdNZ,dcdOdPZ-djdQdRZ.djdSdTZ/djdUdVZ0dkdWdXZ1dYdZZ2e$d[d\Z3dld]d^Z4eedjd_d`Z5dS)mrad Decorate an iterable object, returning an iterator which acts exactly like the original iterable, but prints a dynamically updating progressbar every time a value is requested. Parameters ---------- iterable : iterable, optional Iterable to decorate with a progressbar. Leave blank to manually manage the updates. desc : str, optional Prefix for the progressbar. total : int or float, optional The number of expected iterations. If unspecified, len(iterable) is used if possible. If float("inf") or as a last resort, only basic progress statistics are displayed (no ETA, no progressbar). If `gui` is True and this parameter needs subsequent updating, specify an initial arbitrary large positive number, e.g. 9e9. leave : bool, optional If [default: True], keeps all traces of the progressbar upon termination of iteration. If `None`, will leave only if `position` is `0`. file : `io.TextIOWrapper` or `io.StringIO`, optional Specifies where to output the progress messages (default: sys.stderr). Uses `file.write(str)` and `file.flush()` methods. For encoding, see `write_bytes`. ncols : int, optional The width of the entire output message. If specified, dynamically resizes the progressbar to stay within this bound. If unspecified, attempts to use environment width. The fallback is a meter width of 10 and no limit for the counter and statistics. If 0, will not print any meter (only stats). mininterval : float, optional Minimum progress display update interval [default: 0.1] seconds. maxinterval : float, optional Maximum progress display update interval [default: 10] seconds. Automatically adjusts `miniters` to correspond to `mininterval` after long display update lag. Only works if `dynamic_miniters` or monitor thread is enabled. miniters : int or float, optional Minimum progress display update interval, in iterations. If 0 and `dynamic_miniters`, will automatically adjust to equal `mininterval` (more CPU efficient, good for tight loops). If > 0, will skip display of specified number of iterations. Tweak this and `mininterval` to get very efficient loops. If your progress is erratic with both fast and slow iterations (network, skipping items, etc) you should set miniters=1. ascii : bool or str, optional If unspecified or False, use unicode (smooth blocks) to fill the meter. The fallback is to use ASCII characters " 123456789#". disable : bool, optional Whether to disable the entire progressbar wrapper [default: False]. If set to None, disable on non-TTY. unit : str, optional String that will be used to define the unit of each iteration [default: it]. unit_scale : bool or int or float, optional If 1 or True, the number of iterations will be reduced/scaled automatically and a metric prefix following the International System of Units standard will be added (kilo, mega, etc.) [default: False]. If any other non-zero number, will scale `total` and `n`. dynamic_ncols : bool, optional If set, constantly alters `ncols` and `nrows` to the environment (allowing for window resizes) [default: False]. smoothing : float, optional Exponential moving average smoothing factor for speed estimates (ignored in GUI mode). Ranges from 0 (average speed) to 1 (current/instantaneous speed) [default: 0.3]. bar_format : str, optional Specify a custom bar string formatting. May impact performance. [default: '{l_bar}{bar}{r_bar}'], where l_bar='{desc}: {percentage:3.0f}%|' and r_bar='| {n_fmt}/{total_fmt} [{elapsed}<{remaining}, ' '{rate_fmt}{postfix}]' Possible vars: l_bar, bar, r_bar, n, n_fmt, total, total_fmt, percentage, elapsed, elapsed_s, ncols, nrows, desc, unit, rate, rate_fmt, rate_noinv, rate_noinv_fmt, rate_inv, rate_inv_fmt, postfix, unit_divisor, remaining, remaining_s, eta. Note that a trailing ": " is automatically removed after {desc} if the latter is empty. initial : int or float, optional The initial counter value. Useful when restarting a progress bar [default: 0]. If using float, consider specifying `{n:.3f}` or similar in `bar_format`, or specifying `unit_scale`. position : int, optional Specify the line offset to print this bar (starting from 0) Automatic if unspecified. Useful to manage multiple bars at once (eg, from threads). postfix : dict or *, optional Specify additional stats to display at the end of the bar. Calls `set_postfix(**postfix)` if possible (dict). unit_divisor : float, optional [default: 1000], ignored unless `unit_scale` is True. write_bytes : bool, optional Whether to write bytes. If (default: False) will write unicode. lock_args : tuple, optional Passed to `refresh` for intermediate output (initialisation, iterating, and updating). nrows : int, optional The screen height. If specified, hides nested bars outside this bound. If unspecified, attempts to use environment height. The fallback is 20. colour : str, optional Bar colour (e.g. 'green', '#00ff00'). delay : float, optional Don't display until [default: 0] seconds have elapsed. gui : bool, optional WARNING: internal parameter - do not use. Use tqdm.gui.tqdm(...) instead. If set, will attempt to use matplotlib animations for a graphical output [default: False]. Returns ------- out : decorated iterator. rmNrdcCsdD]9}t|dkr7t|dkr,t|dkr!|d||S|d||S|d||S||}q|dd |S) a Formats a number (greater than unity) with SI Order of Magnitude prefixes. Parameters ---------- num : float Number ( >= 1) to format. suffix : str, optional Post-postfix [default: '']. divisor : float, optional Divisor between prefixes [default: 1000]. Returns ------- out : str Number with Order of Magnitude SI unit postfix. )rdr5MGTPEZg<@gX@g= ףp#@z1.2fz2.1f3.0fz3.1fY)abs)numsuffixdivisorunitr'r'r( format_sizeofrs    ztqdm.format_sizeofcCsPtt|d\}}t|d\}}|r|dd|dd|dS|dd|dS)z Formats a number of seconds as a clock time, [H:]MM:SS Parameters ---------- t : int Number of seconds. Returns ------- out : str [H:]MM:SS <d:02d)rry)tminsshmr'r'r(format_intervals0ztqdm.format_intervalcCs8|ddddd}t|}t|t|kr|S|S)z Intelligent scientific notation (.3g). Parameters ---------- n : int or float or Numeric A Number. Returns ------- out : str Formatted number. z.3gze+0ze+ze-0ze-)replacer-r)nfr'r'r( format_numsztqdm.format_numcsr|tdddtjtjfvr&ttjdddttjdddfdddgfd d }|S) z Manage the printing and in-place updating of a line of characters. Note that if the string is longer than a line, then in-place updating may not work (it will print a new line at each refresh). flushcSdSr7r'r'r'r'r(z%tqdm.status_printer..cSrr7r'r'r'r'r(rrcSrr7r'r'r'r'r(rrcst|dSr7)writer-r)fpfp_flushr'r(r3s z%tqdm.status_printer..fp_writercs6t|}d|dtd|d|d<dS)N rcr)rrn)rlen_s)r3last_lenr'r( print_statuss" z)tqdm.status_printer..print_status)getattrsysstderrstdout)filerr')rrr3rr(status_printersztqdm.status_printerFitrc# Ks|r ||dkr d}|r"|dvr"|r||9}||9}|r ||9}d}t|}|dur3|r3|| |}|r9d|nd}tj}|rJ|rF||n|dnd|d}|r\|rX||n|dndd |}|rj|dkrj|n|}|r||| d }|dur~||| d nd}nt|}|durt|nd}z | rd | nd } Wn tyYnw|r|r|||nd }|rt|nd}z|r|rtt|dntd t j }Wn t ytj }Ynw|r|dddk}|r|n|d}nd }d|d|d|d|d || d }id|d|d|d|d|d|d|d|pd d|d|r.|dkr.|n|d |d!|d"|d#|d$|d%| d&| | |||||d'|}|r||}|d(}||d)d*7}|d kru|dd+|ddS|j |d,| r|j |d-|s| d.d } nd/} t} | jd6d0| i|}!| js|!St||rt d|t|!nd1|d2urtjn|ptj| d3} t| jst| rt| } | jd6d0| i|}"|rt|"|S|"S| r0|d47}|j |d d5t} | jd6d0| i|}!| js|!Std |rt d|t|!nd1tj| d3} | jd6d0| i|}"|r.t|"|S|"S|r7|dnd ||d|d || d S)7a Return a string-based progress bar given some parameters Parameters ---------- n : int or float Number of finished iterations. total : int or float The expected total number of iterations. If meaningless (None), only basic progress statistics are displayed (no ETA). elapsed : float Number of seconds passed since start. ncols : int, optional The width of the entire output message. If specified, dynamically resizes `{bar}` to stay within this bound [default: None]. If `0`, will not print any bar (only stats). The fallback is `{bar:10}`. prefix : str, optional Prefix message (included in total width) [default: '']. Use as {desc} in bar_format string. ascii : bool, optional or str, optional If not set, use unicode (smooth blocks) to fill the meter [default: False]. The fallback is to use ASCII characters " 123456789#". unit : str, optional The iteration unit [default: 'it']. unit_scale : bool or int or float, optional If 1 or True, the number of iterations will be printed with an appropriate SI metric prefix (k = 10^3, M = 10^6, etc.) [default: False]. If any other non-zero number, will scale `total` and `n`. rate : float, optional Manual override for iteration rate. If [default: None], uses n/elapsed. bar_format : str, optional Specify a custom bar string formatting. May impact performance. [default: '{l_bar}{bar}{r_bar}'], where l_bar='{desc}: {percentage:3.0f}%|' and r_bar='| {n_fmt}/{total_fmt} [{elapsed}<{remaining}, ' '{rate_fmt}{postfix}]' Possible vars: l_bar, bar, r_bar, n, n_fmt, total, total_fmt, percentage, elapsed, elapsed_s, ncols, nrows, desc, unit, rate, rate_fmt, rate_noinv, rate_noinv_fmt, rate_inv, rate_inv_fmt, postfix, unit_divisor, remaining, remaining_s, eta. Note that a trailing ": " is automatically removed after {desc} if the latter is empty. postfix : *, optional Similar to `prefix`, but placed at the end (e.g. for additional stats). Note: postfix is usually a string (not a dict) for this method, and will if possible be set to postfix = ', ' + postfix. However other types are supported (#382). unit_divisor : float, optional [default: 1000], ignored unless `unit_scale` is True. initial : int or float, optional The initial counter value [default: 0]. colour : str, optional Bar colour (e.g. 'green', '#00ff00'). Returns ------- out : Formatted meter and stats, ready to display. g?N)Tr Fr z5.2f?z/szs/)rr~rdr)secondsr+z| /z [<]rn_fmttotal total_fmtelapsed elapsed_sncolsdescrraterate_fmt rate_noinvrate_noinv_fmtrate_inv rate_inv_fmtpostfix unit_divisor)rs remaining remaining_sl_barr_baretadrz%|rS)r) percentagez{desc}: z{l_bar}{bar}{r_bar}barrmT)rrrs|)rrr')rrrr- TypeErrorrnowr fromtimestamprutc OverflowErrorrnupdaterrformat format_calledrbrrrrrrrr)#rrrrprefixasciir unit_scaler bar_formatrrinitialrs extra_kwargs elapsed_strinv_raterrrrrrr remaining_streta_dtbool_prefix_colon_alreadyrr format_dictrprfull_barnobarrr'r'r( format_meters"F         (        ztqdm.format_meterc Ost|}|^|j||jrG|jdus|jsOz t||j|_Wn0t yF}zt dt |t ddd|_WYd}~nd}~wwWd|SWd|SWd|SWd|S1sjwY|S)Nz>tqdm:disabling monitor support (monitor_interval = 0) due to: r\r]r) object__new__get_lock _instancesaddmonitor_intervalmonitorreportr Exceptionr r-r!)rP___instanceer'r'r(r s>            z tqdm.__new__cs2fdd|jD}tttt|d|S)zSkips specified instance.cs(h|]}|urt|drt|jqSpos)rZrr)rFinstrr'r( sz%tqdm._get_free_pos..r )rrosetrr difference)rPr positionsr'rr( _get_free_possztqdm._get_free_posc s|jWz|j|Wn tyYnw|jsJ|jpddttfdd|j}|rRt|ddd}|j ddt |j |_ Wd d SWd d SWd d S1s]wYd S) a5 Remove from list and reposition another unfixed bar to fill the new gap. This means that by default (where all nested bars are unfixed), order is not maintained but screen flicker/blank space is minimised. (tqdm<=4.44.1 moved ALL subsequent unfixed bars up.) r cst|do |jkS)Nr)rZrrzrr'r(rsz&tqdm._decr_instances..cSrtr7rr#r'r'r(rs)keyTnolockN) _lockrremoverguinrowslistfilterroclearrr)rPr instancesrr'r$r(_decr_instancess*    "ztqdm._decr_instancesr*cCsZ|dur|ntj}|j||d||||WddS1s&wYdS)z5Print a message via tqdm (without overlap with bars).N)rr')rrexternal_write_moder)rPrrendr'rr'r'r(rs   "z tqdm.writeccs|dur|ntj}zN|s|g}t|dgD]#}t|dr>|j|ks3tdd||jfDr>|jdd| |qdV|D]}|j ddqDW|sW|j dSdS|sa|j ww)z Disable tqdm within context and refresh tqdm when exits. Useful when writing to standard output stream Nrstart_tcss |] }|tjtjfvVqdSr7)rrr)rFrr'r'r(r{s z+tqdm.external_write_mode..Tr&) rrrrKrrZrallr.appendrefreshr(rO)rPrr'r inst_clearedrr'r'r(r1s,    ztqdm.external_write_modecCs ||_dS)zSet the global lock.N)r()rPrRr'r'r(set_locks z tqdm.set_lockcCst|ds t|_|jS)z7Get the global lock. Construct it if it does not exist.r()rZrEr(r_r'r'r(rs z tqdm.get_lockc  sddlm}m}ddlm}ddlmz!||dtdddlm }Wdn1s/wYWn t y@d}Ynwd \}}zdd l m Wn9t yzdd l m Wn't yzdd lm}dd l m}||fWn t ydYnwYnwYnwzdd lm}ddlm} Wn%t yz ddlm} m}Wnt yddlm} m}YnwYnwzddlm} Wnt yddlm} Ynwzddlm} Wnt yzddlm} Wn t yd} YnwYnwddgdfdd } | _| |_| d_| d|_| |_| | _| d|_| d|_| d| _|durA| |_| durJ| | _| | _| d| _| d| _|durl|durl| |_| |_dSdurw| _dSdS)ae Registers the current `tqdm` class with pandas.core. ( frame.DataFrame | series.Series | groupby.(generic.)DataFrameGroupBy | groupby.(generic.)SeriesGroupBy ).progress_apply A new instance will be created every time `progress_apply` is called, and each instance will automatically `close()` upon completion. Parameters ---------- tqdm_kwargs : arguments for the tqdm instance Examples -------- >>> import pandas as pd >>> import numpy as np >>> from tqdm import tqdm >>> from tqdm.gui import tqdm as tqdm_gui >>> >>> df = pd.DataFrame(np.random.randint(0, 100, (100000, 6))) >>> tqdm.pandas(ncols=50) # can use tqdm_gui, optional kwargs, etc >>> # Now you can use `progress_apply` instead of `apply` >>> df.groupby(0).progress_apply(lambda x: x**2) References ---------- r)catch_warnings simplefilter) DataFrame)Seriesignore)category)PanelNNN)_Rolling_and_Expanding) Expanding)Rolling) SeriesGroupBy)DataFrameGroupBy)rErD)GroupBy) PanelGroupBy deprecated_tapplycsfdd}|S)Ncsbdt|dd}|durDdkr|j}n.t|r t|}n$dus)t|sD|dd}|dkr6d}n|dkr.inner_generator..inner..wrapperr')poprsize isinstancergetshaper rrrrpandas.core.commonrPr@_is_builtin_funcrclose)dfrSrBrCrrLrPrT)r<rArPrH df_function tqdm_kwargsrRr(innerRsL            z3tqdm.pandas..inner_generator..innerr')r^r`r<rArPrHr_)r^r(inner_generatorQsGz$tqdm.pandas..inner_generatorrrK aggregate transform)rI)warningsr9r:pandas.core.framer;pandas.core.seriesr< FutureWarningpandasr?r@pandas.core.window.rollingrApandas.core.windowpandas.core.window.expandingrBrCpandas.core.groupby.genericrDrEpandas.core.groupby.groupbypandas.core.groupbyrFrGcopyrUprogress_apply progress_mapprogress_applymapprogress_aggregateprogress_transform) rPr_r9r:r;r?rCrBrDrErFrGrbr'rar(ris#                L            z tqdm.pandasTQDM_T)rrminiterspositionr+) is_methodtypes皙?$@rc Ks|durtj}|rt|t|ddpdd}t||d}| dur*t|dr*|s*d} |durF|durFzt|}Wn tt fyEd}Ynw|t dkrNd}| r||_ | |_ |j |||_|j|Wdn1spwY||_||_||_dS|rd|_ |j |||_|j|Wdn1swYd |vrtd t|d tjjd td t||dus|dur|tjtjfvs|r|rt}|r||\}}nt}|r||\}}|dur|}|dur|}| durd} d}nd}|durd}|dur d}| durt| } |r'| dur't| s't|}|dur.d}||_ |p5d|_||_||_||_||_||_ ||_!||_"| |_#||_$| |_%| |_ | |_&| |_'||_(||_)||_*||_+||_,||_-||_.t/||_0t/||_1t/||_2||_3d|_4||_5t6|_7|rz |j8dddi|Wn ty||_4Ynw||_9||_|j |dur||n| |_Wdn 1swY|s|:|j|_;|dkr|j<|j*d|7|_=|j=|_>dS)zsee tqdm.tqdm for argumentsNencodingzutf-8)r~) tqdm_instanceisattyTinfnestedzQ`nested` is deprecated and automated. Use `position` instead for manual control. rrOzUnknown argument(s): rFrdr6 lock_argsr')?rrrrrrZrrrrfloatiterabledisabler(r!rrr)rrleaver rrr-rrrrrrrr+ mininterval maxintervalrwdynamic_minitersrrrrrrdelayr* dynamic_ncolsrr_ema_dn_ema_dt _ema_minitersrrrsr _time set_postfix last_print_nrspr6 last_print_tr3) r1rrrrrrrrrwrrrrrrrrrxrr write_bytesrr+rsrr*rC_dynamic_ncols_ncols_nrowsrr'r'r(r0s                      z tqdm.__init__cCs0|jdur |jdkS|jdurtdt|jS)Nrz/bool() undefined when iterable == total == None)rrrboolrUr'r'r(__bool__Qs    z tqdm.__bool__cCs`|jdur|jSt|jdr|jjdSt|jdrt|jSt|jdr*|jSt|ddS)NrYr__len____length_hint__r)rrrZrYrrrrUr'r'r(rXs z tqdm.__len__cCsHzz|j}Wn tytdwt|j|_|W||_S||_w)Nz'tqdm' object is not reversible)rrrreversed__iter__)r1origr'r'r( __reversed__`s   ztqdm.__reversed__cCs*t|jdd}|dur||S||vS)N __contains__)rrr)r1itemcontainsr'r'r(rksztqdm.__contains__cCs|Sr7r'rUr'r'r(rVosztqdm.__enter__cCsBz|WdSty |||fdkrtdtddYdSw)N)NNNzAttributeError ignoredr\r])r\rr r)r1exc_type exc_value tracebackr'r'r(rYrs z tqdm.__exit__cCrTr7)r\rUr'r'r(__del__{rWz tqdm.__del__cCs|jdi|jS)Nr')r rrUr'r'r(__str__~sz tqdm.__str__cCstt|ddS)Nrl)rrrUr'r'r( _comparablesztqdm._comparablecCst|Sr7)idrUr'r'r(__hash__sz tqdm.__hash__c cs|j}|jr|D]}|Vq dS|j}|j}|j}|j|j}|j}|j}z9|D],}|V|d7}|||j krU|} | |} | |krU| |krU| |||j}|j}q)W||_| dS||_| w)z6Backward-compatibility to use: for x in tqdm(iterable)Nr ) rrrrrr3rrrrwrr\) r1robjrrr min_start_trr cur_tdtr'r'r(rs:   z tqdm.__iter__r cCs6|jrdS|dkr|j|7_|j|7_|j|j|jkr|}||j}||jkr||j|jkr|}|j|j}|j rQ|rQ|rQ| || ||j |j d|jr|jro||jkro||jpi|j||_n|j r|||jr|r|j|nd|_nt|j||_|j|_||_dSdSdSdS)ag Manually update the progress bar, useful for streams such as reading files. E.g.: >>> t = tqdm(total=filesize) # Initialise >>> for current_buffer in stream: ... ... ... t.update(len(current_buffer)) >>> t.close() The last line is highly recommended, but possibly not necessary if `t.update()` will be called in such a way that `filesize` will be exactly reached and printed. Parameters ---------- n : int or float, optional Increment to add to the internal counter of iterations [default: 1]. If using float, consider specifying `{n:.3f}` or similar in `bar_format`, or specifying `unit_scale`. Returns ------- out : bool or None True if a `display()` was triggered. Nrrr T)rrrrwrrrr3rrrrr6rrrrrn)r1rrrdnr'r'r(rs<    z tqdm.updatec sNjrdSd_tj}jjjkrdStdddur'dSfdd}z|dWntyM}zdt |vrHWYd}~dSd}~wwj durW|dknj }j @|rpd d _ j dd |d nj d|d r|s|dWddSWddSWddSWddS1swYdS)z3Cleanup and (if leave=False) close the progressbar.NTrcsjt|dSr7)rrr-rrUr'r(r3sztqdm.close..fp_writerdclosedrcSrr7r'r'r'r'r(rrztqdm.close..rr*)r2rr)rrrr0rr3rr ValueErrorr-rr(rdisplay)r1rr3rrr'rUr(r\sB         "z tqdm.closecCsr|jrdS|s |jt|j}||jpdkr.|||d|j d|| |s7|j dSdS)zClear current bar display.Nr"rdr) rr(rKrrr+movetorrrrO)r1r'rr'r'r(r.s      z tqdm.clearcCsH|jrdS|s|r|jj|sdSn|j||s"|jdS)a Force refresh the display of this bar. Parameters ---------- nolock : bool, optional If `True`, does not lock. If [default: `False`]: calls `acquire()` on internal lock. lock_args : tuple, optional Passed to internal lock's `acquire()`. If specified, will only `display()` if `acquire()` returns `True`. NFT)rr(rKrrO)r1r'rr'r'r(r6-s    z tqdm.refreshcCs0|jrdS|}|j||j7_||_dS)z(Restart tqdm timer from last print time.N)rrr3r)r1rr'r'r(unpauseHs  z tqdm.unpausecCsdd|_|dur ||_|jrdSd|_||_|_t|j|_ t|j|_ t|j|_ | dS)z Resets to 0 iterations for repeated use. Consider combining with `leave=True`. Parameters ---------- total : int or float, optional. Total to use for the new bar. rN) rrrrrrr3rrrrrr6)r1rr'r'r(resetPs     z tqdm.resetcCs&|r|dnd|_|r|dSdS)z Set/modify description of the progress bar. Parameters ---------- desc : str, optional refresh : bool, optional Forces refresh [default: True]. r+rdNrr6r1rr6r'r'r(set_descriptionfs  ztqdm.set_descriptioncCs|pd|_|r |dSdS)z-Set/modify description without ': ' appended.rdNrrr'r'r(set_description_strts  ztqdm.set_description_strc st|durgn|t|D]}|||<qD]"}t|tr0|||<qt|ts?t||<qdfddD|_|rW| dSdS)a8 Set/modify postfix (additional stats) with automatic formatting based on datatype. Parameters ---------- ordered_dict : dict or OrderedDict, optional refresh : bool, optional Forces refresh [default: True]. kwargs : dict, optional Nr~c3s$|] }|d|VqdS)=N)strip)rFr%rr'r(r{sz#tqdm.set_postfix..) rsortedkeysrWrrr-rrr6)r1 ordered_dictr6rCr%r'rr(rzs    ztqdm.set_postfixcCst||_|r |dSdS)zS Postfix without dictionary expansion, similar to prefix handling. N)r-rr6)r1rr6r'r'r(set_postfix_strs  ztqdm.set_postfix_strcCs4|jd|t| t|jddddS)Nr*rcSrr7r'r'r'r'r(rrztqdm.moveto..)rrrr)r1rr'r'r(rsz tqdm.movetocCs|jrt|dstdd|j|jdddS|jr#||j\|_|_|j|jt|dr3| |j nd|j|j|j |j |j |j|rL||nd|j|j|j|j|jd S) z'Public API for read-only member access.rcSrr7r'r'r'r'r(rrz"tqdm.format_dict..rr)rrrrr3N)rrrrr+rrrrrrrrrrs)rrZrrrrrrr+rr3rrrrrrrrrrrsrUr'r'r(rs   ztqdm.format_dictcCs|dur t|j}|jp d}||dkr"||krdS|s |dur"d}t|ds4tdt|jdtjj d |r;| || |durE| n||rP| | d S) a Use `self.sp` to display `msg` in the specified `pos`. Consider overloading this function when inheriting to use e.g.: `self.some_frontend(**self.format_dict)` instead of `self.sp`. Parameters ---------- msg : str, optional. What to display (default: `repr(self)`). pos : int, optional. Position to `moveto` (default: `abs(self.pos)`). Nr"r Fz ... (more hidden) ...rzAPlease use `tqdm.gui.tqdm(...)` instead of `tqdm(..., gui=True)` rrOT) rrr+rZr rrrrrrrr)r1r2rr+r'r'r(rs&       z tqdm.displaycks`|dd|i|}|rd|_d|_d|_t|j||VWddS1s)wYdS)a stream : file-like object. method : str, "read" or "write". The result of `read()` and the first argument of `write()` should have a `len()`. >>> with tqdm.wrapattr(file_obj, "read", total=file_obj.size) as fobj: ... while True: ... chunk = fobj.read(chunk_size) ... if not chunk: ... break rBTiNr')rrrrr)rPstreammethodrbytesr_rr'r'r(wrapattrs"z tqdm.wrapattr)rdr) NrdFrFNNNrrNr7)Nr*F)NF)NNNTNNr{r|NNFrFFrNrNNrFNNNr}F)r )F)FN)NT)rdTr@)6r$r%r&r8rrr r staticmethodrrrrr r rar!r0rrr1r8rrirrryr0rrrrrVrYrrrrrrrr\r.r6rrrrrrrrrrr'r'r'r(rsx     G       9     &C ,        $rcOstt|fi|S)z*Shortcut for tqdm(range(*args), **kwargs).)rrrQr'r'r(rsr)5r8r collectionsrr contextlibrrrrnumbersrr rer weakrefr _monitorr utilsrrrrrrrrrrrr __author____all__rrrrWarningrrhrDeprecationWarningr RuntimeWarningr!rDr rErbrrrr'r'r'r(sF       8  7S