My PyPI Release Checklist 2025

my_pypi_release_checklist_2025.md

My PyPI Release Checklist 2025

This started off as @pydanny's release checklist for our new Python web framework Air.

Change the version number in pyproject.toml by doing:

uv version --bump minor

Regenerate the lockfile:

uv lock

Commit the changes:

git commit -am "Release version X.Y.Z"

Tag the release and push to github:

git tag -a vX.Y.Z -m "Creating version vX.Y.Z"
git push origin vX.Y.Z

This will deploy the new package to PyPI. Once confirmed the new package has been found on GitHub.

Finally, create a new release on GitHub:

• Create a new release on GitHub by clicking "Create a new release"
• From the tag dropdown, choose the tag you just created
• Click "Generate release notes" to auto-populate the release notes
• Copy in whatever notes you have from the CHANGELOG.md file
• Revise the notes as needed
• Click "Publish release"