Enlighten Progress Bar
Project description
Overview
Enlighten Progress Bar is a console progress bar module for Python. (Yes, another one.)
The main advantage of Enlighten is it allows writing to stdout and stderr without any redirection.
Documentation
Installation
PIP
$ pip install enlighten
EL6 and EL7 (RHEL/CentOS/Scientific)
(EPEL repositories must be configured)
$ yum install python-enlighten
Fedora
$ dnf install python2-enlighten
$ dnf install python3-enlighten
Examples
Basic
For a basic status bar, invoke the Counter class directly.
import time
import enlighten
pbar = enlighten.Counter(total=100, desc='Basic', unit='ticks')
for num in range(100):
time.sleep(0.1) # Simulate work
pbar.update()
Advanced
To maintain multiple progress bars simultaneously or write to the console, a manager is required.
Advanced output will only work when the output stream, sys.stdout by default, is attached to a TTY. get_manager can be used to get a manager instance. It will return a disabled Manager instance if the stream is not attached to a TTY and an enabled instance if it is.
import time
import enlighten
manager = enlighten.get_manager()
ticks = manager.counter(total=100, desc='Ticks', unit='ticks')
tocks = manager.counter(total=20, desc='Tocks', unit='tocks')
for num in range(100):
time.sleep(0.1) # Simulate work
print(num)
ticks.update()
if not num % 5:
tocks.update()
manager.stop()
Counters
The Counter class has two output formats, progress bar and counter.
The progress bar format is used when a total is not None and the count is less than the total. If neither of these conditions are met, the counter format is used:
import time
import enlighten
counter = enlighten.Counter(desc='Basic', unit='ticks')
for num in range(100):
time.sleep(0.1) # Simulate work
counter.update()
Additional Examples
basic - Basic progress bar
context manager - Managers and counters as context managers
floats - Support totals and counts that are floats
multicolored - Multicolored progress bars
multiple with logging - Nested progress bars and logging
FTP downloader - Show progress downloading files from FTP
Customization
Enlighten is highly configurable. For information on modifying the output, see the Series and Format sections of the Counter documentation.
Project details
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 enlighten-1.5.1.tar.gz
.
File metadata
- Download URL: enlighten-1.5.1.tar.gz
- Upload date:
- Size: 221.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/3.7.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 836b92850aa1fa1ff9de45d7736f77ed253210928fe423898e5994cb51b755ee |
|
MD5 | d5066a495b9c7758b8479b46f58b6d1d |
|
BLAKE2b-256 | 9512dcdf33dee4ff19290e294e61940d5595ee4d6634529f7396593088e233e7 |
File details
Details for the file enlighten-1.5.1-py2.py3-none-any.whl
.
File metadata
- Download URL: enlighten-1.5.1-py2.py3-none-any.whl
- Upload date:
- Size: 37.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/1.12.2 pkginfo/1.4.2 requests/2.22.0 setuptools/41.6.0 requests-toolbelt/0.9.1 tqdm/4.37.0 CPython/3.7.6
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | dee7375c4c8669db57b0b95dc84eb160ce392efcf1be1b9da1c5d9e5a104c878 |
|
MD5 | d52a0f5bf96dce7282d8d520fe419d90 |
|
BLAKE2b-256 | 8431718a0a419dc18f2dcdeb923a37cc6d860510f9b27ad4ea3f99934f778519 |