Repository navigation
Releases
v4.7.1
Fixes for three regressions in 4.7.0 (#336):
- A bar that leaves a
MultiBar, throughpop,del,clear, a replacement under the same label orremove_finished, takes its generated label widgets with it. Adding it again labels it once. 4.7.0 left the old labels inbar.widgetsand labelled it twice. - The
stop_capturing()that brings the count to zero flushes the original stream once, as 4.6.0 did. 4.7.0 flushed it three times. AStreamWrappersubclass whoseupdate_capturing()callssuper()gets two flushes, the second one on an empty buffer. - A
WrappingIO.flush()replacement that raises no longer costs the captured text. The text goes back in front of anything written since, and the next flush delivers it in order. 4.7.0 drained the buffer first and lost the text.
The package metadata on PyPI links to the release notes (#335).
v3.11.0
Release 3.11.0. No changelog section was found at tag v3.11.0.
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v3.6.2
Release 3.6.2. No changelog section was found at tag v3.6.2.
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
PyPI versions without a matching tag
PyPI versions for which no matching commit could be found. Their files are the exact PyPI uploads.
- 2.4.0
- 2.4.1
- 2.5.0
- 2.6.0
- 2.6.3
- 2.6.4
- 2.6.5
- 2.6.6
- 2.6.7
- 2.6.8
- 2.6.9
- 2.7.0
- 2.7.3
- 3.9.2
- 4.3b0
- 4.4.3
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads of the versions listed in these notes, each verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.7.0
Highlights since 4.6.0:
Colours
- Widgets are coloured by default: a bar on a colour terminal shows the default palette without
enable_colors=True, spinners cycle through colours (color_cycle,HueGradient,rainbow). Output to a file or pipe is unchanged;progressbar.utils.no_color()strips the escapes from a widget called directly. - The
Barfill colours are constructor arguments (fg,bg); theBar.fgandBar.bgclass attributes are gone.
Parallel execution
progressbar.map,imap,imap_unordered,starmap,thread_map,process_map,as_completed, the asyncioamap,aimap,aimap_unorderedandgather,runfor shell commands and theprogressbar.paralleldecorator, withbar='multi'for an overall bar plus one per task (#327).
Performance
- A forced redraw of the default widgets is 20 percent faster than 4.6.0 with colours on; the fast path, the iterator overhead and the import time are at or below their 4.6.0 cost (#333). Colour escapes are cached per gradient and colour, templates are validated once, captured writes take a cheaper lock.
Security and hardening (#330)
- New-style templates such as
FormatLabel('{value.__class__}')raiseValueError: a template walking dunder or frame attributes could reach interpreter internals. Index access and ordinary attributes keep working. - Captured output survives a drain failure on the other stream, unwrapping restores the original stream even with a closed capture buffer, and the stream locks reset after
fork.StreamWrapper.lockandlisteners_lockare read-only properties. MultiBarmembership changes and expiry share one guard and track bars by identity.- The CLI validates every argument before opening the output file, exits 2 with a usage line on an invalid option and 130 after Ctrl-C, and ends quietly with status 0 when the pipeline's reader goes away.
Fixes
- The fast bar reserves the width of
prefix,descandsuffix, so a labelled bar no longer overflows the terminal (contributed by @rupayon123 in #331). descrenders as a template, as in 4.6.0; a literal brace is doubled (#334).PROGRESSBAR_MINIMUM_UPDATE_INTERVALset to a non-numeric value is logged once and ignored instead of raising at the first bar.- Deprecation warnings for
maxval,pollandcurrvalname the caller's file and line.
Compatibility
- Requires
python-utils >= 4.1.4(was 3.8.1): older releases render a negativescale_1024power as0.1 YiB. - Full list in CHANGES.rst.
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.6.0
Highlights since 4.5.0:
Performance
progressbar.progressbar()now auto-dispatches to a lean fast path for the common wrap-a-loop case, and an integer update gate keeps gated iterations to an increment, a compare and a store (#316).- Optional native iterator accelerator:
pip install 'progressbar2[fast]'. Seebenchmarks/report.mdfor the numbers against tqdm, rich, alive-progress and click.
Features
- tqdm-style arguments on
progressbar():desc,total,unit,unit_scaleandpostfix. MultiBar(join_timeout=...)bounds the wait for unfinished bars onwith-block exit.TERM-based color detection generalized beyond xterm variants (#318), plus a truecolor-terminal allowlist for strippedCOLORTERMenvironments.AttributeDictis generic over its value type.
Fixes
- 28 bugs found in a full audit of the bar, widgets,
MultiBarand the CLI (#315), plus regression coverage for #212, #295 and #301 (#317, #326). - 16-color mapping no longer collapses mid-intensity colors (e.g. maroon) to black.
- The wheel no longer ships the repo-level
benchmarks/,scripts/andtools/directories.
Documentation
- Rebuilt as an interactive site: a tutorial, task-focused how-tos, per-widget pages with animated demos, and an in-browser Python console that runs every example live: https://progressbar-2.readthedocs.io/
- Full API docstring coverage, enforced in CI.
Compatibility
- Requires Python 3.10+ (was 3.8).
- Still backwards compatible with the original progressbar package.
Full changelog: v4.5.0...v4.6.0
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.5.0
Improved build system with many more (and improved) type hints.
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.4.2
Fixed visible control characters issue on Windows. Fixes #293
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.4.1
Included fix for the progressbar command
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md
v4.4.0
Greatly improved Windows (colour) support and fixed several Windows bugs
Signed on 2026-11-12 with ppt sign, after the release.
The files above are the exact PyPI uploads for this version, verified by sha256 against PyPI before signing.
Each file has a GPG signature (.asc, key 149325FD15904E9C4EB89E95E81444E9CE1F695D) and a Sigstore bundle (.sigstore.json).
SHA256SUMS.asc signs the checksum list.
Rebuilt files, if any: none.
How to verify: https://github.com/WoLpH/python-project-tools/blob/master/VERIFY.md