Releasing Kobo

Upstream release

1. Create a commit updating release notes and version in setup.py.

Example: https://github.com/release-engineering/kobo/commit/597412cd4b843ddc57a50d8ebc88a77660588b3e

2. Create a release

At: https://github.com/release-engineering/kobo/releases

Make release: <version>

Make tag: kobo-<version>

Example: 0.7.0, kobo-0.7.0

3. Upload the release to PyPI

GitHub will create a tarball automatically, however it is not suitable for being uploaded to PyPI, because it misses PKG-INFO file that setuptools need to generate. Therefore you need to run setup.py sdist to create a valid tarball and upload that. Make sure you are doing this while the release tag is checked out.

Example:

git checkout kobo-0.6.0
python setup.py sdist upload

Fedora/EPEL release

1. Update dist-git for Fedora, EPEL

Using fedpkg. ssh://pkgs.fedoraproject.org/rpms/kobo

Work in master branch initially.

Use .tar.gz from github release, e.g. 0.7.0.tar.gz - add "kobo-" prefix.

Example session:

mv 0.7.0.tar.gz kobo-0.7.0.tar.gz
fedpkg new-sources kobo-0.7.0.tar.gz
rpmdev-bumpspec kobo.spec
vim kobo.spec
# set proper Version, Release, changelog
git add -p
git commit
git push -v

Then merge & push to each other branch relevant for release.

2. fedpkg build

For each relevant branch.

for b in f25 f26 f27 master; do git checkout $b && fedpkg build; done

3. Create bodhi updates

https://bodhi.fedoraproject.org/updates/new , one update per target Fedora/EPEL version.