1. Chris Beelby
  2. CherryPy


CherryPy / release.py

This script will walk a developer through the process of cutting a release.

Based on https://bitbucket.org/cherrypy/cherrypy/wiki/ReleaseProcess

To cut a release, simply invoke this script at the changeset to be released.

from __future__ import print_function

import subprocess
import sys
import os
import platform
import shutil


def get_next_version():
	digits = map(int, VERSION.split('.'))
	digits[-1] += 1
	return '.'.join(map(str, digits))

NEXT_VERSION = get_next_version()

files_with_versions = ('release.py', 'setup.py', 'cherrypy/__init__.py',

def check_status():
	Make sure there aren't outstanding changesets that are unpushed, maybe
	run the tests or ask the user if the tests are passing.
	print("You're about to release CherryPy {NEXT_VERSION}".format(
	res = raw_input('Have you run the tests with `nosetests -s ./` on '
		'Windows, Linux, and Mac on at least Python 2.4, 2.5, 2.7, and 3.2? '
	if not res.lower().startswith('y'):
		print("Please do that")
		raise SystemExit(1)

def bump_versions():
	Bump the versions in each of the places where it appears and commit.
	list(map(bump_version, files_with_versions))

	subprocess.check_call(['hg', 'ci', '-m',
		'Bumped to {NEXT_VERSION} in preparation for next '

def bump_version(filename):
	with open(filename, 'rb') as f:
		lines = [line.replace(VERSION, NEXT_VERSION) for line in f]
	with open(filename, 'wb') as f:

def tag_release():
	Tag the release.
	subprocess.check_call(['hg', 'tag', NEXT_VERSION])

def build():
	if os.path.isfile('MANIFEST'):
	if os.path.isdir('dist'):
	subprocess.check_call([sys.executable, 'setup.py', 'sdist'])
	subprocess.check_call([sys.executable, 'setup.py', 'sdist',
	subprocess.check_call([sys.executable, 'setup.py', 'bdist_wininst'])

def push():
	"The build went well, so let's push the SCM changesets"
	subprocess.check_call(['hg', 'push'])

def publish():
	scp_command = 'pscp' if platform.system() == 'Windows' else 'scp'
		subprocess.check_call([scp_command, 'dist/*',
		print("Unable to upload the dist files. Ask in IRC for help access "
			"or assistance.")
		raise SystemExit(4)
	res = raw_input('Have you asked in IRC for others to help you test '
		'CherryPy {NEXT_VERSION}? '
	if not res.lower().startswith('y'):
		print("Please do that")
		raise SystemExit(2)
	subprocess.check_call([sys.executable, 'setup.py', 'register'])
	res = raw_input("Have you confirmed that the distro installs properly "
		"with `easy_install CherryPy=={NEXT_VERSION}`? ".format(**globals()))
	if not res.lower().startswith('y'):
		print("Please do that")
		raise SystemExit(3)

def announce():
	print("Please change the Wiki: Home page (news), CherryPyDownload")
	print("Please announce the release on newsgroups, mailing lists, "
		"and IRC /topic.")

def main():
	assert sys.version_info >= (2, 6), ("Release script requires Python 2.6 "
		"or later.")
	assert platform.system() == 'Windows', ('You must release on Windows '
		'(to create Windows installers)')

if __name__ == '__main__':