Here we try to keep an up to date record of how Mopidy releases are made. This documentation serves both as a checklist, to reduce the project’s dependency on key individuals, and as a stepping stone to more automation.
Update changelog and commit it.
Bump the version number in
Merge the release branch (
developin the example) into master:
git checkout master git merge --no-ff -m "Release v0.16.0" develop
Install/upgrade tools used for packaging:
pip install -U twine wheel
Build package and test it manually in a new virtualenv. The following assumes the use of virtualenvwrapper:
python setup.py sdist bdist_wheel mktmpenv pip install path/to/dist/Mopidy-0.16.0.tar.gz toggleglobalsitepackages # do manual test deactivate mktmpenv pip install path/to/dist/Mopidy-0.16.0-py27-none-any.whl toggleglobalsitepackages # do manual test deactivate
Tag the release:
git tag -a -m "Release v0.16.0" v0.16.0
Push to GitHub:
git push --follow-tags
Upload the previously built and tested sdist and bdist_wheel packages to PyPI:
twine upload dist/Mopidy-0.16.0*
developand push the branch to GitHub.
Make sure the new tag is built by Read the Docs, and that the
latestversion shows the newly released version.
Spread the word through an announcement post on the Discourse forum.
Notify distribution packagers, including but not limited to: Debian, Arch Linux, Homebrew.