Release Checklist

The Situation

For several years, PIMS and trackpy have been pure Python packages, so building them on all platforms is straightforward. No matter which platform you happen to be working on, you can upload the source to PyPI. Building conda packages for all architectures is handled by conda-forge. Thus, releasing PIMS and trackpy is simpler than it used to be. If C extensions are ever reintroduced into PIMS or trackpy, automated Windows and Linux builds should be set up with appveyor and Travis CI.

Checklist

1. Make sure all issues tagged with the release's milestone are closed or moved to a future milestone.

2. Make sure dependencies listed in setup.py are up to date, including their minimum versions. Make sure that all packages (i.e. subdirectories with required code) within trackpy are listed here.

3. Update the link in the whatsnew doc page

4. Tag a release candidate like git tag v0.0.0rc1.

5. Push the tags to the soft-matter/trackpy repo.

   git push upstream --tags

6. Update trackpy-examples if needed

   • If you suspect that any API changes in trackpy or PIMS have broken the tutorials (especially the walkthrough), make sure there's an issue in the trackpy repository, tagged for this release milestone, to update the notebooks in https://github.com/soft-matter/trackpy-examples .
   • In a new branch of trackpy-examples, edit and re-run the affected notebooks on your own computer. See tips in the trackpy-examples wiki.
   • Submit a PR for trackpy-examples and make sure it gets reviewed.

7. Install pypandoc, which renders the README.

8. Reinstall trackpy locally to ensure that the version number is updated by versioneer.

   python setup.py develop

9. Build the source distribution packages

   python setup.py sdist

10. Install twine to register and upload the source distribution to PyPI. You need to be a maintainer or owner of trackpy on PyPI; you can ask an existing owner to add you.

11. Register and upload the source distribution, compressed as zip and as tarball.

    twine upload dist/<name of package>.tar.gz

12. For the actual release: Wait for the regro-autotick-bot to file a PR at conda forge to update the conda recipe (it may take an hour or more). Make sure the versions agree with setup.py.

13. For a release candidate: the bot will not create a PR. It's still a good idea to manually create a test PR at conda forge; this will cause the automated CI tests to check that the conda package will build smoothly. Don't merge your release candidate PR!

    • Go to the PyPI release page and get the SHA256 hash of this release from the downloads page.
    • Create a pull request from your fork or soft-matter's fork of the conda forge feedstock, updating recipe/meta.yaml with information from the PyPI release.
    • As you are creating the PR, follow the helpful checklist in the default PR message!

14. If all checks (including all automated tests on trackpy-feedstock) are positive, repeat, tagging an actual release and merging the trackpy-feedstock PR.

15. Check the version of the dev docs here. If the content is up to date, but the new version you tagged is not listed at the top of the page, you need to restart the latest Travis build on the master branch. Go to the list of branches on Travis, click on the build (e.g. "#1234 passed"), and then click "Restart build".

16. Manually make some change on the docs repository:

    • force-pull the docs repository (git fetch --all, git reset --hard origin/master)
    • copy over the dev docs to a new version folder (e.g. v0.3.1)
    • edit the redirect of the stable docs
    • edit robots.txt to keep old versions of the docs from appearing in search results
    • push the docs repository

17. Draft and publish the release on GitHub, linking to the whatsnew page in the docs (something like http://soft-matter.github.io/trackpy/v0.3.1/whatsnew.html)

18. Follow the Zenodo link in the "Introduction" page of the documentation to check that the new version is present and has a unique DOI.