PyPi Release Checklist

PyPi Release Checklist

For Every Release

  1. Check out release branch, merge all changes from master/main to release

  2. Update history.md - Be noticed that github workflow will generate a changelog in changelog.md for you automatically.

  3. Commit the changes:

    git add HISTORY.md
    git commit -m "Changelog for upcoming release 0.1.1."
    
  4. Update version number (can also be patch or major)

    poetry patch
    
  5. Run the tests:

    tox
    
  6. Push the commit to release branch:

    git push
    
  7. Push the tags, creating the new release on both GitHub and PyPi:

    git tag %tag_name%
    git push --tags
    

    tag_name has to be started with v, to leverage github release workflow.

  8. Check the PyPI listing page to make sure that the README, release notes, and road map display properly. If tox test passed, this should be ok, since we have already run twine check during tox test.

About This Checklist

This checklist has been adapted from:

It assumes that you are using all features of Cookiecutter PyPackage.