Update README.md

This commit is contained in:
noamraph 2014-01-10 10:06:45 +02:00
parent 2ef7f7c675
commit a9db35ae26
1 changed files with 26 additions and 3 deletions

View File

@ -1,10 +1,33 @@
tqdm
====
A Simple Python Progress Meter
Instantly make your loops show a progress meter - just wrap any iterator with "tqdm(iterator)", and you're done!
Wrap any iterator in "tqdm(iterator)" and see a nice progress meter.
![ScreenShot](https://i.imgur.com/he9Aw5C.gif)
tqdm (read ta<i>qa</i>dum, تقدّم) means "progress" in arabic.
You can also use trange(N) as a shortcut for tqdm(xrange(N))
![ScreenShot](https://i.imgur.com/8hcg51N.gif)
Here's the doc:
```python
def tqdm(iterable, desc='', total=None, leave=False, mininterval=0.5, miniters=1):
"""
Get an iterable object, and return an iterator which acts exactly like the
iterable, but prints a progress meter and updates it every time a value is
requested.
'desc' can contain a short string, describing the progress, that is added
in the beginning of the line.
'total' can give the number of expected iterations. If not given,
len(iterable) is used if it is defined.
If leave is False, tqdm deletes its traces from screen after it has finished
iterating over all elements.
If less than mininterval seconds or miniters iterations have passed since
the last progress meter update, it is not updated again.
"""
def trange(*args, **kwargs):
"""A shortcut for writing tqdm(xrange)"""
return tqdm(xrange(*args), **kwargs)
```