Skip to content

Releases

v4.7.1

Choose a tag to compare

@wolph wolph released this 16 Nov 16:15
v4.7.1
a4aba25

Fixes for three regressions in 4.7.0 (#336):

  • A bar that leaves a MultiBar, through pop, del, clear, a replacement under the same label or remove_finished, takes its generated label widgets with it. Adding it again labels it once. 4.7.0 left the old labels in bar.widgets and 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. A StreamWrapper subclass whose update_capturing() calls super() 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

Choose a tag to compare

@wolph wolph released this 06 Nov 18:10
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

Choose a tag to compare

@wolph wolph released this 06 Nov 18:09
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

Choose a tag to compare

@wolph wolph released this 06 Nov 18:14
pypi-untagged-releases

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

Choose a tag to compare

@wolph wolph released this 05 Nov 10:38
v4.7.0
d70d740

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 Bar fill colours are constructor arguments (fg, bg); the Bar.fg and Bar.bg class attributes are gone.

Parallel execution

  • progressbar.map, imap, imap_unordered, starmap, thread_map, process_map, as_completed, the asyncio amap, aimap, aimap_unordered and gather, run for shell commands and the progressbar.parallel decorator, with bar='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__}') raise ValueError: 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.lock and listeners_lock are read-only properties.
  • MultiBar membership 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, desc and suffix, so a labelled bar no longer overflows the terminal (contributed by @rupayon123 in #331).
  • desc renders as a template, as in 4.6.0; a literal brace is doubled (#334).
  • PROGRESSBAR_MINIMUM_UPDATE_INTERVAL set to a non-numeric value is logged once and ignored instead of raising at the first bar.
  • Deprecation warnings for maxval, poll and currval name the caller's file and line.

Compatibility

  • Requires python-utils >= 4.1.4 (was 3.8.1): older releases render a negative scale_1024 power as 0.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

Choose a tag to compare

@wolph wolph released this 13 Aug 16:43
v4.6.0
81eed97

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]'. See benchmarks/report.md for the numbers against tqdm, rich, alive-progress and click.

Features

  • tqdm-style arguments on progressbar(): desc, total, unit, unit_scale and postfix.
  • MultiBar(join_timeout=...) bounds the wait for unfinished bars on with-block exit.
  • TERM-based color detection generalized beyond xterm variants (#318), plus a truecolor-terminal allowlist for stripped COLORTERM environments.
  • AttributeDict is generic over its value type.

Fixes

  • 28 bugs found in a full audit of the bar, widgets, MultiBar and 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/ and tools/ 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

Choose a tag to compare

@wolph wolph released this 28 Aug 22:50
v4.5.0
eb840a4

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

Choose a tag to compare

@wolph wolph released this 05 Mar 16:21
v4.4.2
64f43b6

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

Choose a tag to compare

@wolph wolph released this 25 Feb 09:03
v4.4.1
7803dd0

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

Choose a tag to compare

@wolph wolph released this 25 Feb 08:54
v4.4.0
b167e47

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