witchie/docs/release.rst

48 lines
1.5 KiB
ReStructuredText
Raw Normal View History

2018-06-27 11:11:36 +00:00
=================
Release procedure
=================
This document is a checklist for creating a toot release.
Currently the process is pretty manual and would benefit from automatization.
Bump & tag version
------------------
* Update the version number in ``setup.py``
* Update the version number in ``toot/__init__.py``
2019-09-03 14:39:06 +00:00
* Update ``changelog.yaml`` with the release notes & date
2020-04-15 12:28:17 +00:00
* Run ``make changelog`` to generate a human readable changelog
2019-09-03 14:39:06 +00:00
* Commit the changes
2020-01-23 12:24:49 +00:00
* Run ``./scripts/tag_version <version>`` to tag a release in git
2019-09-03 14:39:06 +00:00
* Run ``git push --follow-tags`` to upload changes and tag to Github
2018-06-27 11:11:36 +00:00
Publishing to PyPI
------------------
* ``make dist`` to create source and wheel distributions
* ``make publish`` to push them to PyPI
Publishing to Debian repo
-------------------------
Publishing deb packages is done via `ihabunek/packages <https://github.com/ihabunek/packages>`_.
2019-08-01 12:51:31 +00:00
* run ``make deb_dist`` to create the debian package
2018-06-27 11:11:36 +00:00
* copy deb file to packages project directory
* in packages project directory:
* ``make`` to build the repo files
* ``make publish`` to send them to the server
Github release
--------------
* `Create a release <https://github.com/ihabunek/toot/releases/>`_ for the newly
pushed tag, paste changelog since last tag in the description
* Upload the assets generated in previous two steps to the release:
* source dist (.zip and .tar.gz)
* wheel distribution (.whl)
* debian package (.deb)
2019-09-03 14:39:06 +00:00
TODO: this can be automated: https://developer.github.com/v3/repos/releases/