Hello community, here is the log from the commit of package python-tqdm for openSUSE:Factory checked in at 2017-12-11 18:57:16 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Comparing /work/SRC/openSUSE:Factory/python-tqdm (Old) and /work/SRC/openSUSE:Factory/.python-tqdm.new (New) ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
Package is "python-tqdm" Mon Dec 11 18:57:16 2017 rev:6 rq:555843 version:4.19.5 Changes: -------- --- /work/SRC/openSUSE:Factory/python-tqdm/python-tqdm.changes 2017-11-08 15:10:16.629733700 +0100 +++ /work/SRC/openSUSE:Factory/.python-tqdm.new/python-tqdm.changes 2017-12-11 18:57:21.640110517 +0100 @@ -1,0 +2,9 @@ +Sun Dec 10 19:59:12 UTC 2017 - [email protected] + +- update to version 4.19.5: + * multiprocess/lock fixes (#457) + * set_description in notebook (#345 -> #475) + * minor tidy (#476) + * documentation updates + +------------------------------------------------------------------- Old: ---- tqdm-4.19.4.tar.gz New: ---- tqdm-4.19.5.tar.gz ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ Other differences: ------------------ ++++++ python-tqdm.spec ++++++ --- /var/tmp/diff_new_pack.1Je3rU/_old 2017-12-11 18:57:22.400074320 +0100 +++ /var/tmp/diff_new_pack.1Je3rU/_new 2017-12-11 18:57:22.400074320 +0100 @@ -20,7 +20,7 @@ %{?!python_module:%define python_module() python-%{**} python3-%{**}} %bcond_without test Name: python-tqdm -Version: 4.19.4 +Version: 4.19.5 Release: 0 Summary: An extensible progress meter License: MPL-2.0 and MIT ++++++ tqdm-4.19.4.tar.gz -> tqdm-4.19.5.tar.gz ++++++ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/LICENCE new/tqdm-4.19.5/LICENCE --- old/tqdm-4.19.4/LICENCE 2017-09-21 01:32:52.000000000 +0200 +++ new/tqdm-4.19.5/LICENCE 2017-12-10 19:21:44.000000000 +0100 @@ -6,11 +6,15 @@ Exceptions or notable authors are listed below in reverse chronological order: -* MPLv2.0 (text below) 2015-2016 (c) Casper da Costa-Luis +* files: * + MPLv2.0 2015-2017 (c) Casper da Costa-Luis [casperdcl](https://github.com/casperdcl). -* MIT 2016 (c) [PR #96] on behalf of Google Inc. +* files: tqdm/_tqdm.py + MIT 2016 (c) [PR #96] on behalf of Google Inc. +* files: tqdm/_tqdm.py setup.py README.rst MANIFEST.in .gitignore + MIT 2013 (c) Noam Yorav-Raphael, original author. - [PR #96]: https://github.com/tqdm/tqdm/pull/96 +[PR #96]: https://github.com/tqdm/tqdm/pull/96 Mozilla Public Licence (MPL) v. 2.0 - Exhibit A diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/PKG-INFO new/tqdm-4.19.5/PKG-INFO --- old/tqdm-4.19.4/PKG-INFO 2017-10-15 17:42:34.000000000 +0200 +++ new/tqdm-4.19.5/PKG-INFO 2017-12-10 19:57:05.000000000 +0100 @@ -1,6 +1,6 @@ Metadata-Version: 1.1 Name: tqdm -Version: 4.19.4 +Version: 4.19.5 Summary: Fast, Extensible Progress Meter Home-page: https://github.com/tqdm/tqdm Author: tqdm developers @@ -16,7 +16,7 @@ |Build-Status| |Coverage-Status| |Branch-Coverage-Status| |Codacy-Grade| - |DOI-URI| |LICENCE| + |DOI-URI| |LICENCE| |OpenHub-Status| ``tqdm`` means "progress" in Arabic (taqadum, تقدّم) @@ -90,7 +90,7 @@ Latest development release on GitHub ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - |GitHub-Status| |GitHub-Stars| |GitHub-Forks| + |GitHub-Status| |GitHub-Stars| |GitHub-Commits| |GitHub-Forks| Pull and install in the current directory: @@ -219,6 +219,8 @@ FAQ and Known Issues -------------------- + |GitHub-Issues| + The most common issues relate to excessive output on multiple lines, instead of a neat one-line progress bar. @@ -242,8 +244,7 @@ ``tqdm(zip(a, b))`` should be replaced with ``zip(tqdm(a), b)`` or even ``zip(tqdm(a), tqdm(b))``. - If you come across any other difficulties, browse/open issues - `here <https://github.com/tqdm/tqdm/issues?q=is%3Aissue>`__. + If you come across any other difficulties, browse and file |GitHub-Issues|. Documentation ------------- @@ -528,7 +529,7 @@ from time import sleep from tqdm import trange - from multiprocessing import Pool, freeze_support, Lock + from multiprocessing import Pool, freeze_support, RLock L = list(range(9)) @@ -543,7 +544,7 @@ freeze_support() # for Windows support p = Pool(len(L), # again, for Windows support - initializer=tqdm.set_lock, initargs=(Lock(),)) + initializer=tqdm.set_lock, initargs=(RLock(),)) p.map(progresser, L) print("\n" * (len(L) - 2)) @@ -749,12 +750,12 @@ A clever adjustment system ``dynamic_miniters`` will automatically adjust ``miniters`` to the amount of iterations that fit into time ``mininterval``. Essentially, ``tqdm`` will check if it's time to print without actually - checking time. This behavior can be still be bypassed by manually setting + checking time. This behaviour can be still be bypassed by manually setting ``miniters``. However, consider a case with a combination of fast and slow iterations. After a few fast iterations, ``dynamic_miniters`` will set ``miniters`` to a - large number. When interation rate subsequently slows, ``miniters`` will + large number. When iteration rate subsequently slows, ``miniters`` will remain large and thus reduce display update frequency. To address this: - ``maxinterval`` defines the maximum time between display refreshes. @@ -772,6 +773,8 @@ Contributions ------------- + |GitHub-Commits| |GitHub-Issues| |GitHub-PRs| |OpenHub-Status| + All source code is hosted on `GitHub <https://github.com/tqdm/tqdm>`__. Contributions are welcome. @@ -791,16 +794,15 @@ Authors ------- - Ranked by contributions. + The main developers, ranked by surviving lines of code, are: - - Casper da Costa-Luis (casperdcl) - - Stephen Larroque (lrq3000) - - Hadrien Mary (hadim) - - Noam Yorav-Raphael (noamraph)* - - Ivan Ivanov (obiwanus) - - Mikhail Korobov (kmike) + - Casper da Costa-Luis (`casperdcl <https://github.com/casperdcl>`__, ~2/3, |Gift-Casper|) + - Stephen Larroque (`lrq3000 <https://github.com/lrq3000>`__, ~1/3) + - Noam Yorav-Raphael (`noamraph <https://github.com/noamraph>`__, ~1%, original author) + - Hadrien Mary (`hadim <https://github.com/hadim>`__, ~1%) + - Mikhail Korobov (`kmike <https://github.com/kmike>`__, ~1%) - `*` Original author + There are also many |GitHub-Contributions| which we are grateful for. |README-Hits| (Since 19 May 2016) @@ -814,12 +816,22 @@ :target: https://codecov.io/github/tqdm/tqdm?branch=master .. |Codacy-Grade| image:: https://api.codacy.com/project/badge/Grade/3f965571598f44549c7818f29cdcf177 :target: https://www.codacy.com/app/tqdm/tqdm?utm_source=github.com&utm_medium=referral&utm_content=tqdm/tqdm&utm_campaign=Badge_Grade - .. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=2592000 + .. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=86400 :target: https://github.com/tqdm/tqdm/releases .. |GitHub-Forks| image:: https://img.shields.io/github/forks/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/network .. |GitHub-Stars| image:: https://img.shields.io/github/stars/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/stargazers + .. |GitHub-Commits| image:: https://img.shields.io/github/commit-activity/y/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/commit-activity + .. |GitHub-Issues| image:: https://img.shields.io/github/issues-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/issues + .. |GitHub-PRs| image:: https://img.shields.io/github/issues-pr-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/pulls + .. |GitHub-Contributions| image:: https://img.shields.io/github/contributors/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/contributors + .. |Gift-Casper| image:: https://img.shields.io/badge/gift-donate-ff69b4.svg + :target: https://caspersci.uk.to/donate.html .. |PyPI-Status| image:: https://img.shields.io/pypi/v/tqdm.svg :target: https://pypi.python.org/pypi/tqdm .. |PyPI-Downloads| image:: https://img.shields.io/pypi/dm/tqdm.svg @@ -828,6 +840,8 @@ :target: https://pypi.python.org/pypi/tqdm .. |Conda-Forge-Status| image:: https://anaconda.org/conda-forge/tqdm/badges/version.svg :target: https://anaconda.org/conda-forge/tqdm + .. |OpenHub-Status| image:: https://www.openhub.net/p/tqdm/widgets/project_thin_badge?format=gif + :target: https://www.openhub.net/p/tqdm?ref=Thin+badge .. |LICENCE| image:: https://img.shields.io/pypi/l/tqdm.svg :target: https://raw.githubusercontent.com/tqdm/tqdm/master/LICENCE .. |DOI-URI| image:: https://zenodo.org/badge/21637/tqdm/tqdm.svg diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/README.rst new/tqdm-4.19.5/README.rst --- old/tqdm-4.19.4/README.rst 2017-10-15 17:04:37.000000000 +0200 +++ new/tqdm-4.19.5/README.rst 2017-12-10 19:21:44.000000000 +0100 @@ -7,7 +7,7 @@ |Build-Status| |Coverage-Status| |Branch-Coverage-Status| |Codacy-Grade| -|DOI-URI| |LICENCE| +|DOI-URI| |LICENCE| |OpenHub-Status| ``tqdm`` means "progress" in Arabic (taqadum, تقدّم) @@ -81,7 +81,7 @@ Latest development release on GitHub ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -|GitHub-Status| |GitHub-Stars| |GitHub-Forks| +|GitHub-Status| |GitHub-Stars| |GitHub-Commits| |GitHub-Forks| Pull and install in the current directory: @@ -210,6 +210,8 @@ FAQ and Known Issues -------------------- +|GitHub-Issues| + The most common issues relate to excessive output on multiple lines, instead of a neat one-line progress bar. @@ -233,8 +235,7 @@ ``tqdm(zip(a, b))`` should be replaced with ``zip(tqdm(a), b)`` or even ``zip(tqdm(a), tqdm(b))``. -If you come across any other difficulties, browse/open issues -`here <https://github.com/tqdm/tqdm/issues?q=is%3Aissue>`__. +If you come across any other difficulties, browse and file |GitHub-Issues|. Documentation ------------- @@ -519,7 +520,7 @@ from time import sleep from tqdm import trange - from multiprocessing import Pool, freeze_support, Lock + from multiprocessing import Pool, freeze_support, RLock L = list(range(9)) @@ -534,7 +535,7 @@ freeze_support() # for Windows support p = Pool(len(L), # again, for Windows support - initializer=tqdm.set_lock, initargs=(Lock(),)) + initializer=tqdm.set_lock, initargs=(RLock(),)) p.map(progresser, L) print("\n" * (len(L) - 2)) @@ -740,12 +741,12 @@ A clever adjustment system ``dynamic_miniters`` will automatically adjust ``miniters`` to the amount of iterations that fit into time ``mininterval``. Essentially, ``tqdm`` will check if it's time to print without actually - checking time. This behavior can be still be bypassed by manually setting + checking time. This behaviour can be still be bypassed by manually setting ``miniters``. However, consider a case with a combination of fast and slow iterations. After a few fast iterations, ``dynamic_miniters`` will set ``miniters`` to a -large number. When interation rate subsequently slows, ``miniters`` will +large number. When iteration rate subsequently slows, ``miniters`` will remain large and thus reduce display update frequency. To address this: - ``maxinterval`` defines the maximum time between display refreshes. @@ -763,6 +764,8 @@ Contributions ------------- +|GitHub-Commits| |GitHub-Issues| |GitHub-PRs| |OpenHub-Status| + All source code is hosted on `GitHub <https://github.com/tqdm/tqdm>`__. Contributions are welcome. @@ -782,16 +785,15 @@ Authors ------- -Ranked by contributions. +The main developers, ranked by surviving lines of code, are: -- Casper da Costa-Luis (casperdcl) -- Stephen Larroque (lrq3000) -- Hadrien Mary (hadim) -- Noam Yorav-Raphael (noamraph)* -- Ivan Ivanov (obiwanus) -- Mikhail Korobov (kmike) +- Casper da Costa-Luis (`casperdcl <https://github.com/casperdcl>`__, ~2/3, |Gift-Casper|) +- Stephen Larroque (`lrq3000 <https://github.com/lrq3000>`__, ~1/3) +- Noam Yorav-Raphael (`noamraph <https://github.com/noamraph>`__, ~1%, original author) +- Hadrien Mary (`hadim <https://github.com/hadim>`__, ~1%) +- Mikhail Korobov (`kmike <https://github.com/kmike>`__, ~1%) -`*` Original author +There are also many |GitHub-Contributions| which we are grateful for. |README-Hits| (Since 19 May 2016) @@ -805,12 +807,22 @@ :target: https://codecov.io/github/tqdm/tqdm?branch=master .. |Codacy-Grade| image:: https://api.codacy.com/project/badge/Grade/3f965571598f44549c7818f29cdcf177 :target: https://www.codacy.com/app/tqdm/tqdm?utm_source=github.com&utm_medium=referral&utm_content=tqdm/tqdm&utm_campaign=Badge_Grade -.. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=2592000 +.. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=86400 :target: https://github.com/tqdm/tqdm/releases .. |GitHub-Forks| image:: https://img.shields.io/github/forks/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/network .. |GitHub-Stars| image:: https://img.shields.io/github/stars/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/stargazers +.. |GitHub-Commits| image:: https://img.shields.io/github/commit-activity/y/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/commit-activity +.. |GitHub-Issues| image:: https://img.shields.io/github/issues-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/issues +.. |GitHub-PRs| image:: https://img.shields.io/github/issues-pr-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/pulls +.. |GitHub-Contributions| image:: https://img.shields.io/github/contributors/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/contributors +.. |Gift-Casper| image:: https://img.shields.io/badge/gift-donate-ff69b4.svg + :target: https://caspersci.uk.to/donate.html .. |PyPI-Status| image:: https://img.shields.io/pypi/v/tqdm.svg :target: https://pypi.python.org/pypi/tqdm .. |PyPI-Downloads| image:: https://img.shields.io/pypi/dm/tqdm.svg @@ -819,6 +831,8 @@ :target: https://pypi.python.org/pypi/tqdm .. |Conda-Forge-Status| image:: https://anaconda.org/conda-forge/tqdm/badges/version.svg :target: https://anaconda.org/conda-forge/tqdm +.. |OpenHub-Status| image:: https://www.openhub.net/p/tqdm/widgets/project_thin_badge?format=gif + :target: https://www.openhub.net/p/tqdm?ref=Thin+badge .. |LICENCE| image:: https://img.shields.io/pypi/l/tqdm.svg :target: https://raw.githubusercontent.com/tqdm/tqdm/master/LICENCE .. |DOI-URI| image:: https://zenodo.org/badge/21637/tqdm/tqdm.svg diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/examples/parallel_bars.py new/tqdm-4.19.5/examples/parallel_bars.py --- old/tqdm-4.19.4/examples/parallel_bars.py 2017-10-15 17:04:37.000000000 +0200 +++ new/tqdm-4.19.5/examples/parallel_bars.py 2017-10-15 20:19:58.000000000 +0200 @@ -1,7 +1,7 @@ from __future__ import print_function from time import sleep from tqdm import tqdm -from multiprocessing import Pool, freeze_support, Lock +from multiprocessing import Pool, freeze_support, RLock L = list(range(9)) @@ -19,7 +19,7 @@ freeze_support() # for Windows support p = Pool(len(L), initializer=tqdm.set_lock, - initargs=(Lock(),)) + initargs=(RLock(),)) p.map(progresser, L) print("\n" * (len(L) - 2)) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/tqdm/_tqdm.py new/tqdm-4.19.5/tqdm/_tqdm.py --- old/tqdm-4.19.4/tqdm/_tqdm.py 2017-10-15 17:06:27.000000000 +0200 +++ new/tqdm-4.19.5/tqdm/_tqdm.py 2017-12-10 19:21:44.000000000 +0100 @@ -189,7 +189,7 @@ out : str Number with Order of Magnitude SI unit postfix. """ - for unit in ['', 'K', 'M', 'G', 'T', 'P', 'E', 'Z']: + for unit in ['', 'k', 'M', 'G', 'T', 'P', 'E', 'Z']: if abs(num) < 999.95: if abs(num) < 99.95: if abs(num) < 9.995: @@ -276,7 +276,7 @@ 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.) + 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 @@ -448,6 +448,8 @@ # Add to the list of instances if "_instances" not in cls.__dict__: cls._instances = WeakSet() + if "_lock" not in cls.__dict__: + cls._lock = TqdmDefaultWriteLock() with cls._lock: cls._instances.add(instance) # Create the monitoring thread diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/tqdm/_tqdm_notebook.py new/tqdm-4.19.5/tqdm/_tqdm_notebook.py --- old/tqdm-4.19.4/tqdm/_tqdm_notebook.py 2017-10-15 17:04:37.000000000 +0200 +++ new/tqdm-4.19.5/tqdm/_tqdm_notebook.py 2017-12-10 19:21:44.000000000 +0100 @@ -106,7 +106,7 @@ container = HBox(children=[pbar, ptext]) display(container) - def print_status(s='', close=False, bar_style=None): + def print_status(s='', close=False, bar_style=None, desc=None): # Note: contrary to native tqdm, s='' does NOT clear bar # goal is to keep all infos if error happens so user knows # at which iteration the loop failed. @@ -148,6 +148,10 @@ except AttributeError: container.visible = False + # Update description + if desc: + pbar.description = desc + return print_status def __init__(self, *args, **kwargs): @@ -213,6 +217,16 @@ # void -> avoid extraneous `\n` in IPython output cell return + def set_description(self, desc=None, **_): + """ + Set/modify description of the progress bar. + + Parameters + ---------- + desc : str, optional + """ + self.sp(desc=desc) + def tnrange(*args, **kwargs): """ diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/tqdm/_version.py new/tqdm-4.19.5/tqdm/_version.py --- old/tqdm-4.19.4/tqdm/_version.py 2017-10-15 17:13:33.000000000 +0200 +++ new/tqdm-4.19.5/tqdm/_version.py 2017-12-10 19:22:26.000000000 +0100 @@ -5,7 +5,7 @@ __all__ = ["__version__"] # major, minor, patch, -extra -version_info = 4, 19, 4 +version_info = 4, 19, 5 # Nice string for the version __version__ = '.'.join(map(str, version_info)) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/tqdm/tests/tests_tqdm.py new/tqdm-4.19.5/tqdm/tests/tests_tqdm.py --- old/tqdm-4.19.4/tqdm/tests/tests_tqdm.py 2017-10-15 17:04:37.000000000 +0200 +++ new/tqdm-4.19.5/tqdm/tests/tests_tqdm.py 2017-12-10 19:21:44.000000000 +0100 @@ -248,7 +248,7 @@ " 23%|" + '#' * 3 + '6' + \ " | 231/1000 [06:32<21:44, 1.70s/it]" assert format_meter(100000, 1000, 13, unit_scale=True, unit='iB') == \ - "100KiB [00:13, 7.69KiB/s]" + "100kiB [00:13, 7.69kiB/s]" assert format_meter(100, 1000, 12, ncols=0, rate=7.33) == \ " 10% 100/1000 [00:12<02:02, 7.33it/s]" # Check that bar_format correctly adapts {bar} size to the rest @@ -277,10 +277,10 @@ assert '9.00 ' in format_meter(1, 9, 1, unit_scale=True, unit='B') assert '99.0 ' in format_meter(1, 99, 1, unit_scale=True) assert '999 ' in format_meter(1, 999, 1, unit_scale=True) - assert '9.99K ' in format_meter(1, 9994, 1, unit_scale=True) - assert '10.0K ' in format_meter(1, 9999, 1, unit_scale=True) - assert '99.5K ' in format_meter(1, 99499, 1, unit_scale=True) - assert '100K ' in format_meter(1, 99999, 1, unit_scale=True) + assert '9.99k ' in format_meter(1, 9994, 1, unit_scale=True) + assert '10.0k ' in format_meter(1, 9999, 1, unit_scale=True) + assert '99.5k ' in format_meter(1, 99499, 1, unit_scale=True) + assert '100k ' in format_meter(1, 99999, 1, unit_scale=True) assert '1.00M ' in format_meter(1, 999999, 1, unit_scale=True) assert '1.00G ' in format_meter(1, 999999999, 1, unit_scale=True) assert '1.00T ' in format_meter(1, 999999999999, 1, unit_scale=True) diff -urN '--exclude=CVS' '--exclude=.cvsignore' '--exclude=.svn' '--exclude=.svnignore' old/tqdm-4.19.4/tqdm.egg-info/PKG-INFO new/tqdm-4.19.5/tqdm.egg-info/PKG-INFO --- old/tqdm-4.19.4/tqdm.egg-info/PKG-INFO 2017-10-15 17:42:34.000000000 +0200 +++ new/tqdm-4.19.5/tqdm.egg-info/PKG-INFO 2017-12-10 19:57:05.000000000 +0100 @@ -1,6 +1,6 @@ Metadata-Version: 1.1 Name: tqdm -Version: 4.19.4 +Version: 4.19.5 Summary: Fast, Extensible Progress Meter Home-page: https://github.com/tqdm/tqdm Author: tqdm developers @@ -16,7 +16,7 @@ |Build-Status| |Coverage-Status| |Branch-Coverage-Status| |Codacy-Grade| - |DOI-URI| |LICENCE| + |DOI-URI| |LICENCE| |OpenHub-Status| ``tqdm`` means "progress" in Arabic (taqadum, تقدّم) @@ -90,7 +90,7 @@ Latest development release on GitHub ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - |GitHub-Status| |GitHub-Stars| |GitHub-Forks| + |GitHub-Status| |GitHub-Stars| |GitHub-Commits| |GitHub-Forks| Pull and install in the current directory: @@ -219,6 +219,8 @@ FAQ and Known Issues -------------------- + |GitHub-Issues| + The most common issues relate to excessive output on multiple lines, instead of a neat one-line progress bar. @@ -242,8 +244,7 @@ ``tqdm(zip(a, b))`` should be replaced with ``zip(tqdm(a), b)`` or even ``zip(tqdm(a), tqdm(b))``. - If you come across any other difficulties, browse/open issues - `here <https://github.com/tqdm/tqdm/issues?q=is%3Aissue>`__. + If you come across any other difficulties, browse and file |GitHub-Issues|. Documentation ------------- @@ -528,7 +529,7 @@ from time import sleep from tqdm import trange - from multiprocessing import Pool, freeze_support, Lock + from multiprocessing import Pool, freeze_support, RLock L = list(range(9)) @@ -543,7 +544,7 @@ freeze_support() # for Windows support p = Pool(len(L), # again, for Windows support - initializer=tqdm.set_lock, initargs=(Lock(),)) + initializer=tqdm.set_lock, initargs=(RLock(),)) p.map(progresser, L) print("\n" * (len(L) - 2)) @@ -749,12 +750,12 @@ A clever adjustment system ``dynamic_miniters`` will automatically adjust ``miniters`` to the amount of iterations that fit into time ``mininterval``. Essentially, ``tqdm`` will check if it's time to print without actually - checking time. This behavior can be still be bypassed by manually setting + checking time. This behaviour can be still be bypassed by manually setting ``miniters``. However, consider a case with a combination of fast and slow iterations. After a few fast iterations, ``dynamic_miniters`` will set ``miniters`` to a - large number. When interation rate subsequently slows, ``miniters`` will + large number. When iteration rate subsequently slows, ``miniters`` will remain large and thus reduce display update frequency. To address this: - ``maxinterval`` defines the maximum time between display refreshes. @@ -772,6 +773,8 @@ Contributions ------------- + |GitHub-Commits| |GitHub-Issues| |GitHub-PRs| |OpenHub-Status| + All source code is hosted on `GitHub <https://github.com/tqdm/tqdm>`__. Contributions are welcome. @@ -791,16 +794,15 @@ Authors ------- - Ranked by contributions. + The main developers, ranked by surviving lines of code, are: - - Casper da Costa-Luis (casperdcl) - - Stephen Larroque (lrq3000) - - Hadrien Mary (hadim) - - Noam Yorav-Raphael (noamraph)* - - Ivan Ivanov (obiwanus) - - Mikhail Korobov (kmike) + - Casper da Costa-Luis (`casperdcl <https://github.com/casperdcl>`__, ~2/3, |Gift-Casper|) + - Stephen Larroque (`lrq3000 <https://github.com/lrq3000>`__, ~1/3) + - Noam Yorav-Raphael (`noamraph <https://github.com/noamraph>`__, ~1%, original author) + - Hadrien Mary (`hadim <https://github.com/hadim>`__, ~1%) + - Mikhail Korobov (`kmike <https://github.com/kmike>`__, ~1%) - `*` Original author + There are also many |GitHub-Contributions| which we are grateful for. |README-Hits| (Since 19 May 2016) @@ -814,12 +816,22 @@ :target: https://codecov.io/github/tqdm/tqdm?branch=master .. |Codacy-Grade| image:: https://api.codacy.com/project/badge/Grade/3f965571598f44549c7818f29cdcf177 :target: https://www.codacy.com/app/tqdm/tqdm?utm_source=github.com&utm_medium=referral&utm_content=tqdm/tqdm&utm_campaign=Badge_Grade - .. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=2592000 + .. |GitHub-Status| image:: https://img.shields.io/github/tag/tqdm/tqdm.svg?maxAge=86400 :target: https://github.com/tqdm/tqdm/releases .. |GitHub-Forks| image:: https://img.shields.io/github/forks/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/network .. |GitHub-Stars| image:: https://img.shields.io/github/stars/tqdm/tqdm.svg :target: https://github.com/tqdm/tqdm/stargazers + .. |GitHub-Commits| image:: https://img.shields.io/github/commit-activity/y/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/commit-activity + .. |GitHub-Issues| image:: https://img.shields.io/github/issues-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/issues + .. |GitHub-PRs| image:: https://img.shields.io/github/issues-pr-closed/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/pulls + .. |GitHub-Contributions| image:: https://img.shields.io/github/contributors/tqdm/tqdm.svg + :target: https://github.com/tqdm/tqdm/graphs/contributors + .. |Gift-Casper| image:: https://img.shields.io/badge/gift-donate-ff69b4.svg + :target: https://caspersci.uk.to/donate.html .. |PyPI-Status| image:: https://img.shields.io/pypi/v/tqdm.svg :target: https://pypi.python.org/pypi/tqdm .. |PyPI-Downloads| image:: https://img.shields.io/pypi/dm/tqdm.svg @@ -828,6 +840,8 @@ :target: https://pypi.python.org/pypi/tqdm .. |Conda-Forge-Status| image:: https://anaconda.org/conda-forge/tqdm/badges/version.svg :target: https://anaconda.org/conda-forge/tqdm + .. |OpenHub-Status| image:: https://www.openhub.net/p/tqdm/widgets/project_thin_badge?format=gif + :target: https://www.openhub.net/p/tqdm?ref=Thin+badge .. |LICENCE| image:: https://img.shields.io/pypi/l/tqdm.svg :target: https://raw.githubusercontent.com/tqdm/tqdm/master/LICENCE .. |DOI-URI| image:: https://zenodo.org/badge/21637/tqdm/tqdm.svg
