cosent.buildtools 1.2.1

Introduction

Cosent.buildtools allows you to release a buildout with multiple development eggs in one go.

The intent is, to offer at the buildout/project level, the convenience that jarn.mkrelease offers at the individual egg level.

Cosent.buildtools will:

• Generate a new version number for any development eggs with unreleased changes; also for any RC released eggs if you’re doing a ‘final’ release.

• Commit, tag and release all changed development eggs.

• Update the buildout version.txt to reflect the newly released eggs.

• Generate and store a new version number for the buildout itself.

• Tag all development eggs with the new buildout number as well.

• Commit, tag and release the buildout itself.

Installation

Add the following to your buildout.cfg:

[buildout]
parts += buildtools

[buildtools]
recipe = zc.recipe.egg
eggs = cosent.buildtools

This will install two scripts: buildtool, and bumpversion.

buildtool

buildtool status checks your complete working tree for changes:

buildtool status
  List uncommitted changes in all working trees.

buildtool cook prepares your eggs for release:

buildtool [-n] [-f] [-s] [-c] cook
  Bump version, commit and tag all eggs that have unreleased commits.

  [-n]          dry run, no changes
  [-f]          force a new release, even if no changes
  [-s]          skip sanity check, accept uncommitted changes
  [-c]          create RC (0.1->0.2rc1) instead of final version (0.1->0.2)

buildtool dist releases all eggs and the buildout itself in one go:

buildtool [-n] [-f] [-s] [-c] <-v versions> <-d dist> [-b name] dist
  Release and upload all changed eggs to distserver (via jarn.mkrelease).
  Update and commit buildout versionsfile to reflect the new egg versions.
  Tag the buildout and tag all eggs with the buildout version tag.
  Push all commits and tags in all eggs and the buildout.

  [-n]          dry run, no changes
  [-f]          force a new release, even if no changes
  [-s]          skip sanity check, accept uncommitted changes
  [-c]          create RC (0.1->0.2rc1) instead of final version (0.1->0.2)

  <-v versions> path to buildout versions.txt file
  <-d dist>     pypirc dist location to use for uploading eggs
  [-b name]     name of current buildout, defaults to dirname

buildtool git runs a git command on all eggs and on the buildout:

buildtool git <gitargs>
  Run 'git gitargs' on all development eggs, and on the buildout itself.
  Insert '--' or use extra quoting to escape arguments passed to git.
  Examples:
      bin/buildtool git -- log --oneline HEAD^^..
      bin/buildtool git "commit -a -m 'your commit message'"

Example run:

bin/buildtool git tag                  # list tags
bin/buildtool git whatchanged sometag  # list changes since last release

bin/buildtool status                   # check that we're clean
bin/buildtool cook                     # prepare release
# the actual release
bin/buildtool -v versions.txt -d your.server:/var/pypi dist

Contrary to jarn.mkrelease, buildtool expects clean sandboxes. It will abort if it encounters uncommitted work, unless you use the -s (–skip-checks) switch.

[buildtools]
recipe = zc.recipe.egg
eggs = cosent.buildtools
scripts = buildtool=release
initialization = defaults = {
  'versions-file':'versions.txt',
  'dist-location':'pypi',
  'build-name': 'cosent.buildtools'}
arguments = defaults

bin/release status
bin/release cook
bin/release dist

bumpversion

Enable automated version numbering. Handy for use in conjunction with jarn.mkrelease which breaks if the number isn’t incremented.

This functionality is included in the buildtool wrapper, but also available as standalone utility.

To bump a version to the next release candidate:

$ bin/bumpversion ./src/some.egg/setup.py

To bump a version to the next final release:

$ bin/bumpversion --final ./src/some.egg/setup.py

Version algorithm is as follows:

• rc (release candidate):

  2.7    -> 2.8rc1
  2.8dev -> 2.8rc1
  2.8rc1 -> 2.8rc2

• final (actual release):

  2.7    -> 2.8
  2.8dev -> 2.8
  2.8rc2 -> 2.8

The algorithm is dumb and only understands major.minor + “rc|dev” + seq. Different version numbers like 2.8b3, 2.8-fix2 will cause breakage.