PyPI Release Checklist

Before Your First Release

1. Register the package on PyPI:

   poetry publish
   

2. Visit PyPI to make sure it registered.

For Every Release

1. Update HISTORY.rst

2. Commit the changes:

   git add HISTORY.rst
   git commit -m "Changelog for upcoming release 0.1.1."
   

3. Update version number (can also be patch or major)

   bumpversion minor  # Bumps version to 0.1.1-dev0
   bumpversion release  # Bumps version to 0.1.1
   

4. Run the tests:

   tox
   

5. Push the commit:

   git push
   

6. Push the tags, creating the new release on both GitHub and PyPI:

   git push --tags
   

7. Check the PyPI listing page to make sure that the README, release notes, and roadmap display properly. If not, try one of these:

   1. Copy and paste the RestructuredText into http://rst.ninjs.org/ to find out what broke the formatting.

#. Edit the release on GitHub (e.g. https://github.com/johanvergeer/cookiecutter-poetry/releases). Paste the release notes into the release’s release page, and come up with a title for the release.

About This Checklist

This checklist is adapted from:

• https://gist.github.com/audreyr/5990987
• https://gist.github.com/audreyr/9f1564ea049c14f682f4

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