Home

Where to release

• GitHub
• PyPI
• astroconda
• conda-forge
• Zenodo

How to release on GitHub

1. pip install pep517 --upgrade
2. Grab latest code from master
3. Grab all the tags from this repo
4. Make sure you are on the branch that you intend to release from
5. Check git status (must be clean) and git log (must contain correct history)
6. Finalize release date on change log, add, and commit it.
7. git clean -xdf
8. git tag -s "X.Y.Z" -m "Tagging version X.Y.Z" (replace X.Y.Z with real version number)
9. git push <remote> X.Y.Z (replace <remote> with remote name that points to this repo)
10. Add new change log entry for next release, add, and commit it.
11. git push <remote> master
12. git checkout stable
13. git reset --hard <version>
14. git push <remote> stable --force
15. Edit release tag on GitHub to add change log and publish release.

How to release on PyPI

Check the logs under Actions. This should be done automatically when a GitHub Release is made. If successful, you will see it on https://pypi.org/project/stginga/ .

Other release outlets

• Open a PR on astroconda/astroconda-contrib to update recipe. Bump Ginga there too if needed.
• Wait for a notification from conda-forge feedstock, review its PR, fix (if needed), and merge.
• Download the release tarball from PyPI and upload it to Zenodo.
• Check https://readthedocs.org/projects/stginga/builds/