gistfile1.rst

Releasing Kivy

$(version) = 1.0.7
$(version+1) = 1.0.8

Tag the current version

1. Ensure you don't have any changes not commited:

   git reset --hard
   

2. In kivy/__init__.py, remove '-dev' part in __version__

3. Commit:

   git commit -am 'bump to $(version)'
   git tag $(version)
   

4. Change kivy/__init__.py __version__ to '$(version+1)-dev':

   git commit -am 'bump to $(version+1-dev)'
   

5. Push everything:

   git push origin master
   

Create Linux source package

1. Create source package and upload it:

   python setup.py sdist upload
   

2. Remove website link on the url, otherwise right now, easy_install might not take the right package for linux:

   http://pypi.python.org/pypi?name=Kivy&version=$(version)&:action=submit_form

Create window package

1. Open git bash:

   source ~/Desktop/Env.sh
   cd ~/Downloads/kivy
   git reset --hard
   git fetch
   git checkout $(version)
   python setup.py build_portable --deps-url=../portable-deps-win32.zip
   

2. Go on the ~/Download/kivy/ directory

3. Copy the Kivy-$(version)-w32.zip on the Desktop

4. Unzip the archive

5. Open shell:sendto

6. Make a shortcut of the ~/Bureau/Kivy-$(version)-w32/kivy.bat as Kivy $(version)

7. Test by opening one example and sent to Kivy $(version)

8. Upload on http://code.google.com/p/kivy/downloads/list

9. Ensure the name will be Kivy-$(version)-w32.zip:

   • description: Kivy 1.0.7, Windows portable version (32 and 64 bits, bundled dependencies)
   • labels: Featured + Type-Archive + OpSys-Windows

10. Change the Kivy-$(version-1)-w32.zip with Deprecated Label

Create Linux .deb

1. Ensure you have bzr-builder installed:

   sudo apt-get install bzr-builder cdbs pbuilder
   

2. Ensure pbuilder is created:

   sudo pbuilder create --mirror  http://archive.ubuntu.com/ubuntu --components "main universe"
   

For pushing a new stable release

1. Create a kivy-$(version).recipe:

   # bzr-builder format 0.3 deb-version $(version)
   lp:kivy tag:$(version)
   
   # merge possible fixes
   # merge fix_manifest lp:kivy revno:507
   
   # merge debian directory for building
   nest-part packaging lp:~tito-bankiz/+junk/kivy-ubuntu debian debian
   

2. Then execute the commands:

   mkdir build-kivy
   bzr dailydeb --allow-fallback-to-native kivy-$(version).recipe build-kivy
   

3. Use pbuilder for testing generation of .deb:

   sudo pbuilder build build-kivy/kivy_$(version).dsc
   

4. The result should be in /var/cache/pbuilder/result:

   -rw-r--r-- 1 tito tito    1152 2011-07-21 18:01 kivy_1.0.7_amd64.changes
   -rw-r--r-- 1 tito tito     653 2011-07-21 17:59 kivy_1.0.7.dsc
   -rw-r--r-- 1 tito tito 4850748 2011-07-21 17:59 kivy_1.0.7.tar.gz
   -rw-r--r-- 1 tito tito 5689678 2011-07-21 18:01 python-kivy_1.0.7_amd64.deb
   

Optional, put it on ppa:

cd build-kivy/kivy-$(version)
debuild -S -sa
cd ..
dput ppa:kivy-team/kivy kivy_1.0.7_source.changes

Note on dput: even if you have 550 error, it will be ok.

For updating the next development release

1. Clone or go to https://code.launchpad.net/~tito-bankiz/+junk/kivy-ubuntu

2. Go to kivy-ubuntu and update changelog:

   dch -v $(version+1-dev)
   

3. Commit:

   bzr commit -m 'Update to latest development version'
   bzr push