This document describes the release process and is targeted at maintainers.

Pick a name for the new release. It must follow Semantic Versioning:

VERSION=1.0.1

Make sure that the "Unreleased" section in the changelog is up-to-date. Feel free to adjust entries for example by adding additional examples or highlighting breaking changes.

Move the content of the "Unreleased" section that will be included in the new release to a new section with an appropriate title for the release. Should the "Unreleased" section now be empty, add "Nothing." to it.

Set the __version__ variable in __init__.py to $VERSION:

sed -i "/^__version__/c\__version__ = \"$VERSION\"" src/*/__init__.py
grep -n -H __version__ src/*/__init__.py

Bump the version using Poetry:

poetry version $VERSION

Continue with the next section.

Commit the changes. Make sure to sign the commit:

git add CHANGELOG.md src/*/__init__.py pyproject.toml
git commit -S -m "chore: Prepare release v$VERSION"
git log --show-signature -1

Push changes:

git push origin master

Check workflow runs in GitHub Actions and ensure everything is fine.

Tag the latest commit with an annotated and signed tag:

git tag -s v$VERSION -m ""
git show v$VERSION

Make sure that the tree looks good:

git log --graph --oneline --all -n 5

Push the tag itself:

git push origin v$VERSION

This triggers the release workflow which will build a package, publish it to PyPI, and draft a GitHub release. Monitor the workflow run:

gh workflow view release --web

Ensure that the new package version has been published to PyPI here.

Go to the release page of this project on GitHub here and review the automatically created release draft.

Set the release title to "$VERSION / $DATE". For example "1.0.0 / 2023-01-01".

Add release notes by extracting them from the changelog.

Publish the release draft.