Create a Release

This article is more for internal purposes. It explains how to create a new Bliss release.

1. Prepare Source Files

• Update the version number in bliss/VERSION
• If aplicable, change the trove category for Bliss's development status in setup.py. Possible values are:
  Development Status :: 1 - Planning
Development Status :: 2 - Pre-Alpha
Development Status :: 3 - Alpha
Development Status :: 4 - Beta
Development Status :: 5 - Production/Stable
Development Status :: 6 - Mature
Development Status :: 7 - Inactive
  

Update Changelog

• This is important: CHANGELOG should reflect all changes and improvements that have made it into the current release.

3. Git Release Tag

• Based on / more info: http://gitready.com/beginner/2009/02/03/tagging.html

Creating a tag in git is pretty straight forward:

git tag -a vX.Y.Z -m "Tagging X.Y.Z release"
git push origin vX.Y.Z

The tag will become available on the website (including automatic tar.gz download): https://github.com/saga-project/bliss/tags

4. Cheese Shop (PyPi) Upload

• Based on / more info: http://wiki.python.org/moin/CheeseShopTutorial
  
• Also very helpful: http://www.youtube.com/watch?v=B3KBuQHHKx0

Uploading the new Bliss release to the PyPi Cheese Shop is really simple. Just run this command in the Air source root:

$ python setup.py sdist upload

It is also possible to log into PyPi and upload or change the Bliss package manually. The package lives here: http://pypi.python.org/pypi/bliss/

5. Spread the News

• 1. Release announcement on in the 'NEWS' section on the Wiki front-page: https://github.com/saga-project/bliss/wiki
• 2. Release announcement on the [email protected] mailing list
• 3. Release announcement on Twitter via @SAGAGridAPI.