cosent.buildtools 1.2.1

简介

Cosent.buildtools 允许您一次性发布带有多个开发egg的buildout。

目的是，在buildout/项目级别提供类似于 jarn.mkrelease 在单个egg级别提供的便利性。

Cosent.buildtools 将会

• 为任何有未发布更改的开发egg生成新的版本号；如果你正在进行“最终”发布，则为任何RC发布的egg。

• 提交、标记和发布所有更改的开发egg。

• 更新buildout的version.txt以反映新发布的egg。

• 为buildout本身生成并存储一个新的版本号。

• 将所有开发egg标记为新buildout的编号。

• 提交、标记和发布buildout本身。

安装

将以下内容添加到您的buildout.cfg中

[buildout]
parts += buildtools

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

这将安装两个脚本：buildtool和bumpversion。

buildtool

buildtool状态 检查您的整个工作树是否有更改

buildtool status
  List uncommitted changes in all working trees.

buildtool cook 准备您的egg以发布

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 一次发布所有鸡蛋和构建工具本身

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 在所有鸡蛋和构建工具上运行 git 命令

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'"

示例运行

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

与 jarn.mkrelease 不同，buildtool 期望干净的沙箱。如果遇到未提交的工作，它会中断，除非您使用 -s（–skip-checks）开关。

[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

启用自动版本编号。这对于与 jarn.mkrelease 一起使用非常有用，如果编号未增加，它就会损坏。

此功能包含在 buildtool 包装器中，但也作为独立实用程序提供。

将版本提升到下一个发布候选版本

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

将版本提升到下一个最终版本

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

版本算法如下

• rc（发布候选）

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

• final（实际发布）

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

该算法很简单，只理解 major.minor + “rc|dev” + seq。不同的版本号，如 2.8b3、2.8-fix2，会导致损坏。