How to release

This is documenting the release process.

Git flow & CHANGELOG.md

Make sure the CHANGELOG.md is up to date and follows the http://keepachangelog.com guidelines. Start the release with git flow:

git flow release start YYYYMMDD

Now update the CHANGELOG.md [Unreleased] section to match the new release version. Also update the version string in the setup.py file. Then commit and finish release.

git commit -a -m "YYYYMMDD"
git flow release finish

Push everything, make sure tags are also pushed:

git push
git push origin master:master
git push --tags

Publish to PyPI

Build it:

make release/build

Check archive content:

tar -tvf dist/pyetheroll-*.tar.gz

Upload:

make release/upload

This will also publish the alias meta package setup_meta.py.

Check Read the Docs

Make sure https://readthedocs.org/projects/pyetheroll/ is up to date.

GitHub

Got to GitHub Release/Tags, click “Add release notes” for the tag just created. Add the tag name in the “Release title” field and the relevant CHANGELOG.md section in the “Describe this release” textarea field. Finally, attach the generated APK release file and click “Publish release”.