Registry / observability / progress

progress

JSON →
library1.6.1pypypi✓ verified 26d ago

The `progress` library (current version 1.6.1) provides easy-to-use, text-based progress bars and spinners for command-line interfaces. It offers a straightforward API with several built-in styles and aims for minimalism and speed, without external dependencies.

pip install progress
INSTALL
IMPORT
SIG · PROGRESS
P
progress
observabilitypythonv1.6.1
Install
1.6s avg
Import
10ms
Disk
16MB
Pass rate
10/ 10
Env Coverage10 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v1.6.1 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
py 3.103.95 runs
installs and imports cleanly · install 0.0s · import 0.002s · 17.8MB
glibc
py 3.103.95 runs
installs and imports cleanly · install 1.6s · import 0.002s · 18MB
16MB installed
● package 16MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

Bar
from progress.bar import Bar
ChargingBar
from progress.bar import ChargingBar
IncrementalBar
from progress.bar import IncrementalBar
Spinner
from progress.spinner import Spinner

This quickstart demonstrates creating a basic progress bar using `progress.bar.Bar`. The `with` statement ensures the bar is properly finalized even if an error occurs. Call `bar.next()` in each iteration to advance the progress.

import time from progress.bar import Bar # Example with a simple Bar with Bar('Processing...') as bar: for i in range(100): # Simulate work time.sleep(0.02) bar.next()
Debug
Known issues
gotchaThe `progress` library does not support Jupyter notebooks or similar interactive environments, as it is primarily designed for terminal-based applications.
fix
For Jupyter notebook support, consider alternatives like `tqdm` or `ipywidgets`.
affects: All versions
gotchaProgress bars created with `progress` do not dynamically resize if the terminal window changes size during execution.
fix
Ensure the terminal window size is stable, or use libraries with dynamic resizing support if this is a critical requirement.
affects: All versions
gotchaThis library (PyPI: `progress`) is often confused with `progressbar2` (PyPI: `progressbar2`). Ensure you install `progress` if you intend to use this specific library.
fix
Verify your `pip install` command is `pip install progress` and your imports are from `progress.bar` or `progress.spinner`.
affects: All versions
gotchaThe `progress` library offers fewer customization options compared to more feature-rich progress bar libraries like `tqdm` or `progressbar2`.
fix
Evaluate your customization needs; for advanced features or highly custom displays, explore `tqdm` or `progressbar2`.
affects: All versions
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'progress'
The 'progress' library is not installed in the Python environment or the environment where the code is being run.
fix
Install the library using pip: `pip install progress`
TypeError: 'module' object is not callable
This occurs when attempting to call the 'progress' module directly as if it were a function, instead of importing and instantiating a specific progress bar class (e.g., `Bar`, `Spinner`) from its submodules.
fix
Import the specific class you intend to use and then instantiate it. For example:
```python
from progress.bar import Bar
bar = Bar('Processing:')
# ... or ...
from progress.spinner import Spinner
spinner = Spinner('Loading ')
```
NameError: name 'Bar' is not defined
The `Bar` class (or another progress bar class like `Spinner`) is used without being explicitly imported from its specific submodule within the `progress` library.
fix
Ensure you import the desired progress bar class directly from its submodule. For example:
```python
from progress.bar import Bar
bar = Bar('Processing')
```
Messy output when using print() with a progress bar
Standard `print()` statements interfere with the dynamic redrawing mechanism of the text-based progress bar, causing the output to become corrupted and unreadable.
fix
Avoid using `print()` statements directly within the loop where the progress bar is active. If logging is necessary, consider writing to a file, using a dedicated logging framework, or printing output before or after the progress bar's lifecycle.
Upgrade
Version history
1.6.1latest on PyPI · released Jul 1, 2025
Audit
Dependencies

No dependency data recorded yet.

Agent activity
25 hits · last 30 days
node
22
OpenAI (training)
2
Resources
progress — pip install progress · libregistry