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
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
multiple with logging - Nested progress bars and logging
Customization
Enlighten is highly configurable. For information on modifying the output, see the Series and Format sections of the Counter documentation.
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
File details
Details for the file enlighten-1.0.6.tar.gz.
File metadata
- Download URL: enlighten-1.0.6.tar.gz
- Upload date:
- Size: 84.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | da9f9b10e6b8c6c242db3923b21c0c73fa0ded81bd19505e1d70e6c656a50e65 |
|
| MD5 | a085f8466d83e76761b7909985c11ac4 |
|
| BLAKE2b-256 | 018e884dcb7afd861029251cbdb34427eb9bb41e91c2a594a3670f7ee3e8f718 |
