Skip to content

Release instructions

bdarnell edited this page Mar 29, 2013 · 10 revisions
  1. For a patch release, checkout the previous release (git checkout v1.1.0), and then make changes (using git cherry-pick or rebase as needed). For a full release, git checkout master.
  2. Move release notes from next.rst to their final location and update release date.
  3. Update version numbers in code (setup.py, __init__.py). Sample commit
  4. Tag the release: git tag -a v1.1.1 Paste release notes into the editor window that pops up.
  5. Build the release tarball: python setup.py sdist (the tarball goes in dist/tornado-3.0.tar.gz)
  6. Test the release tarball in an isolated environment: virtualenv /tmp/test_env; cd /tmp/test_env; source bin/activate; pip install path/to/tornado-3.0.tar.gz; python -m tornado.test.runtests.
  7. Upload the tarball to pypi: python setup.py sdist upload
  8. For a patch relase, merge the newly-created tag into master: git checkout master; git merge v1.1.1
  9. Push the code and tag to github: git push origin master; git push origin tag v1.1.1
  10. Update branches (TODO: document branch policy)
  11. Announce via google group
  12. Go to readthedocs.org and update the default version

Clone this wiki locally