Release procedure¶
Release only after reviewing source, compatibility, real-Redis concurrency, crash/loss and installed-artifact tests. Python 3.10 remains supported; audit tools run on Python 3.11+ so patched transitive dependencies can be selected.
- Set the version in pyproject.toml, sync the frozen lock, review Towncrier and render the release changelog without duplicate headings.
- Run lint, strict typing/docs, real-Redis coverage, Bandit, dependency audit, wheel/sdist builds and Twine. Verify base artifacts with Redis/Idle/Nav absent.
- Commit reviewed changes, require green candidate CI, and create a matching tag.
- Upload the exact verified wheel, sdist and SHA256SUMS to its GitHub release.
- Configure PyPI Trusted Publishing for this repository,
publish.yml, environmentpypi. Record the independently verified SHA256 of SHA256SUMS outside the assets. - Dispatch
publish.ymlagainst the matching version tag and pass that digest asmanifest_sha256. The workflow verifies assets and publishes those exact bytes. - Verify PyPI hashes, fresh index installs and optional Redis imports. Publish Coordination before consuming Idle/Nav versions; Nav before Idle's Nav extra.
Ordinary branch pushes never publish. Do not overwrite tags or PyPI files. A bad release requires a corrective version and, where appropriate, a documented yank.