techprotrade commited on
Commit
0d24195
·
verified ·
1 Parent(s): 2ab3715

Add loan-advisor-agent

Browse files
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/INSTALLER ADDED
@@ -0,0 +1 @@
 
 
1
+ uv
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/METADATA ADDED
@@ -0,0 +1,1595 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ Metadata-Version: 2.4
2
+ Name: tqdm
3
+ Version: 4.67.3
4
+ Summary: Fast, Extensible Progress Meter
5
+ Maintainer-email: tqdm developers <devs@tqdm.ml>
6
+ License: MPL-2.0 AND MIT
7
+ Project-URL: homepage, https://tqdm.github.io
8
+ Project-URL: repository, https://github.com/tqdm/tqdm
9
+ Project-URL: changelog, https://tqdm.github.io/releases
10
+ Project-URL: wiki, https://github.com/tqdm/tqdm/wiki
11
+ Keywords: progressbar,progressmeter,progress,bar,meter,rate,eta,console,terminal,time
12
+ Classifier: Development Status :: 5 - Production/Stable
13
+ Classifier: Environment :: Console
14
+ Classifier: Environment :: MacOS X
15
+ Classifier: Environment :: Other Environment
16
+ Classifier: Environment :: Win32 (MS Windows)
17
+ Classifier: Environment :: X11 Applications
18
+ Classifier: Framework :: IPython
19
+ Classifier: Framework :: Jupyter
20
+ Classifier: Intended Audience :: Developers
21
+ Classifier: Intended Audience :: Education
22
+ Classifier: Intended Audience :: End Users/Desktop
23
+ Classifier: Intended Audience :: Other Audience
24
+ Classifier: Intended Audience :: System Administrators
25
+ Classifier: Operating System :: MacOS
26
+ Classifier: Operating System :: MacOS :: MacOS X
27
+ Classifier: Operating System :: Microsoft
28
+ Classifier: Operating System :: Microsoft :: MS-DOS
29
+ Classifier: Operating System :: Microsoft :: Windows
30
+ Classifier: Operating System :: POSIX
31
+ Classifier: Operating System :: POSIX :: BSD
32
+ Classifier: Operating System :: POSIX :: BSD :: FreeBSD
33
+ Classifier: Operating System :: POSIX :: Linux
34
+ Classifier: Operating System :: POSIX :: SunOS/Solaris
35
+ Classifier: Operating System :: Unix
36
+ Classifier: Programming Language :: Python
37
+ Classifier: Programming Language :: Python :: 3
38
+ Classifier: Programming Language :: Python :: 3.7
39
+ Classifier: Programming Language :: Python :: 3.8
40
+ Classifier: Programming Language :: Python :: 3.9
41
+ Classifier: Programming Language :: Python :: 3.10
42
+ Classifier: Programming Language :: Python :: 3.11
43
+ Classifier: Programming Language :: Python :: 3.12
44
+ Classifier: Programming Language :: Python :: 3.13
45
+ Classifier: Programming Language :: Python :: 3 :: Only
46
+ Classifier: Programming Language :: Python :: Implementation
47
+ Classifier: Programming Language :: Python :: Implementation :: IronPython
48
+ Classifier: Programming Language :: Python :: Implementation :: PyPy
49
+ Classifier: Programming Language :: Unix Shell
50
+ Classifier: Topic :: Desktop Environment
51
+ Classifier: Topic :: Education :: Computer Aided Instruction (CAI)
52
+ Classifier: Topic :: Education :: Testing
53
+ Classifier: Topic :: Office/Business
54
+ Classifier: Topic :: Other/Nonlisted Topic
55
+ Classifier: Topic :: Software Development :: Build Tools
56
+ Classifier: Topic :: Software Development :: Libraries
57
+ Classifier: Topic :: Software Development :: Libraries :: Python Modules
58
+ Classifier: Topic :: Software Development :: Pre-processors
59
+ Classifier: Topic :: Software Development :: User Interfaces
60
+ Classifier: Topic :: System :: Installation/Setup
61
+ Classifier: Topic :: System :: Logging
62
+ Classifier: Topic :: System :: Monitoring
63
+ Classifier: Topic :: System :: Shells
64
+ Classifier: Topic :: Terminals
65
+ Classifier: Topic :: Utilities
66
+ Requires-Python: >=3.7
67
+ Description-Content-Type: text/x-rst
68
+ License-File: LICENCE
69
+ Requires-Dist: colorama; platform_system == "Windows"
70
+ Requires-Dist: importlib_metadata; python_version < "3.8"
71
+ Provides-Extra: dev
72
+ Requires-Dist: pytest>=6; extra == "dev"
73
+ Requires-Dist: pytest-cov; extra == "dev"
74
+ Requires-Dist: pytest-timeout; extra == "dev"
75
+ Requires-Dist: pytest-asyncio>=0.24; extra == "dev"
76
+ Requires-Dist: nbval; extra == "dev"
77
+ Provides-Extra: discord
78
+ Requires-Dist: requests; extra == "discord"
79
+ Provides-Extra: slack
80
+ Requires-Dist: slack-sdk; extra == "slack"
81
+ Provides-Extra: telegram
82
+ Requires-Dist: requests; extra == "telegram"
83
+ Provides-Extra: notebook
84
+ Requires-Dist: ipywidgets>=6; extra == "notebook"
85
+ Dynamic: license-file
86
+
87
+ |Logo|
88
+
89
+ tqdm
90
+ ====
91
+
92
+ |Py-Versions| |Versions| |Conda-Forge-Status| |Docker| |Snapcraft|
93
+
94
+ |Build-Status| |Coverage-Status| |Branch-Coverage-Status| |Codacy-Grade| |Libraries-Rank| |PyPI-Downloads|
95
+
96
+ |LICENCE| |OpenHub-Status| |binder-demo| |awesome-python|
97
+
98
+ ``tqdm`` derives from the Arabic word *taqaddum* (تقدّم) which can mean "progress,"
99
+ and is an abbreviation for "I love you so much" in Spanish (*te quiero demasiado*).
100
+
101
+ Instantly make your loops show a smart progress meter - just wrap any
102
+ iterable with ``tqdm(iterable)``, and you're done!
103
+
104
+ .. code:: python
105
+
106
+ from tqdm import tqdm
107
+ for i in tqdm(range(10000)):
108
+ ...
109
+
110
+ ``76%|████████████████████████        | 7568/10000 [00:33<00:10, 229.00it/s]``
111
+
112
+ ``trange(N)`` can be also used as a convenient shortcut for
113
+ ``tqdm(range(N))``.
114
+
115
+ |Screenshot|
116
+ |Video| |Slides| |Merch|
117
+
118
+ It can also be executed as a module with pipes:
119
+
120
+ .. code:: sh
121
+
122
+ $ seq 9999999 | tqdm --bytes | wc -l
123
+ 75.2MB [00:00, 217MB/s]
124
+ 9999999
125
+
126
+ $ tar -zcf - docs/ | tqdm --bytes --total `du -sb docs/ | cut -f1` \
127
+ > backup.tgz
128
+ 32%|██████████▍ | 8.89G/27.9G [00:42<01:31, 223MB/s]
129
+
130
+ Overhead is low -- about 60ns per iteration (80ns with ``tqdm.gui``), and is
131
+ unit tested against performance regression.
132
+ By comparison, the well-established
133
+ `ProgressBar <https://github.com/niltonvolpato/python-progressbar>`__ has
134
+ an 800ns/iter overhead.
135
+
136
+ In addition to its low overhead, ``tqdm`` uses smart algorithms to predict
137
+ the remaining time and to skip unnecessary iteration displays, which allows
138
+ for a negligible overhead in most cases.
139
+
140
+ ``tqdm`` works on any platform
141
+ (Linux, Windows, Mac, FreeBSD, NetBSD, Solaris/SunOS),
142
+ in any console or in a GUI, and is also friendly with IPython/Jupyter notebooks.
143
+
144
+ ``tqdm`` does not require any dependencies (not even ``curses``!), just
145
+ Python and an environment supporting ``carriage return \r`` and
146
+ ``line feed \n`` control characters.
147
+
148
+ ------------------------------------------
149
+
150
+ .. contents:: Table of contents
151
+ :backlinks: top
152
+ :local:
153
+
154
+
155
+ Installation
156
+ ------------
157
+
158
+ Latest PyPI stable release
159
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~
160
+
161
+ |Versions| |PyPI-Downloads| |Libraries-Dependents|
162
+
163
+ .. code:: sh
164
+
165
+ pip install tqdm
166
+
167
+ Latest development release on GitHub
168
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
169
+
170
+ |GitHub-Status| |GitHub-Stars| |GitHub-Commits| |GitHub-Forks| |GitHub-Updated|
171
+
172
+ Pull and install pre-release ``devel`` branch:
173
+
174
+ .. code:: sh
175
+
176
+ pip install "git+https://github.com/tqdm/tqdm.git@devel#egg=tqdm"
177
+
178
+ Latest Conda release
179
+ ~~~~~~~~~~~~~~~~~~~~
180
+
181
+ |Conda-Forge-Status|
182
+
183
+ .. code:: sh
184
+
185
+ conda install -c conda-forge tqdm
186
+
187
+ Latest Snapcraft release
188
+ ~~~~~~~~~~~~~~~~~~~~~~~~
189
+
190
+ |Snapcraft|
191
+
192
+ There are 3 channels to choose from:
193
+
194
+ .. code:: sh
195
+
196
+ snap install tqdm # implies --stable, i.e. latest tagged release
197
+ snap install tqdm --candidate # master branch
198
+ snap install tqdm --edge # devel branch
199
+
200
+ Note that ``snap`` binaries are purely for CLI use (not ``import``-able), and
201
+ automatically set up ``bash`` tab-completion.
202
+
203
+ Latest Docker release
204
+ ~~~~~~~~~~~~~~~~~~~~~
205
+
206
+ |Docker|
207
+
208
+ .. code:: sh
209
+
210
+ docker pull tqdm/tqdm
211
+ docker run -i --rm tqdm/tqdm --help
212
+
213
+ Other
214
+ ~~~~~
215
+
216
+ There are other (unofficial) places where ``tqdm`` may be downloaded, particularly for CLI use:
217
+
218
+ |Repology|
219
+
220
+ .. |Repology| image:: https://repology.org/badge/tiny-repos/python:tqdm.svg
221
+ :target: https://repology.org/project/python:tqdm/versions
222
+
223
+ Changelog
224
+ ---------
225
+
226
+ The list of all changes is available either on GitHub's Releases:
227
+ |GitHub-Status|, on the
228
+ `wiki <https://github.com/tqdm/tqdm/wiki/Releases>`__, or on the
229
+ `website <https://tqdm.github.io/releases>`__.
230
+
231
+
232
+ Usage
233
+ -----
234
+
235
+ ``tqdm`` is very versatile and can be used in a number of ways.
236
+ The three main ones are given below.
237
+
238
+ Iterable-based
239
+ ~~~~~~~~~~~~~~
240
+
241
+ Wrap ``tqdm()`` around any iterable:
242
+
243
+ .. code:: python
244
+
245
+ from tqdm import tqdm
246
+ from time import sleep
247
+
248
+ text = ""
249
+ for char in tqdm(["a", "b", "c", "d"]):
250
+ sleep(0.25)
251
+ text = text + char
252
+
253
+ ``trange(i)`` is a special optimised instance of ``tqdm(range(i))``:
254
+
255
+ .. code:: python
256
+
257
+ from tqdm import trange
258
+
259
+ for i in trange(100):
260
+ sleep(0.01)
261
+
262
+ Instantiation outside of the loop allows for manual control over ``tqdm()``:
263
+
264
+ .. code:: python
265
+
266
+ pbar = tqdm(["a", "b", "c", "d"])
267
+ for char in pbar:
268
+ sleep(0.25)
269
+ pbar.set_description("Processing %s" % char)
270
+
271
+ Manual
272
+ ~~~~~~
273
+
274
+ Manual control of ``tqdm()`` updates using a ``with`` statement:
275
+
276
+ .. code:: python
277
+
278
+ with tqdm(total=100) as pbar:
279
+ for i in range(10):
280
+ sleep(0.1)
281
+ pbar.update(10)
282
+
283
+ If the optional variable ``total`` (or an iterable with ``len()``) is
284
+ provided, predictive stats are displayed.
285
+
286
+ ``with`` is also optional (you can just assign ``tqdm()`` to a variable,
287
+ but in this case don't forget to ``del`` or ``close()`` at the end:
288
+
289
+ .. code:: python
290
+
291
+ pbar = tqdm(total=100)
292
+ for i in range(10):
293
+ sleep(0.1)
294
+ pbar.update(10)
295
+ pbar.close()
296
+
297
+ Module
298
+ ~~~~~~
299
+
300
+ Perhaps the most wonderful use of ``tqdm`` is in a script or on the command
301
+ line. Simply inserting ``tqdm`` (or ``python -m tqdm``) between pipes will pass
302
+ through all ``stdin`` to ``stdout`` while printing progress to ``stderr``.
303
+
304
+ The example below demonstrate counting the number of lines in all Python files
305
+ in the current directory, with timing information included.
306
+
307
+ .. code:: sh
308
+
309
+ $ time find . -name '*.py' -type f -exec cat \{} \; | wc -l
310
+ 857365
311
+
312
+ real 0m3.458s
313
+ user 0m0.274s
314
+ sys 0m3.325s
315
+
316
+ $ time find . -name '*.py' -type f -exec cat \{} \; | tqdm | wc -l
317
+ 857366it [00:03, 246471.31it/s]
318
+ 857365
319
+
320
+ real 0m3.585s
321
+ user 0m0.862s
322
+ sys 0m3.358s
323
+
324
+ Note that the usual arguments for ``tqdm`` can also be specified.
325
+
326
+ .. code:: sh
327
+
328
+ $ find . -name '*.py' -type f -exec cat \{} \; |
329
+ tqdm --unit loc --unit_scale --total 857366 >> /dev/null
330
+ 100%|█████████████████████████████████| 857K/857K [00:04<00:00, 246Kloc/s]
331
+
332
+ Backing up a large directory?
333
+
334
+ .. code:: sh
335
+
336
+ $ tar -zcf - docs/ | tqdm --bytes --total `du -sb docs/ | cut -f1` \
337
+ > backup.tgz
338
+ 44%|██████████████▊ | 153M/352M [00:14<00:18, 11.0MB/s]
339
+
340
+ This can be beautified further:
341
+
342
+ .. code:: sh
343
+
344
+ $ BYTES=$(du -sb docs/ | cut -f1)
345
+ $ tar -cf - docs/ \
346
+ | tqdm --bytes --total "$BYTES" --desc Processing | gzip \
347
+ | tqdm --bytes --total "$BYTES" --desc Compressed --position 1 \
348
+ > ~/backup.tgz
349
+ Processing: 100%|██████████████████████| 352M/352M [00:14<00:00, 30.2MB/s]
350
+ Compressed: 42%|█████████▎ | 148M/352M [00:14<00:19, 10.9MB/s]
351
+
352
+ Or done on a file level using 7-zip:
353
+
354
+ .. code:: sh
355
+
356
+ $ 7z a -bd -r backup.7z docs/ | grep Compressing \
357
+ | tqdm --total $(find docs/ -type f | wc -l) --unit files \
358
+ | grep -v Compressing
359
+ 100%|██████████████████████████▉| 15327/15327 [01:00<00:00, 712.96files/s]
360
+
361
+ Pre-existing CLI programs already outputting basic progress information will
362
+ benefit from ``tqdm``'s ``--update`` and ``--update_to`` flags:
363
+
364
+ .. code:: sh
365
+
366
+ $ seq 3 0.1 5 | tqdm --total 5 --update_to --null
367
+ 100%|████████████████████████████████████| 5.0/5 [00:00<00:00, 9673.21it/s]
368
+ $ seq 10 | tqdm --update --null # 1 + 2 + ... + 10 = 55 iterations
369
+ 55it [00:00, 90006.52it/s]
370
+
371
+ FAQ and Known Issues
372
+ --------------------
373
+
374
+ |GitHub-Issues|
375
+
376
+ The most common issues relate to excessive output on multiple lines, instead
377
+ of a neat one-line progress bar.
378
+
379
+ - Consoles in general: require support for carriage return (``CR``, ``\r``).
380
+
381
+ * Some cloud logging consoles which don't support ``\r`` properly
382
+ (`cloudwatch <https://github.com/tqdm/tqdm/issues/966>`__,
383
+ `K8s <https://github.com/tqdm/tqdm/issues/1319>`__) may benefit from
384
+ ``export TQDM_POSITION=-1``.
385
+
386
+ - Nested progress bars:
387
+
388
+ * Consoles in general: require support for moving cursors up to the
389
+ previous line. For example,
390
+ `IDLE <https://github.com/tqdm/tqdm/issues/191#issuecomment-230168030>`__,
391
+ `ConEmu <https://github.com/tqdm/tqdm/issues/254>`__ and
392
+ `PyCharm <https://github.com/tqdm/tqdm/issues/203>`__ (also
393
+ `here <https://github.com/tqdm/tqdm/issues/208>`__,
394
+ `here <https://github.com/tqdm/tqdm/issues/307>`__, and
395
+ `here <https://github.com/tqdm/tqdm/issues/454#issuecomment-335416815>`__)
396
+ lack full support.
397
+ * Windows: additionally may require the Python module ``colorama``
398
+ to ensure nested bars stay within their respective lines.
399
+
400
+ - Unicode:
401
+
402
+ * Environments which report that they support unicode will have solid smooth
403
+ progressbars. The fallback is an ``ascii``-only bar.
404
+ * Windows consoles often only partially support unicode and thus
405
+ `often require explicit ascii=True <https://github.com/tqdm/tqdm/issues/454#issuecomment-335416815>`__
406
+ (also `here <https://github.com/tqdm/tqdm/issues/499>`__). This is due to
407
+ either normal-width unicode characters being incorrectly displayed as
408
+ "wide", or some unicode characters not rendering.
409
+
410
+ - Wrapping generators:
411
+
412
+ * Generator wrapper functions tend to hide the length of iterables.
413
+ ``tqdm`` does not.
414
+ * Replace ``tqdm(enumerate(...))`` with ``enumerate(tqdm(...))`` or
415
+ ``tqdm(enumerate(x), total=len(x), ...)``.
416
+ The same applies to ``numpy.ndenumerate``.
417
+ * Replace ``tqdm(zip(a, b))`` with ``zip(tqdm(a), b)`` or even
418
+ ``zip(tqdm(a), tqdm(b))``.
419
+ * The same applies to ``itertools``.
420
+ * Some useful convenience functions can be found under ``tqdm.contrib``.
421
+
422
+ - `No intermediate output in docker-compose <https://github.com/tqdm/tqdm/issues/771>`__:
423
+ use ``docker-compose run`` instead of ``docker-compose up`` and ``tty: true``.
424
+
425
+ - Overriding defaults via environment variables:
426
+ e.g. in CI/cloud jobs, ``export TQDM_MININTERVAL=5`` to avoid log spam.
427
+ This override logic is handled by the ``tqdm.utils.envwrap`` decorator
428
+ (useful independent of ``tqdm``).
429
+
430
+ If you come across any other difficulties, browse and file |GitHub-Issues|.
431
+
432
+ Documentation
433
+ -------------
434
+
435
+ |Py-Versions| |README-Hits| (Since 19 May 2016)
436
+
437
+ .. code:: python
438
+
439
+ class tqdm():
440
+ """
441
+ Decorate an iterable object, returning an iterator which acts exactly
442
+ like the original iterable, but prints a dynamically updating
443
+ progressbar every time a value is requested.
444
+ """
445
+
446
+ @envwrap("TQDM_") # override defaults via env vars
447
+ def __init__(self, iterable=None, desc=None, total=None, leave=True,
448
+ file=None, ncols=None, mininterval=0.1,
449
+ maxinterval=10.0, miniters=None, ascii=None, disable=False,
450
+ unit='it', unit_scale=False, dynamic_ncols=False,
451
+ smoothing=0.3, bar_format=None, initial=0, position=None,
452
+ postfix=None, unit_divisor=1000, write_bytes=False,
453
+ lock_args=None, nrows=None, colour=None, delay=0):
454
+
455
+ Parameters
456
+ ~~~~~~~~~~
457
+
458
+ * iterable : iterable, optional
459
+ Iterable to decorate with a progressbar.
460
+ Leave blank to manually manage the updates.
461
+ * desc : str, optional
462
+ Prefix for the progressbar.
463
+ * total : int or float, optional
464
+ The number of expected iterations. If unspecified,
465
+ len(iterable) is used if possible. If float("inf") or as a last
466
+ resort, only basic progress statistics are displayed
467
+ (no ETA, no progressbar).
468
+ If ``gui`` is True and this parameter needs subsequent updating,
469
+ specify an initial arbitrary large positive number,
470
+ e.g. 9e9.
471
+ * leave : bool, optional
472
+ If [default: True], keeps all traces of the progressbar
473
+ upon termination of iteration.
474
+ If ``None``, will leave only if ``position`` is ``0``.
475
+ * file : ``io.TextIOWrapper`` or ``io.StringIO``, optional
476
+ Specifies where to output the progress messages
477
+ (default: sys.stderr). Uses ``file.write(str)`` and ``file.flush()``
478
+ methods. For encoding, see ``write_bytes``.
479
+ * ncols : int, optional
480
+ The width of the entire output message. If specified,
481
+ dynamically resizes the progressbar to stay within this bound.
482
+ If unspecified, attempts to use environment width. The
483
+ fallback is a meter width of 10 and no limit for the counter and
484
+ statistics. If 0, will not print any meter (only stats).
485
+ * mininterval : float, optional
486
+ Minimum progress display update interval [default: 0.1] seconds.
487
+ * maxinterval : float, optional
488
+ Maximum progress display update interval [default: 10] seconds.
489
+ Automatically adjusts ``miniters`` to correspond to ``mininterval``
490
+ after long display update lag. Only works if ``dynamic_miniters``
491
+ or monitor thread is enabled.
492
+ * miniters : int or float, optional
493
+ Minimum progress display update interval, in iterations.
494
+ If 0 and ``dynamic_miniters``, will automatically adjust to equal
495
+ ``mininterval`` (more CPU efficient, good for tight loops).
496
+ If > 0, will skip display of specified number of iterations.
497
+ Tweak this and ``mininterval`` to get very efficient loops.
498
+ If your progress is erratic with both fast and slow iterations
499
+ (network, skipping items, etc) you should set miniters=1.
500
+ * ascii : bool or str, optional
501
+ If unspecified or False, use unicode (smooth blocks) to fill
502
+ the meter. The fallback is to use ASCII characters " 123456789#".
503
+ * disable : bool, optional
504
+ Whether to disable the entire progressbar wrapper
505
+ [default: False]. If set to None, disable on non-TTY.
506
+ * unit : str, optional
507
+ String that will be used to define the unit of each iteration
508
+ [default: it].
509
+ * unit_scale : bool or int or float, optional
510
+ If 1 or True, the number of iterations will be reduced/scaled
511
+ automatically and a metric prefix following the
512
+ International System of Units standard will be added
513
+ (kilo, mega, etc.) [default: False]. If any other non-zero
514
+ number, will scale ``total`` and ``n``.
515
+ * dynamic_ncols : bool, optional
516
+ If set, constantly alters ``ncols`` and ``nrows`` to the
517
+ environment (allowing for window resizes) [default: False].
518
+ * smoothing : float, optional
519
+ Exponential moving average smoothing factor for speed estimates
520
+ (ignored in GUI mode). Ranges from 0 (average speed) to 1
521
+ (current/instantaneous speed) [default: 0.3].
522
+ * bar_format : str, optional
523
+ Specify a custom bar string formatting. May impact performance.
524
+ [default: '{l_bar}{bar}{r_bar}'], where
525
+ l_bar='{desc}: {percentage:3.0f}%|' and
526
+ r_bar='| {n_fmt}/{total_fmt} [{elapsed}<{remaining}, '
527
+ '{rate_fmt}{postfix}]'
528
+ Possible vars: l_bar, bar, r_bar, n, n_fmt, total, total_fmt,
529
+ percentage, elapsed, elapsed_s, ncols, nrows, desc, unit,
530
+ rate, rate_fmt, rate_noinv, rate_noinv_fmt,
531
+ rate_inv, rate_inv_fmt, postfix, unit_divisor,
532
+ remaining, remaining_s, eta.
533
+ Note that a trailing ": " is automatically removed after {desc}
534
+ if the latter is empty.
535
+ * initial : int or float, optional
536
+ The initial counter value. Useful when restarting a progress
537
+ bar [default: 0]. If using float, consider specifying ``{n:.3f}``
538
+ or similar in ``bar_format``, or specifying ``unit_scale``.
539
+ * position : int, optional
540
+ Specify the line offset to print this bar (starting from 0)
541
+ Automatic if unspecified.
542
+ Useful to manage multiple bars at once (eg, from threads).
543
+ * postfix : dict or ``*``, optional
544
+ Specify additional stats to display at the end of the bar.
545
+ Calls ``set_postfix(**postfix)`` if possible (dict).
546
+ * unit_divisor : float, optional
547
+ [default: 1000], ignored unless ``unit_scale`` is True.
548
+ * write_bytes : bool, optional
549
+ Whether to write bytes. If (default: False) will write unicode.
550
+ * lock_args : tuple, optional
551
+ Passed to ``refresh`` for intermediate output
552
+ (initialisation, iterating, and updating).
553
+ * nrows : int, optional
554
+ The screen height. If specified, hides nested bars outside this
555
+ bound. If unspecified, attempts to use environment height.
556
+ The fallback is 20.
557
+ * colour : str, optional
558
+ Bar colour (e.g. 'green', '#00ff00').
559
+ * delay : float, optional
560
+ Don't display until [default: 0] seconds have elapsed.
561
+
562
+ Extra CLI Options
563
+ ~~~~~~~~~~~~~~~~~
564
+
565
+ * delim : chr, optional
566
+ Delimiting character [default: '\n']. Use '\0' for null.
567
+ N.B.: on Windows systems, Python converts '\n' to '\r\n'.
568
+ * buf_size : int, optional
569
+ String buffer size in bytes [default: 256]
570
+ used when ``delim`` is specified.
571
+ * bytes : bool, optional
572
+ If true, will count bytes, ignore ``delim``, and default
573
+ ``unit_scale`` to True, ``unit_divisor`` to 1024, and ``unit`` to 'B'.
574
+ * tee : bool, optional
575
+ If true, passes ``stdin`` to both ``stderr`` and ``stdout``.
576
+ * update : bool, optional
577
+ If true, will treat input as newly elapsed iterations,
578
+ i.e. numbers to pass to ``update()``. Note that this is slow
579
+ (~2e5 it/s) since every input must be decoded as a number.
580
+ * update_to : bool, optional
581
+ If true, will treat input as total elapsed iterations,
582
+ i.e. numbers to assign to ``self.n``. Note that this is slow
583
+ (~2e5 it/s) since every input must be decoded as a number.
584
+ * null : bool, optional
585
+ If true, will discard input (no stdout).
586
+ * manpath : str, optional
587
+ Directory in which to install tqdm man pages.
588
+ * comppath : str, optional
589
+ Directory in which to place tqdm completion.
590
+ * log : str, optional
591
+ CRITICAL|FATAL|ERROR|WARN(ING)|[default: 'INFO']|DEBUG|NOTSET.
592
+
593
+ Returns
594
+ ~~~~~~~
595
+
596
+ * out : decorated iterator.
597
+
598
+ .. code:: python
599
+
600
+ class tqdm():
601
+ def update(self, n=1):
602
+ """
603
+ Manually update the progress bar, useful for streams
604
+ such as reading files.
605
+ E.g.:
606
+ >>> t = tqdm(total=filesize) # Initialise
607
+ >>> for current_buffer in stream:
608
+ ... ...
609
+ ... t.update(len(current_buffer))
610
+ >>> t.close()
611
+ The last line is highly recommended, but possibly not necessary if
612
+ ``t.update()`` will be called in such a way that ``filesize`` will be
613
+ exactly reached and printed.
614
+
615
+ Parameters
616
+ ----------
617
+ n : int or float, optional
618
+ Increment to add to the internal counter of iterations
619
+ [default: 1]. If using float, consider specifying ``{n:.3f}``
620
+ or similar in ``bar_format``, or specifying ``unit_scale``.
621
+
622
+ Returns
623
+ -------
624
+ out : bool or None
625
+ True if a ``display()`` was triggered.
626
+ """
627
+
628
+ def close(self):
629
+ """Cleanup and (if leave=False) close the progressbar."""
630
+
631
+ def clear(self, nomove=False):
632
+ """Clear current bar display."""
633
+
634
+ def refresh(self):
635
+ """
636
+ Force refresh the display of this bar.
637
+
638
+ Parameters
639
+ ----------
640
+ nolock : bool, optional
641
+ If ``True``, does not lock.
642
+ If [default: ``False``]: calls ``acquire()`` on internal lock.
643
+ lock_args : tuple, optional
644
+ Passed to internal lock's ``acquire()``.
645
+ If specified, will only ``display()`` if ``acquire()`` returns ``True``.
646
+ """
647
+
648
+ def unpause(self):
649
+ """Restart tqdm timer from last print time."""
650
+
651
+ def reset(self, total=None):
652
+ """
653
+ Resets to 0 iterations for repeated use.
654
+
655
+ Consider combining with ``leave=True``.
656
+
657
+ Parameters
658
+ ----------
659
+ total : int or float, optional. Total to use for the new bar.
660
+ """
661
+
662
+ def set_description(self, desc=None, refresh=True):
663
+ """
664
+ Set/modify description of the progress bar.
665
+
666
+ Parameters
667
+ ----------
668
+ desc : str, optional
669
+ refresh : bool, optional
670
+ Forces refresh [default: True].
671
+ """
672
+
673
+ def set_postfix(self, ordered_dict=None, refresh=True, **tqdm_kwargs):
674
+ """
675
+ Set/modify postfix (additional stats)
676
+ with automatic formatting based on datatype.
677
+
678
+ Parameters
679
+ ----------
680
+ ordered_dict : dict or OrderedDict, optional
681
+ refresh : bool, optional
682
+ Forces refresh [default: True].
683
+ kwargs : dict, optional
684
+ """
685
+
686
+ @classmethod
687
+ def write(cls, s, file=sys.stdout, end="\n"):
688
+ """Print a message via tqdm (without overlap with bars)."""
689
+
690
+ @property
691
+ def format_dict(self):
692
+ """Public API for read-only member access."""
693
+
694
+ def display(self, msg=None, pos=None):
695
+ """
696
+ Use ``self.sp`` to display ``msg`` in the specified ``pos``.
697
+
698
+ Consider overloading this function when inheriting to use e.g.:
699
+ ``self.some_frontend(**self.format_dict)`` instead of ``self.sp``.
700
+
701
+ Parameters
702
+ ----------
703
+ msg : str, optional. What to display (default: ``repr(self)``).
704
+ pos : int, optional. Position to ``moveto``
705
+ (default: ``abs(self.pos)``).
706
+ """
707
+
708
+ @classmethod
709
+ @contextmanager
710
+ def wrapattr(cls, stream, method, total=None, bytes=True, **tqdm_kwargs):
711
+ """
712
+ stream : file-like object.
713
+ method : str, "read" or "write". The result of ``read()`` and
714
+ the first argument of ``write()`` should have a ``len()``.
715
+
716
+ >>> with tqdm.wrapattr(file_obj, "read", total=file_obj.size) as fobj:
717
+ ... while True:
718
+ ... chunk = fobj.read(chunk_size)
719
+ ... if not chunk:
720
+ ... break
721
+ """
722
+
723
+ @classmethod
724
+ def pandas(cls, *targs, **tqdm_kwargs):
725
+ """Registers the current `tqdm` class with `pandas`."""
726
+
727
+ def trange(*args, **tqdm_kwargs):
728
+ """Shortcut for `tqdm(range(*args), **tqdm_kwargs)`."""
729
+
730
+ Convenience Functions
731
+ ~~~~~~~~~~~~~~~~~~~~~
732
+
733
+ .. code:: python
734
+
735
+ def tqdm.contrib.tenumerate(iterable, start=0, total=None,
736
+ tqdm_class=tqdm.auto.tqdm, **tqdm_kwargs):
737
+ """Equivalent of `numpy.ndenumerate` or builtin `enumerate`."""
738
+
739
+ def tqdm.contrib.tzip(iter1, *iter2plus, **tqdm_kwargs):
740
+ """Equivalent of builtin `zip`."""
741
+
742
+ def tqdm.contrib.tmap(function, *sequences, **tqdm_kwargs):
743
+ """Equivalent of builtin `map`."""
744
+
745
+ Submodules
746
+ ~~~~~~~~~~
747
+
748
+ .. code:: python
749
+
750
+ class tqdm.notebook.tqdm(tqdm.tqdm):
751
+ """IPython/Jupyter Notebook widget."""
752
+
753
+ class tqdm.auto.tqdm(tqdm.tqdm):
754
+ """Automatically chooses beween `tqdm.notebook` and `tqdm.tqdm`."""
755
+
756
+ class tqdm.asyncio.tqdm(tqdm.tqdm):
757
+ """Asynchronous version."""
758
+ @classmethod
759
+ def as_completed(cls, fs, *, loop=None, timeout=None, total=None,
760
+ **tqdm_kwargs):
761
+ """Wrapper for `asyncio.as_completed`."""
762
+
763
+ class tqdm.gui.tqdm(tqdm.tqdm):
764
+ """Matplotlib GUI version."""
765
+
766
+ class tqdm.tk.tqdm(tqdm.tqdm):
767
+ """Tkinter GUI version."""
768
+
769
+ class tqdm.rich.tqdm(tqdm.tqdm):
770
+ """`rich.progress` version."""
771
+
772
+ class tqdm.keras.TqdmCallback(keras.callbacks.Callback):
773
+ """Keras callback for epoch and batch progress."""
774
+
775
+ class tqdm.dask.TqdmCallback(dask.callbacks.Callback):
776
+ """Dask callback for task progress."""
777
+
778
+
779
+ ``contrib``
780
+ +++++++++++
781
+
782
+ The ``tqdm.contrib`` package also contains experimental modules:
783
+
784
+ - ``tqdm.contrib.itertools``: Thin wrappers around ``itertools``
785
+ - ``tqdm.contrib.concurrent``: Thin wrappers around ``concurrent.futures``
786
+ - ``tqdm.contrib.slack``: Posts to `Slack <https://slack.com>`__ bots
787
+ - ``tqdm.contrib.discord``: Posts to `Discord <https://discord.com>`__ bots
788
+ - ``tqdm.contrib.telegram``: Posts to `Telegram <https://telegram.org>`__ bots
789
+ - ``tqdm.contrib.bells``: Automagically enables all optional features
790
+
791
+ * ``auto``, ``pandas``, ``slack``, ``discord``, ``telegram``
792
+
793
+ Examples and Advanced Usage
794
+ ---------------------------
795
+
796
+ - See the `examples <https://github.com/tqdm/tqdm/tree/master/examples>`__
797
+ folder;
798
+ - import the module and run ``help()``;
799
+ - consult the `wiki <https://github.com/tqdm/tqdm/wiki>`__;
800
+
801
+ * this has an
802
+ `excellent article <https://github.com/tqdm/tqdm/wiki/How-to-make-a-great-Progress-Bar>`__
803
+ on how to make a **great** progressbar;
804
+
805
+ - check out the `slides from PyData London <https://tqdm.github.io/PyData2019/slides.html>`__, or
806
+ - run the |binder-demo|.
807
+
808
+ Description and additional stats
809
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
810
+
811
+ Custom information can be displayed and updated dynamically on ``tqdm`` bars
812
+ with the ``desc`` and ``postfix`` arguments:
813
+
814
+ .. code:: python
815
+
816
+ from tqdm import tqdm, trange
817
+ from random import random, randint
818
+ from time import sleep
819
+
820
+ with trange(10) as t:
821
+ for i in t:
822
+ # Description will be displayed on the left
823
+ t.set_description('GEN %i' % i)
824
+ # Postfix will be displayed on the right,
825
+ # formatted automatically based on argument's datatype
826
+ t.set_postfix(loss=random(), gen=randint(1,999), str='h',
827
+ lst=[1, 2])
828
+ sleep(0.1)
829
+
830
+ with tqdm(total=10, bar_format="{postfix[0]} {postfix[1][value]:>8.2g}",
831
+ postfix=["Batch", {"value": 0}]) as t:
832
+ for i in range(10):
833
+ sleep(0.1)
834
+ t.postfix[1]["value"] = i / 2
835
+ t.update()
836
+
837
+ Points to remember when using ``{postfix[...]}`` in the ``bar_format`` string:
838
+
839
+ - ``postfix`` also needs to be passed as an initial argument in a compatible
840
+ format, and
841
+ - ``postfix`` will be auto-converted to a string if it is a ``dict``-like
842
+ object. To prevent this behaviour, insert an extra item into the dictionary
843
+ where the key is not a string.
844
+
845
+ Additional ``bar_format`` parameters may also be defined by overriding
846
+ ``format_dict``, and the bar itself may be modified using ``ascii``:
847
+
848
+ .. code:: python
849
+
850
+ from tqdm import tqdm
851
+ class TqdmExtraFormat(tqdm):
852
+ """Provides a `total_time` format parameter"""
853
+ @property
854
+ def format_dict(self):
855
+ d = super().format_dict
856
+ total_time = d["elapsed"] * (d["total"] or 0) / max(d["n"], 1)
857
+ d.update(total_time=self.format_interval(total_time) + " in total")
858
+ return d
859
+
860
+ for i in TqdmExtraFormat(
861
+ range(9), ascii=" .oO0",
862
+ bar_format="{total_time}: {percentage:.0f}%|{bar}{r_bar}"):
863
+ if i == 4:
864
+ break
865
+
866
+ .. code::
867
+
868
+ 00:00 in total: 44%|0000. | 4/9 [00:00<00:00, 962.93it/s]
869
+
870
+ Note that ``{bar}`` also supports a format specifier ``[width][type]``.
871
+
872
+ - ``width``
873
+
874
+ * unspecified (default): automatic to fill ``ncols``
875
+ * ``int >= 0``: fixed width overriding ``ncols`` logic
876
+ * ``int < 0``: subtract from the automatic default
877
+
878
+ - ``type``
879
+
880
+ * ``a``: ascii (``ascii=True`` override)
881
+ * ``u``: unicode (``ascii=False`` override)
882
+ * ``b``: blank (``ascii=" "`` override)
883
+
884
+ This means a fixed bar with right-justified text may be created by using:
885
+ ``bar_format="{l_bar}{bar:10}|{bar:-10b}right-justified"``
886
+
887
+ Nested progress bars
888
+ ~~~~~~~~~~~~~~~~~~~~
889
+
890
+ ``tqdm`` supports nested progress bars. Here's an example:
891
+
892
+ .. code:: python
893
+
894
+ from tqdm.auto import trange
895
+ from time import sleep
896
+
897
+ for i in trange(4, desc='1st loop'):
898
+ for j in trange(5, desc='2nd loop'):
899
+ for k in trange(50, desc='3rd loop', leave=False):
900
+ sleep(0.01)
901
+
902
+ For manual control over positioning (e.g. for multi-processing use),
903
+ you may specify ``position=n`` where ``n=0`` for the outermost bar,
904
+ ``n=1`` for the next, and so on.
905
+ However, it's best to check if ``tqdm`` can work without manual ``position``
906
+ first.
907
+
908
+ .. code:: python
909
+
910
+ from time import sleep
911
+ from tqdm import trange, tqdm
912
+ from multiprocessing import Pool, RLock, freeze_support
913
+
914
+ L = list(range(9))
915
+
916
+ def progresser(n):
917
+ interval = 0.001 / (n + 2)
918
+ total = 5000
919
+ text = f"#{n}, est. {interval * total:<04.2}s"
920
+ for _ in trange(total, desc=text, position=n):
921
+ sleep(interval)
922
+
923
+ if __name__ == '__main__':
924
+ freeze_support() # for Windows support
925
+ tqdm.set_lock(RLock()) # for managing output contention
926
+ p = Pool(initializer=tqdm.set_lock, initargs=(tqdm.get_lock(),))
927
+ p.map(progresser, L)
928
+
929
+ Note that in Python 3, ``tqdm.write`` is thread-safe:
930
+
931
+ .. code:: python
932
+
933
+ from time import sleep
934
+ from tqdm import tqdm, trange
935
+ from concurrent.futures import ThreadPoolExecutor
936
+
937
+ L = list(range(9))
938
+
939
+ def progresser(n):
940
+ interval = 0.001 / (n + 2)
941
+ total = 5000
942
+ text = f"#{n}, est. {interval * total:<04.2}s"
943
+ for _ in trange(total, desc=text):
944
+ sleep(interval)
945
+ if n == 6:
946
+ tqdm.write("n == 6 completed.")
947
+ tqdm.write("`tqdm.write()` is thread-safe in py3!")
948
+
949
+ if __name__ == '__main__':
950
+ with ThreadPoolExecutor() as p:
951
+ p.map(progresser, L)
952
+
953
+ Hooks and callbacks
954
+ ~~~~~~~~~~~~~~~~~~~
955
+
956
+ ``tqdm`` can easily support callbacks/hooks and manual updates.
957
+ Here's an example with ``urllib``:
958
+
959
+ **``urllib.urlretrieve`` documentation**
960
+
961
+ | [...]
962
+ | If present, the hook function will be called once
963
+ | on establishment of the network connection and once after each block read
964
+ | thereafter. The hook will be passed three arguments; a count of blocks
965
+ | transferred so far, a block size in bytes, and the total size of the file.
966
+ | [...]
967
+
968
+ .. code:: python
969
+
970
+ import urllib, os
971
+ from tqdm import tqdm
972
+ urllib = getattr(urllib, 'request', urllib)
973
+
974
+ class TqdmUpTo(tqdm):
975
+ """Provides `update_to(n)` which uses `tqdm.update(delta_n)`."""
976
+ def update_to(self, b=1, bsize=1, tsize=None):
977
+ """
978
+ b : int, optional
979
+ Number of blocks transferred so far [default: 1].
980
+ bsize : int, optional
981
+ Size of each block (in tqdm units) [default: 1].
982
+ tsize : int, optional
983
+ Total size (in tqdm units). If [default: None] remains unchanged.
984
+ """
985
+ if tsize is not None:
986
+ self.total = tsize
987
+ return self.update(b * bsize - self.n) # also sets self.n = b * bsize
988
+
989
+ eg_link = "https://caspersci.uk.to/matryoshka.zip"
990
+ with TqdmUpTo(unit='B', unit_scale=True, unit_divisor=1024, miniters=1,
991
+ desc=eg_link.split('/')[-1]) as t: # all optional kwargs
992
+ urllib.urlretrieve(eg_link, filename=os.devnull,
993
+ reporthook=t.update_to, data=None)
994
+ t.total = t.n
995
+
996
+ Inspired by `twine#242 <https://github.com/pypa/twine/pull/242>`__.
997
+ Functional alternative in
998
+ `examples/tqdm_wget.py <https://github.com/tqdm/tqdm/blob/master/examples/tqdm_wget.py>`__.
999
+
1000
+ It is recommend to use ``miniters=1`` whenever there is potentially
1001
+ large differences in iteration speed (e.g. downloading a file over
1002
+ a patchy connection).
1003
+
1004
+ **Wrapping read/write methods**
1005
+
1006
+ To measure throughput through a file-like object's ``read`` or ``write``
1007
+ methods, use ``CallbackIOWrapper``:
1008
+
1009
+ .. code:: python
1010
+
1011
+ from tqdm.auto import tqdm
1012
+ from tqdm.utils import CallbackIOWrapper
1013
+
1014
+ with tqdm(total=file_obj.size,
1015
+ unit='B', unit_scale=True, unit_divisor=1024) as t:
1016
+ fobj = CallbackIOWrapper(t.update, file_obj, "read")
1017
+ while True:
1018
+ chunk = fobj.read(chunk_size)
1019
+ if not chunk:
1020
+ break
1021
+ t.reset()
1022
+ # ... continue to use `t` for something else
1023
+
1024
+ Alternatively, use the even simpler ``wrapattr`` convenience function,
1025
+ which would condense both the ``urllib`` and ``CallbackIOWrapper`` examples
1026
+ down to:
1027
+
1028
+ .. code:: python
1029
+
1030
+ import urllib, os
1031
+ from tqdm import tqdm
1032
+
1033
+ eg_link = "https://caspersci.uk.to/matryoshka.zip"
1034
+ response = getattr(urllib, 'request', urllib).urlopen(eg_link)
1035
+ with tqdm.wrapattr(open(os.devnull, "wb"), "write",
1036
+ miniters=1, desc=eg_link.split('/')[-1],
1037
+ total=getattr(response, 'length', None)) as fout:
1038
+ for chunk in response:
1039
+ fout.write(chunk)
1040
+
1041
+ The ``requests`` equivalent is nearly identical:
1042
+
1043
+ .. code:: python
1044
+
1045
+ import requests, os
1046
+ from tqdm import tqdm
1047
+
1048
+ eg_link = "https://caspersci.uk.to/matryoshka.zip"
1049
+ response = requests.get(eg_link, stream=True)
1050
+ with tqdm.wrapattr(open(os.devnull, "wb"), "write",
1051
+ miniters=1, desc=eg_link.split('/')[-1],
1052
+ total=int(response.headers.get('content-length', 0))) as fout:
1053
+ for chunk in response.iter_content(chunk_size=4096):
1054
+ fout.write(chunk)
1055
+
1056
+ **Custom callback**
1057
+
1058
+ ``tqdm`` is known for intelligently skipping unnecessary displays. To make a
1059
+ custom callback take advantage of this, simply use the return value of
1060
+ ``update()``. This is set to ``True`` if a ``display()`` was triggered.
1061
+
1062
+ .. code:: python
1063
+
1064
+ from tqdm.auto import tqdm as std_tqdm
1065
+
1066
+ def external_callback(*args, **kwargs):
1067
+ ...
1068
+
1069
+ class TqdmExt(std_tqdm):
1070
+ def update(self, n=1):
1071
+ displayed = super().update(n)
1072
+ if displayed:
1073
+ external_callback(**self.format_dict)
1074
+ return displayed
1075
+
1076
+ ``asyncio``
1077
+ ~~~~~~~~~~~
1078
+
1079
+ Note that ``break`` isn't currently caught by asynchronous iterators.
1080
+ This means that ``tqdm`` cannot clean up after itself in this case:
1081
+
1082
+ .. code:: python
1083
+
1084
+ from tqdm.asyncio import tqdm
1085
+
1086
+ async for i in tqdm(range(9)):
1087
+ if i == 2:
1088
+ break
1089
+
1090
+ Instead, either call ``pbar.close()`` manually or use the context manager syntax:
1091
+
1092
+ .. code:: python
1093
+
1094
+ from tqdm.asyncio import tqdm
1095
+
1096
+ with tqdm(range(9)) as pbar:
1097
+ async for i in pbar:
1098
+ if i == 2:
1099
+ break
1100
+
1101
+ Pandas Integration
1102
+ ~~~~~~~~~~~~~~~~~~
1103
+
1104
+ Due to popular demand we've added support for ``pandas`` -- here's an example
1105
+ for ``DataFrame.progress_apply`` and ``DataFrameGroupBy.progress_apply``:
1106
+
1107
+ .. code:: python
1108
+
1109
+ import pandas as pd
1110
+ import numpy as np
1111
+ from tqdm import tqdm
1112
+
1113
+ df = pd.DataFrame(np.random.randint(0, 100, (100000, 6)))
1114
+
1115
+ # Register `pandas.progress_apply` and `pandas.Series.map_apply` with `tqdm`
1116
+ # (can use `tqdm.gui.tqdm`, `tqdm.notebook.tqdm`, optional kwargs, etc.)
1117
+ tqdm.pandas(desc="my bar!")
1118
+
1119
+ # Now you can use `progress_apply` instead of `apply`
1120
+ # and `progress_map` instead of `map`
1121
+ df.progress_apply(lambda x: x**2)
1122
+ # can also groupby:
1123
+ # df.groupby(0).progress_apply(lambda x: x**2)
1124
+
1125
+ In case you're interested in how this works (and how to modify it for your
1126
+ own callbacks), see the
1127
+ `examples <https://github.com/tqdm/tqdm/tree/master/examples>`__
1128
+ folder or import the module and run ``help()``.
1129
+
1130
+ Keras Integration
1131
+ ~~~~~~~~~~~~~~~~~
1132
+
1133
+ A ``keras`` callback is also available:
1134
+
1135
+ .. code:: python
1136
+
1137
+ from tqdm.keras import TqdmCallback
1138
+
1139
+ ...
1140
+
1141
+ model.fit(..., verbose=0, callbacks=[TqdmCallback()])
1142
+
1143
+ Dask Integration
1144
+ ~~~~~~~~~~~~~~~~
1145
+
1146
+ A ``dask`` callback is also available:
1147
+
1148
+ .. code:: python
1149
+
1150
+ from tqdm.dask import TqdmCallback
1151
+
1152
+ with TqdmCallback(desc="compute"):
1153
+ ...
1154
+ arr.compute()
1155
+
1156
+ # or use callback globally
1157
+ cb = TqdmCallback(desc="global")
1158
+ cb.register()
1159
+ arr.compute()
1160
+
1161
+ IPython/Jupyter Integration
1162
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1163
+
1164
+ IPython/Jupyter is supported via the ``tqdm.notebook`` submodule:
1165
+
1166
+ .. code:: python
1167
+
1168
+ from tqdm.notebook import trange, tqdm
1169
+ from time import sleep
1170
+
1171
+ for i in trange(3, desc='1st loop'):
1172
+ for j in tqdm(range(100), desc='2nd loop'):
1173
+ sleep(0.01)
1174
+
1175
+ In addition to ``tqdm`` features, the submodule provides a native Jupyter
1176
+ widget (compatible with IPython v1-v4 and Jupyter), fully working nested bars
1177
+ and colour hints (blue: normal, green: completed, red: error/interrupt,
1178
+ light blue: no ETA); as demonstrated below.
1179
+
1180
+ |Screenshot-Jupyter1|
1181
+ |Screenshot-Jupyter2|
1182
+ |Screenshot-Jupyter3|
1183
+
1184
+ The ``notebook`` version supports percentage or pixels for overall width
1185
+ (e.g.: ``ncols='100%'`` or ``ncols='480px'``).
1186
+
1187
+ It is also possible to let ``tqdm`` automatically choose between
1188
+ console or notebook versions by using the ``autonotebook`` submodule:
1189
+
1190
+ .. code:: python
1191
+
1192
+ from tqdm.autonotebook import tqdm
1193
+ tqdm.pandas()
1194
+
1195
+ Note that this will issue a ``TqdmExperimentalWarning`` if run in a notebook
1196
+ since it is not meant to be possible to distinguish between ``jupyter notebook``
1197
+ and ``jupyter console``. Use ``auto`` instead of ``autonotebook`` to suppress
1198
+ this warning.
1199
+
1200
+ Note that notebooks will display the bar in the cell where it was created.
1201
+ This may be a different cell from the one where it is used.
1202
+ If this is not desired, either
1203
+
1204
+ - delay the creation of the bar to the cell where it must be displayed, or
1205
+ - create the bar with ``display=False``, and in a later cell call
1206
+ ``display(bar.container)``:
1207
+
1208
+ .. code:: python
1209
+
1210
+ from tqdm.notebook import tqdm
1211
+ pbar = tqdm(..., display=False)
1212
+
1213
+ .. code:: python
1214
+
1215
+ # different cell
1216
+ display(pbar.container)
1217
+
1218
+ The ``keras`` callback has a ``display()`` method which can be used likewise:
1219
+
1220
+ .. code:: python
1221
+
1222
+ from tqdm.keras import TqdmCallback
1223
+ cbk = TqdmCallback(display=False)
1224
+
1225
+ .. code:: python
1226
+
1227
+ # different cell
1228
+ cbk.display()
1229
+ model.fit(..., verbose=0, callbacks=[cbk])
1230
+
1231
+ Another possibility is to have a single bar (near the top of the notebook)
1232
+ which is constantly re-used (using ``reset()`` rather than ``close()``).
1233
+ For this reason, the notebook version (unlike the CLI version) does not
1234
+ automatically call ``close()`` upon ``Exception``.
1235
+
1236
+ .. code:: python
1237
+
1238
+ from tqdm.notebook import tqdm
1239
+ pbar = tqdm()
1240
+
1241
+ .. code:: python
1242
+
1243
+ # different cell
1244
+ iterable = range(100)
1245
+ pbar.reset(total=len(iterable)) # initialise with new `total`
1246
+ for i in iterable:
1247
+ pbar.update()
1248
+ pbar.refresh() # force print final status but don't `close()`
1249
+
1250
+ Custom Integration
1251
+ ~~~~~~~~~~~~~~~~~~
1252
+
1253
+ To change the default arguments (such as making ``dynamic_ncols=True``),
1254
+ simply use built-in Python magic:
1255
+
1256
+ .. code:: python
1257
+
1258
+ from functools import partial
1259
+ from tqdm import tqdm as std_tqdm
1260
+ tqdm = partial(std_tqdm, dynamic_ncols=True)
1261
+
1262
+ For further customisation,
1263
+ ``tqdm`` may be inherited from to create custom callbacks (as with the
1264
+ ``TqdmUpTo`` example `above <#hooks-and-callbacks>`__) or for custom frontends
1265
+ (e.g. GUIs such as notebook or plotting packages). In the latter case:
1266
+
1267
+ 1. ``def __init__()`` to call ``super().__init__(..., gui=True)`` to disable
1268
+ terminal ``status_printer`` creation.
1269
+ 2. Redefine: ``close()``, ``clear()``, ``display()``.
1270
+
1271
+ Consider overloading ``display()`` to use e.g.
1272
+ ``self.frontend(**self.format_dict)`` instead of ``self.sp(repr(self))``.
1273
+
1274
+ Some submodule examples of inheritance:
1275
+
1276
+ - `tqdm/notebook.py <https://github.com/tqdm/tqdm/blob/master/tqdm/notebook.py>`__
1277
+ - `tqdm/gui.py <https://github.com/tqdm/tqdm/blob/master/tqdm/gui.py>`__
1278
+ - `tqdm/tk.py <https://github.com/tqdm/tqdm/blob/master/tqdm/tk.py>`__
1279
+ - `tqdm/contrib/slack.py <https://github.com/tqdm/tqdm/blob/master/tqdm/contrib/slack.py>`__
1280
+ - `tqdm/contrib/discord.py <https://github.com/tqdm/tqdm/blob/master/tqdm/contrib/discord.py>`__
1281
+ - `tqdm/contrib/telegram.py <https://github.com/tqdm/tqdm/blob/master/tqdm/contrib/telegram.py>`__
1282
+
1283
+ Dynamic Monitor/Meter
1284
+ ~~~~~~~~~~~~~~~~~~~~~
1285
+
1286
+ You can use a ``tqdm`` as a meter which is not monotonically increasing.
1287
+ This could be because ``n`` decreases (e.g. a CPU usage monitor) or ``total``
1288
+ changes.
1289
+
1290
+ One example would be recursively searching for files. The ``total`` is the
1291
+ number of objects found so far, while ``n`` is the number of those objects which
1292
+ are files (rather than folders):
1293
+
1294
+ .. code:: python
1295
+
1296
+ from tqdm import tqdm
1297
+ import os.path
1298
+
1299
+ def find_files_recursively(path, show_progress=True):
1300
+ files = []
1301
+ # total=1 assumes `path` is a file
1302
+ t = tqdm(total=1, unit="file", disable=not show_progress)
1303
+ if not os.path.exists(path):
1304
+ raise IOError("Cannot find:" + path)
1305
+
1306
+ def append_found_file(f):
1307
+ files.append(f)
1308
+ t.update()
1309
+
1310
+ def list_found_dir(path):
1311
+ """returns os.listdir(path) assuming os.path.isdir(path)"""
1312
+ listing = os.listdir(path)
1313
+ # subtract 1 since a "file" we found was actually this directory
1314
+ t.total += len(listing) - 1
1315
+ # fancy way to give info without forcing a refresh
1316
+ t.set_postfix(dir=path[-10:], refresh=False)
1317
+ t.update(0) # may trigger a refresh
1318
+ return listing
1319
+
1320
+ def recursively_search(path):
1321
+ if os.path.isdir(path):
1322
+ for f in list_found_dir(path):
1323
+ recursively_search(os.path.join(path, f))
1324
+ else:
1325
+ append_found_file(path)
1326
+
1327
+ recursively_search(path)
1328
+ t.set_postfix(dir=path)
1329
+ t.close()
1330
+ return files
1331
+
1332
+ Using ``update(0)`` is a handy way to let ``tqdm`` decide when to trigger a
1333
+ display refresh to avoid console spamming.
1334
+
1335
+ Writing messages
1336
+ ~~~~~~~~~~~~~~~~
1337
+
1338
+ This is a work in progress (see
1339
+ `#737 <https://github.com/tqdm/tqdm/issues/737>`__).
1340
+
1341
+ Since ``tqdm`` uses a simple printing mechanism to display progress bars,
1342
+ you should not write any message in the terminal using ``print()`` while
1343
+ a progressbar is open.
1344
+
1345
+ To write messages in the terminal without any collision with ``tqdm`` bar
1346
+ display, a ``.write()`` method is provided:
1347
+
1348
+ .. code:: python
1349
+
1350
+ from tqdm.auto import tqdm, trange
1351
+ from time import sleep
1352
+
1353
+ bar = trange(10)
1354
+ for i in bar:
1355
+ # Print using tqdm class method .write()
1356
+ sleep(0.1)
1357
+ if not (i % 3):
1358
+ tqdm.write("Done task %i" % i)
1359
+ # Can also use bar.write()
1360
+
1361
+ By default, this will print to standard output ``sys.stdout``. but you can
1362
+ specify any file-like object using the ``file`` argument. For example, this
1363
+ can be used to redirect the messages writing to a log file or class.
1364
+
1365
+ Redirecting writing
1366
+ ~~~~~~~~~~~~~~~~~~~
1367
+
1368
+ If using a library that can print messages to the console, editing the library
1369
+ by replacing ``print()`` with ``tqdm.write()`` may not be desirable.
1370
+ In that case, redirecting ``sys.stdout`` to ``tqdm.write()`` is an option.
1371
+
1372
+ To redirect ``sys.stdout``, create a file-like class that will write
1373
+ any input string to ``tqdm.write()``, and supply the arguments
1374
+ ``file=sys.stdout, dynamic_ncols=True``.
1375
+
1376
+ A reusable canonical example is given below:
1377
+
1378
+ .. code:: python
1379
+
1380
+ from time import sleep
1381
+ import contextlib
1382
+ import sys
1383
+ from tqdm import tqdm
1384
+ from tqdm.contrib import DummyTqdmFile
1385
+
1386
+
1387
+ @contextlib.contextmanager
1388
+ def std_out_err_redirect_tqdm():
1389
+ orig_out_err = sys.stdout, sys.stderr
1390
+ try:
1391
+ sys.stdout, sys.stderr = map(DummyTqdmFile, orig_out_err)
1392
+ yield orig_out_err[0]
1393
+ # Relay exceptions
1394
+ except Exception as exc:
1395
+ raise exc
1396
+ # Always restore sys.stdout/err if necessary
1397
+ finally:
1398
+ sys.stdout, sys.stderr = orig_out_err
1399
+
1400
+ def some_fun(i):
1401
+ print("Fee, fi, fo,".split()[i])
1402
+
1403
+ # Redirect stdout to tqdm.write() (don't forget the `as save_stdout`)
1404
+ with std_out_err_redirect_tqdm() as orig_stdout:
1405
+ # tqdm needs the original stdout
1406
+ # and dynamic_ncols=True to autodetect console width
1407
+ for i in tqdm(range(3), file=orig_stdout, dynamic_ncols=True):
1408
+ sleep(.5)
1409
+ some_fun(i)
1410
+
1411
+ # After the `with`, printing is restored
1412
+ print("Done!")
1413
+
1414
+ Redirecting ``logging``
1415
+ ~~~~~~~~~~~~~~~~~~~~~~~
1416
+
1417
+ Similar to ``sys.stdout``/``sys.stderr`` as detailed above, console ``logging``
1418
+ may also be redirected to ``tqdm.write()``.
1419
+
1420
+ Warning: if also redirecting ``sys.stdout``/``sys.stderr``, make sure to
1421
+ redirect ``logging`` first if needed.
1422
+
1423
+ Helper methods are available in ``tqdm.contrib.logging``. For example:
1424
+
1425
+ .. code:: python
1426
+
1427
+ import logging
1428
+ from tqdm import trange
1429
+ from tqdm.contrib.logging import logging_redirect_tqdm
1430
+
1431
+ LOG = logging.getLogger(__name__)
1432
+
1433
+ if __name__ == '__main__':
1434
+ logging.basicConfig(level=logging.INFO)
1435
+ with logging_redirect_tqdm():
1436
+ for i in trange(9):
1437
+ if i == 4:
1438
+ LOG.info("console logging redirected to `tqdm.write()`")
1439
+ # logging restored
1440
+
1441
+ Monitoring thread, intervals and miniters
1442
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1443
+
1444
+ ``tqdm`` implements a few tricks to increase efficiency and reduce overhead.
1445
+
1446
+ - Avoid unnecessary frequent bar refreshing: ``mininterval`` defines how long
1447
+ to wait between each refresh. ``tqdm`` always gets updated in the background,
1448
+ but it will display only every ``mininterval``.
1449
+ - Reduce number of calls to check system clock/time.
1450
+ - ``mininterval`` is more intuitive to configure than ``miniters``.
1451
+ A clever adjustment system ``dynamic_miniters`` will automatically adjust
1452
+ ``miniters`` to the amount of iterations that fit into time ``mininterval``.
1453
+ Essentially, ``tqdm`` will check if it's time to print without actually
1454
+ checking time. This behaviour can be still be bypassed by manually setting
1455
+ ``miniters``.
1456
+
1457
+ However, consider a case with a combination of fast and slow iterations.
1458
+ After a few fast iterations, ``dynamic_miniters`` will set ``miniters`` to a
1459
+ large number. When iteration rate subsequently slows, ``miniters`` will
1460
+ remain large and thus reduce display update frequency. To address this:
1461
+
1462
+ - ``maxinterval`` defines the maximum time between display refreshes.
1463
+ A concurrent monitoring thread checks for overdue updates and forces one
1464
+ where necessary.
1465
+
1466
+ The monitoring thread should not have a noticeable overhead, and guarantees
1467
+ updates at least every 10 seconds by default.
1468
+ This value can be directly changed by setting the ``monitor_interval`` of
1469
+ any ``tqdm`` instance (i.e. ``t = tqdm.tqdm(...); t.monitor_interval = 2``).
1470
+ The monitor thread may be disabled application-wide by setting
1471
+ ``tqdm.tqdm.monitor_interval = 0`` before instantiation of any ``tqdm`` bar.
1472
+
1473
+
1474
+ Merch
1475
+ -----
1476
+
1477
+ You can buy `tqdm branded merch <https://tqdm.github.io/merch>`__ now!
1478
+
1479
+ Contributions
1480
+ -------------
1481
+
1482
+ |GitHub-Commits| |GitHub-Issues| |GitHub-PRs| |OpenHub-Status| |GitHub-Contributions| |CII Best Practices|
1483
+
1484
+ All source code is hosted on `GitHub <https://github.com/tqdm/tqdm>`__.
1485
+ Contributions are welcome.
1486
+
1487
+ See the
1488
+ `CONTRIBUTING <https://github.com/tqdm/tqdm/blob/master/CONTRIBUTING.md>`__
1489
+ file for more information.
1490
+
1491
+ Developers who have made significant contributions, ranked by *SLoC*
1492
+ (surviving lines of code,
1493
+ `git fame <https://github.com/casperdcl/git-fame>`__ ``-wMC --excl '\.(png|gif|jpg)$'``),
1494
+ are:
1495
+
1496
+ ==================== ======================================================== ==== ================================
1497
+ Name ID SLoC Notes
1498
+ ==================== ======================================================== ==== ================================
1499
+ Casper da Costa-Luis `casperdcl <https://github.com/casperdcl>`__ ~80% primary maintainer |Gift-Casper|
1500
+ Stephen Larroque `lrq3000 <https://github.com/lrq3000>`__ ~9% team member
1501
+ Martin Zugnoni `martinzugnoni <https://github.com/martinzugnoni>`__ ~3%
1502
+ Daniel Ecer `de-code <https://github.com/de-code>`__ ~2%
1503
+ Richard Sheridan `richardsheridan <https://github.com/richardsheridan>`__ ~1%
1504
+ Guangshuo Chen `chengs <https://github.com/chengs>`__ ~1%
1505
+ Helio Machado `0x2b3bfa0 <https://github.com/0x2b3bfa0>`__ ~1%
1506
+ Kyle Altendorf `altendky <https://github.com/altendky>`__ <1%
1507
+ Noam Yorav-Raphael `noamraph <https://github.com/noamraph>`__ <1% original author
1508
+ Matthew Stevens `mjstevens777 <https://github.com/mjstevens777>`__ <1%
1509
+ Hadrien Mary `hadim <https://github.com/hadim>`__ <1% team member
1510
+ Mikhail Korobov `kmike <https://github.com/kmike>`__ <1% team member
1511
+ ==================== ======================================================== ==== ================================
1512
+
1513
+ Ports to Other Languages
1514
+ ~~~~~~~~~~~~~~~~~~~~~~~~
1515
+
1516
+ A list is available on
1517
+ `this wiki page <https://github.com/tqdm/tqdm/wiki/tqdm-ports>`__.
1518
+
1519
+
1520
+ LICENCE
1521
+ -------
1522
+
1523
+ Open Source (OSI approved): |LICENCE|
1524
+
1525
+ Citation information: |DOI|
1526
+
1527
+ |README-Hits| (Since 19 May 2016)
1528
+
1529
+ .. |Logo| image:: https://tqdm.github.io/img/logo.gif
1530
+ .. |Screenshot| image:: https://tqdm.github.io/img/tqdm.gif
1531
+ .. |Video| image:: https://tqdm.github.io/img/video.jpg
1532
+ :target: https://tqdm.github.io/video
1533
+ .. |Slides| image:: https://tqdm.github.io/img/slides.jpg
1534
+ :target: https://tqdm.github.io/PyData2019/slides.html
1535
+ .. |Merch| image:: https://tqdm.github.io/img/merch.jpg
1536
+ :target: https://tqdm.github.io/merch
1537
+ .. |Build-Status| image:: https://img.shields.io/github/actions/workflow/status/tqdm/tqdm/test.yml?branch=master&label=tqdm&logo=GitHub
1538
+ :target: https://github.com/tqdm/tqdm/actions/workflows/test.yml
1539
+ .. |Coverage-Status| image:: https://img.shields.io/coveralls/github/tqdm/tqdm/master?logo=coveralls
1540
+ :target: https://coveralls.io/github/tqdm/tqdm
1541
+ .. |Branch-Coverage-Status| image:: https://codecov.io/gh/tqdm/tqdm/branch/master/graph/badge.svg
1542
+ :target: https://codecov.io/gh/tqdm/tqdm
1543
+ .. |Codacy-Grade| image:: https://app.codacy.com/project/badge/Grade/3f965571598f44549c7818f29cdcf177
1544
+ :target: https://www.codacy.com/gh/tqdm/tqdm/dashboard
1545
+ .. |CII Best Practices| image:: https://bestpractices.coreinfrastructure.org/projects/3264/badge
1546
+ :target: https://bestpractices.coreinfrastructure.org/projects/3264
1547
+ .. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=86400&logo=github&logoColor=white
1548
+ :target: https://github.com/tqdm/tqdm/releases
1549
+ .. |GitHub-Forks| image:: https://img.shields.io/github/forks/tqdm/tqdm.svg?logo=github&logoColor=white
1550
+ :target: https://github.com/tqdm/tqdm/network
1551
+ .. |GitHub-Stars| image:: https://img.shields.io/github/stars/tqdm/tqdm.svg?logo=github&logoColor=white
1552
+ :target: https://github.com/tqdm/tqdm/stargazers
1553
+ .. |GitHub-Commits| image:: https://img.shields.io/github/commit-activity/y/tqdm/tqdm.svg?logo=git&logoColor=white
1554
+ :target: https://github.com/tqdm/tqdm/graphs/commit-activity
1555
+ .. |GitHub-Issues| image:: https://img.shields.io/github/issues-closed/tqdm/tqdm.svg?logo=github&logoColor=white
1556
+ :target: https://github.com/tqdm/tqdm/issues?q=
1557
+ .. |GitHub-PRs| image:: https://img.shields.io/github/issues-pr-closed/tqdm/tqdm.svg?logo=github&logoColor=white
1558
+ :target: https://github.com/tqdm/tqdm/pulls
1559
+ .. |GitHub-Contributions| image:: https://img.shields.io/github/contributors/tqdm/tqdm.svg?logo=github&logoColor=white
1560
+ :target: https://github.com/tqdm/tqdm/graphs/contributors
1561
+ .. |GitHub-Updated| image:: https://img.shields.io/github/last-commit/tqdm/tqdm/master.svg?logo=github&logoColor=white&label=pushed
1562
+ :target: https://github.com/tqdm/tqdm/pulse
1563
+ .. |Gift-Casper| image:: https://img.shields.io/badge/dynamic/json.svg?color=ff69b4&label=gifts%20received&prefix=%C2%A3&query=%24..sum&url=https%3A%2F%2Fcaspersci.uk.to%2Fgifts.json
1564
+ :target: https://cdcl.ml/sponsor
1565
+ .. |Versions| image:: https://img.shields.io/pypi/v/tqdm.svg
1566
+ :target: https://tqdm.github.io/releases
1567
+ .. |PyPI-Downloads| image:: https://img.shields.io/pypi/dm/tqdm.svg?label=pypi%20downloads&logo=PyPI&logoColor=white
1568
+ :target: https://pepy.tech/project/tqdm
1569
+ .. |Py-Versions| image:: https://img.shields.io/pypi/pyversions/tqdm.svg?logo=python&logoColor=white
1570
+ :target: https://pypi.org/project/tqdm
1571
+ .. |Conda-Forge-Status| image:: https://img.shields.io/conda/v/conda-forge/tqdm.svg?label=conda-forge&logo=conda-forge
1572
+ :target: https://anaconda.org/conda-forge/tqdm
1573
+ .. |Snapcraft| image:: https://img.shields.io/badge/snap-install-82BEA0.svg?logo=snapcraft
1574
+ :target: https://snapcraft.io/tqdm
1575
+ .. |Docker| image:: https://img.shields.io/badge/docker-pull-blue.svg?logo=docker&logoColor=white
1576
+ :target: https://hub.docker.com/r/tqdm/tqdm
1577
+ .. |Libraries-Rank| image:: https://img.shields.io/librariesio/sourcerank/pypi/tqdm.svg?logo=koding&logoColor=white
1578
+ :target: https://libraries.io/pypi/tqdm
1579
+ .. |Libraries-Dependents| image:: https://img.shields.io/librariesio/dependent-repos/pypi/tqdm.svg?logo=koding&logoColor=white
1580
+ :target: https://github.com/tqdm/tqdm/network/dependents
1581
+ .. |OpenHub-Status| image:: https://www.openhub.net/p/tqdm/widgets/project_thin_badge?format=gif
1582
+ :target: https://www.openhub.net/p/tqdm?ref=Thin+badge
1583
+ .. |awesome-python| image:: https://awesome.re/mentioned-badge.svg
1584
+ :target: https://github.com/vinta/awesome-python
1585
+ .. |LICENCE| image:: https://img.shields.io/pypi/l/tqdm.svg
1586
+ :target: https://raw.githubusercontent.com/tqdm/tqdm/master/LICENCE
1587
+ .. |DOI| image:: https://img.shields.io/badge/DOI-10.5281/zenodo.595120-blue.svg
1588
+ :target: https://doi.org/10.5281/zenodo.595120
1589
+ .. |binder-demo| image:: https://mybinder.org/badge_logo.svg
1590
+ :target: https://mybinder.org/v2/gh/tqdm/tqdm/master?filepath=DEMO.ipynb
1591
+ .. |Screenshot-Jupyter1| image:: https://tqdm.github.io/img/jupyter-1.gif
1592
+ .. |Screenshot-Jupyter2| image:: https://tqdm.github.io/img/jupyter-2.gif
1593
+ .. |Screenshot-Jupyter3| image:: https://tqdm.github.io/img/jupyter-3.gif
1594
+ .. |README-Hits| image:: https://cgi.cdcl.ml/hits?q=tqdm&style=social&r=https://github.com/tqdm/tqdm&l=https://tqdm.github.io/img/favicon.png&f=https://tqdm.github.io/img/logo.gif
1595
+ :target: https://cgi.cdcl.ml/hits?q=tqdm&a=plot&r=https://github.com/tqdm/tqdm&l=https://tqdm.github.io/img/favicon.png&f=https://tqdm.github.io/img/logo.gif&style=social
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/RECORD ADDED
@@ -0,0 +1,42 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ../../Scripts/tqdm.exe,sha256=RG_4zE2u6L146hZTVUPNSIG9T4jaUsvNMijcABEQSX4,46080
2
+ tqdm-4.67.3.dist-info/INSTALLER,sha256=5hhM4Q4mYTT9z6QB6PGpUAW81PGNFrYrdXMj4oM_6ak,2
3
+ tqdm-4.67.3.dist-info/METADATA,sha256=fA6aZiwZCV8zmkt2EgHrBs_5xh-5WBU1svlvROcY7Sk,57679
4
+ tqdm-4.67.3.dist-info/RECORD,,
5
+ tqdm-4.67.3.dist-info/REQUESTED,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
6
+ tqdm-4.67.3.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
7
+ tqdm-4.67.3.dist-info/entry_points.txt,sha256=ReJCH7Ui3Zyh6M16E4OhsZ1oU7WtMXCfbtoyBhGO29Y,39
8
+ tqdm-4.67.3.dist-info/licenses/LICENCE,sha256=_P-Hw6R86AKKhRKqGC1PzwrRyQVE7nXPmzQ2hMrBlN4,1985
9
+ tqdm-4.67.3.dist-info/top_level.txt,sha256=NLiUJNfmc9At15s7JURiwvqMEjUi9G5PMGRrmMYzNSM,5
10
+ tqdm/__init__.py,sha256=9mQNYSSqP99JasubEC1POJLMmhkkBH6cJZxPIR5G2pQ,1572
11
+ tqdm/__main__.py,sha256=bYt9eEaoRQWdejEHFD8REx9jxVEdZptECFsV7F49Ink,30
12
+ tqdm/_main.py,sha256=9ySvgmi_2Sw4CAo5UDW0Q2dxfTryboEWGHohfCJz0sA,283
13
+ tqdm/_monitor.py,sha256=Uku-DPWgzJ7dO5CK08xKJK-E_F6qQ-JB3ksuXczSYR0,3699
14
+ tqdm/_tqdm.py,sha256=LfLCuJ6bpsVo9xilmtBXyEm1vGnUCFrliW85j3J-nD4,283
15
+ tqdm/_tqdm_gui.py,sha256=03Hc8KayxJveieI5-0-2NGiDpLvw9jZekofJUV7CCwk,287
16
+ tqdm/_tqdm_notebook.py,sha256=BuHiLuxu6uEfZFaPJW3RPpPaxaVctEQA3kdSJSDL1hw,307
17
+ tqdm/_tqdm_pandas.py,sha256=c9jptUgigN6axRDhRd4Rif98Tmxeopc1nFNFhIpbFUE,888
18
+ tqdm/_utils.py,sha256=_4E73bfDj4f1s3sM42NLHNrZDOkijZoWq-n6xWLkdZ8,553
19
+ tqdm/asyncio.py,sha256=Kp2rSkNRf9KRqa3d9YpgeZQ7L7EZf2Ki4bSc7UPIyoo,2757
20
+ tqdm/auto.py,sha256=nDZflj6p2zKkjBCNBourrhS81zYfZy1_dQvbckrdW8o,871
21
+ tqdm/autonotebook.py,sha256=Yb9F5uaiBPhfbDDFpbtoG8I2YUw3uQJ89rUDLbfR6ws,956
22
+ tqdm/cli.py,sha256=orEaahqDEBGZR1uCcTW8BkhSPEhBlSO0BKYbJ1Qgc6k,10994
23
+ tqdm/completion.sh,sha256=j79KbSmpIj_E11jfTfBXrGnUTzKXVpQ1vGVQvsyDRl4,946
24
+ tqdm/contrib/__init__.py,sha256=1GMYYE866WCvlHg5MdmzOvPsQj4ZuMlXzz8xcRcJD60,2479
25
+ tqdm/contrib/bells.py,sha256=Yx1HqGCmHrESCAO700j5wE__JCleNODJxedh1ijPLD0,837
26
+ tqdm/contrib/concurrent.py,sha256=K1yjloKS5WRNFyjLRth0DmU5PAnDbF0A-GD27N-J4a8,3986
27
+ tqdm/contrib/discord.py,sha256=MtVIL1s_dxH21G4sL8FBgQ4Wei23ho9Ek5T-AommvNc,5243
28
+ tqdm/contrib/itertools.py,sha256=WdKKQU5eSzsqHu29SN_oH12huYZo0Jihqoi9-nVhwz4,774
29
+ tqdm/contrib/logging.py,sha256=NsYtnKttj2mMrGm58mEdo5a9DP_2vv8pZyrimSuWulA,3760
30
+ tqdm/contrib/slack.py,sha256=eP_Mr5sQonYniHxxQNGue3jk2JkIPmPWFZqIYxnOui0,4007
31
+ tqdm/contrib/telegram.py,sha256=vn_9SATMbbwn2PAbzSDyOX6av3eBB01QBug11P4H-Og,5008
32
+ tqdm/contrib/utils_worker.py,sha256=vaxyJyagYwOCQXLUMd86bCbI4sPqZysuMGbDSGmvEWo,1199
33
+ tqdm/dask.py,sha256=9Ei58eVqTossRLhAfWyUFCduXYKjmLmwkaXIy-CHYfs,1319
34
+ tqdm/gui.py,sha256=STIB3K8iDzDgkNUqWIpvcI_u0OGtbGNy5NwpALXhfWs,5479
35
+ tqdm/keras.py,sha256=op9sBkb6q6c6dw2wJ0SD2ZwpPK7yM1Vbg4l1Qiy3MIo,4373
36
+ tqdm/notebook.py,sha256=scgzRQmDYzIFag_1gRh98LhtZdu3ig2yrmZdqvlgops,10802
37
+ tqdm/rich.py,sha256=YyMPkEHVyYUVUR3adJKbVX26iTmNKpNMf3DEqmm-m60,5021
38
+ tqdm/std.py,sha256=Sk24SwOd59hpNbb0UL8Y3_8ueRmL3_5O72Vy2XKasjE,57510
39
+ tqdm/tk.py,sha256=Gu0uwXwLCGPRGHORdi3WvBLGiseUp_xxX_h_gp9VpK0,6701
40
+ tqdm/tqdm.1,sha256=cDyo6hSykXedJ3Pcx5tkogR1ai3QXRnrJ0MbR2Gd9-s,7581
41
+ tqdm/utils.py,sha256=dpGZUeqoLPinM-kEsULTSe2E3jzp8wUunL6eKzkYOgk,11810
42
+ tqdm/version.py,sha256=oBM1eCOTDZDGZHffNqlehXTeQdKdracckNAEaMRmPjM,337
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/REQUESTED ADDED
File without changes
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/WHEEL ADDED
@@ -0,0 +1,5 @@
 
 
 
 
 
 
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (80.10.2)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/entry_points.txt ADDED
@@ -0,0 +1,2 @@
 
 
 
1
+ [console_scripts]
2
+ tqdm = tqdm.cli:main
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/licenses/LICENCE ADDED
@@ -0,0 +1,49 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ `tqdm` is a product of collaborative work.
2
+ Unless otherwise stated, all authors (see commit logs) retain copyright
3
+ for their respective work, and release the work under the MIT licence
4
+ (text below).
5
+
6
+ Exceptions or notable authors are listed below
7
+ in reverse chronological order:
8
+
9
+ * files: *
10
+ MPL-2.0 2015-2026 (c) Casper da Costa-Luis
11
+ [casperdcl](https://github.com/casperdcl).
12
+ * files: tqdm/_tqdm.py
13
+ MIT 2016 (c) [PR #96] on behalf of Google Inc.
14
+ * files: tqdm/_tqdm.py README.rst .gitignore
15
+ MIT 2013 (c) Noam Yorav-Raphael, original author.
16
+
17
+ [PR #96]: https://github.com/tqdm/tqdm/pull/96
18
+
19
+
20
+ Mozilla Public Licence (MPL) v. 2.0 - Exhibit A
21
+ -----------------------------------------------
22
+
23
+ This Source Code Form is subject to the terms of the
24
+ Mozilla Public License, v. 2.0.
25
+ If a copy of the MPL was not distributed with this project,
26
+ You can obtain one at https://mozilla.org/MPL/2.0/.
27
+
28
+
29
+ MIT License (MIT)
30
+ -----------------
31
+
32
+ Copyright (c) 2013 noamraph
33
+
34
+ Permission is hereby granted, free of charge, to any person obtaining a copy of
35
+ this software and associated documentation files (the "Software"), to deal in
36
+ the Software without restriction, including without limitation the rights to
37
+ use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
38
+ the Software, and to permit persons to whom the Software is furnished to do so,
39
+ subject to the following conditions:
40
+
41
+ The above copyright notice and this permission notice shall be included in all
42
+ copies or substantial portions of the Software.
43
+
44
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
45
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
46
+ FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
47
+ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
48
+ IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
49
+ CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
loan-advisor-agent/.venv/Lib/site-packages/tqdm-4.67.3.dist-info/top_level.txt ADDED
@@ -0,0 +1 @@
 
 
1
+ tqdm