Making a release

A core developer should use the following steps to create a release X.Y.Z of cmake-python-distributions on PyPI.

This is usually done after Updating the CMake version.

Prerequisites

• All CI tests are passing on GitHub Actions.

• You have a GPG signing key.

PyPI: Step-by-step

1. Make sure that all CI tests are passing on GitHub Actions.

2. Download the latest sources if you don’t already have them

$ git clone git@github.com:scikit-build/cmake-python-distributions
$ cd cmake-python-distributions

3. Ask nox for the instructions on what to type

$ nox -s tag_release

4. Run the suggested lines, probably something like this:

$ git tag --sign -m 'cmake-python-distributions 3.31.2' 3.31.2 main
$ git push origin 3.31.2

Warning

We recommend using a GPG signing key to sign the tag.

5. Check the status of the builds on GitHub Actions.

6. Once the builds are completed, check that the distributions are available on PyPI.

7. Make a GitHub release based on the tag. This will display the latest version in the GitHub sidebar, and will notify release watchers of the release. Title it Version X.Y.Z and add a little note about what changed (Python only).