Skip to content

Latest commit

 

History

History
87 lines (60 loc) · 1.99 KB

RELEASE.md

File metadata and controls

87 lines (60 loc) · 1.99 KB

Release!

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

Preparation

Check the existing tags:

git tag

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

VERSION=1.0.1

Bump the version constants in pyproject.toml and src/filter_pre_commit_hooks.py:

sed -i "s/^version = \".*\"/version = \"$VERSION\"/" pyproject.toml
sed -i "s/^VERSION = \".*\"/VERSION = \"$VERSION\"/" src/filter_pre_commit_hooks.py
uv sync

Now make sure that CHANGELOG.md is up-to-date.

Adjust entries in the changelog 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.

Trigger

Commit the changes. Make sure to sign the commit:

git add .
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 binaries, build and push container images, and draft a GitHub release. Monitor the release workflow run.

Wrap up

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

Publish the draft.