Download Install Tutorial Docs FAQ Tools WikiLicense Team IRC Planet Involvement Shop Book

How to make a CP release

Test the source

  • Run python test.py and python test.py --1.0.
  • Starting with the 3.0 branch, you should probably do python test.py --ssl, too.
  • Test it on Windows, Linux, and Mac (solicit help from the friendly users on #cherrypy).
  • Our setup.py says we require Python 2.3. You should probably test on at least 2.4.x, 2.5.x, and 2.6.x.

Document the source code

  • Change version # in __init__.py, setup.py, wsgiserver/__init__.py.
  • Change development status in setup.py if necessary.
  • Change the download_url in setup.py to reflect the new version.
  • Checkin changes
  • Tag the source tree

Create distros

  • Run ./make-sdist (it is nice to have *.gz and .zip versions).
  • On Windows, run python setup.py sdist --format=zip and python setup.py bdist --format=wininst.

Publish distros

  • Upload it to download.cherrypy.org.
  • Have a few friendly souls on the IRC channel test the released files.
  • python setup.py register -- Make sure you go to pypi and reactivate any older versions that you want to remain visible there as well (and installable via easy_install). Register seems to deactivate all other versions.
  • Do a test of installing the distro with easy_install CherryPy.

Tell everybody

  • Change Wiki: Home page (news), CherryPyDownload.
  • Announce it on newsgroups, mailing lists, IRC /topic etc.

Hosted by WebFaction

Log in as guest/cpguest to create tickets