A Python Progressbar library to provide visual (yet text based) progress to long running operations.
Project description
Travis status:
Coverage:
Install
The package can be installed through pip (this is the recommended method):
pip install progressbar2
Or if pip is not available, easy_install should work as well:
easy_install progressbar2
Or download the latest release from Pypi (https://pypi-hypernode.com/pypi/progressbar2) or Github.
Introduction
NOTE: This version has been completely rewritten and might not be 100% compatible with the old version. If you encounter any problems while using it please let me know: https://github.com/WoLpH/python-progressbar/issues
A text progress bar is typically used to display the progress of a long running operation, providing a visual cue that processing is underway.
The ProgressBar class manages the current progress, and the format of the line is given by a number of widgets. A widget is an object that may display differently depending on the state of the progress bar. There are many types of widgets:
Timer
ETA
AdaptiveETA
FileTransferSpeed
AdaptiveTransferSpeed
AnimatedMarker
Counter
Percentage
FormatLabel
SimpleProgress
Bar
ReverseBar
BouncingBar
RotatingMarker
DynamicMessage
The progressbar module is very easy to use, yet very powerful. It will also automatically enable features like auto-resizing when the system supports it.
Links
- Documentation
- Package homepage
- My blog
Usage
There are many ways to use Python Progressbar, you can see a few basic examples here but there are many more in the examples file.
Wrapping an iterable
import time
import progressbar
bar = progressbar.ProgressBar()
for i in bar(range(100)):
time.sleep(0.02)Context wrapper
import time
import progressbar
with progressbar.ProgressBar(max_value=10) as bar:
for i in range(10):
time.sleep(0.1)
bar.update(i)Combining progressbars with print output
import time
import progressbar
bar = progressbar.ProgressBar(redirect_stdout=True)
for i in range(100):
print 'Some text', i
time.sleep(0.1)
bar.update(i)Progressbar with unknown length
import time
import progressbar
bar = progressbar.ProgressBar(max_value=progressbar.UnknownLength)
for i in range(20):
time.sleep(0.1)
bar.update(i)Bar with custom widgets
import time
import progressbar
bar = progressbar.ProgressBar(widgets=[
' [', progressbar.Timer(), '] ',
progressbar.Bar(),
' (', progressbar.ETA(), ') ',
])
for i in bar(range(20)):
time.sleep(0.1)Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file progressbar2-3.18.1.tar.gz.
File metadata
- Download URL: progressbar2-3.18.1.tar.gz
- Upload date:
- Size: 25.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 62ed5ece0aab1628b229d98358ff1e20c0d0d941825ccd9952ddc7a7d7f6f7c4 |
|
| MD5 | d8abdefb0d7c7f1cfeefc28a542807be |
|
| BLAKE2b-256 | 1e94c97b5c090edee457c455fcfd19bc9e4baa8b12abf0621d0f19125bea23eb |
File details
Details for the file progressbar2-3.18.1-py2.py3-none-any.whl.
File metadata
- Download URL: progressbar2-3.18.1-py2.py3-none-any.whl
- Upload date:
- Size: 21.8 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b98b379f359f3adf183ff7faf1a72005473a876ed3cc7d1da2e10e1275e9c8fe |
|
| MD5 | 202460c8c405db52feca40fbc84d7a2d |
|
| BLAKE2b-256 | a2cb6b7e39a428d03e9052f5cb7875b08b606fc5af10d7107713361dbb9380c6 |
