44 lines
1.3 KiB
ReStructuredText
44 lines
1.3 KiB
ReStructuredText
|
=================
|
||
|
|
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``
|
||
|
|
* Update the ``CHANGELOG.md`` with the release notes & date
|
||
|
|
* Tag a release in git
|
||
|
|
* Push master & tag to GitHub
|
||
|
|
|
||
|
|
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>`_.
|
||
|
|
|
||
|
|
* run ``make deb`` to create the debian package
|
||
|
|
* 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)
|