Registry / observability / progress

progress

JSON →
library1.6.1pypypi✓ verified 29d 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.9–3.13
musl
3.9–3.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.10–3.95 runs
installs and imports cleanly · install 0.0s · import 0.002s · 17.8MB
glibc
py 3.10–3.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
27 hits · last 30 days
node
24
OpenAI (training)
2
Resources
progress — pip install progress · libregistry