bump2version 0.5.11

bump2版本

https://github.com/peritus/bumpversion

不幸的是，开发似乎已经停滞了一段时间，从 作者，为此，本项目是一个替换项，它合并了一些更重要的修复程序。

希望我们可以合并回原来的bumpversion并在那里进行开发。

概述

只需一个命令就可以升级你的软件！

一个小型的命令行工具，通过更新所有 以正确的增量对源代码中的字符串进行版本转换。也创造 提交和标记：

• 版本格式是高度可配置的
• 在没有任何VCS的情况下工作，但很高兴从中读取标签信息并写入 提交并标记到Git和Mercurial（如果可用）
• 只处理文本文件，因此它不特定于任何编程语言
• 支持python2、python3和pypy

安装

您可以从python包索引（pypi）下载并安装此软件的最新版本，如下所示：

pip install --upgrade bump2version

用法

有两种操作模式：在命令行上执行单个文件操作 使用配置文件（bumpversion.cfg）进行更复杂的多文件操作。

bump2version [options] part [file]

部件

必需的

要增加的版本部分，例如minor

有效值包括--serialize/--parse选项中给定的值。

碰撞0.5.1到0.6.0的示例：

 bump2version --current-version 0.5.1 minor src/VERSION

文件

[可选]
默认值：无

将被修改的文件。

如果没有给出，则来自 将使用配置文件。如果在 配置文件也不会被修改。

颠簸1.1.9至2.0.0的示例：

 bump2version --current-version 1.1.9 major setup.py

配置文件

所有选项都可以在一个名为 .bumpversion.cfg这样一旦你知道bump2version需要如何 为一个特定的软件包配置，您可以在没有 稍后指定选项。你应该加上那个文件o VCS，这样其他人也可以 凹凸版本。

命令行上的选项优先于配置文件中的选项， 它们优先于从环境中获得的，然后从 默认设置。

示例.bumpversion.cfg：

[bumpversion]
current_version = 0.2.9
commit = True
tag = True

[bumpversion:file:setup.py]

如果不存在.bumpversion.cfg，则bump2version也将研究 setup.cfg用于配置。

配置文件--全局配置

一般配置分为[bumpversion]部分。

当前版本

必需的
默认值：无

碰撞前软件包的当前版本。

也可用作--当前版本（例如bump2version--当前版本0.5.1 patch setup.py）

新版本

[可选]
默认值：无

增量后软件包的版本。如果不给的话 自动确定。

也可用作--新版本（例如从0.5.1直接转到0.6.1：bump2version--当前版本0.5.1--新版本0.6.1 patch setup.py）。

标记=（true false）

[可选]
默认值：false（不创建标记）

是否创建标记，即新版本，以字符为前缀 "v"。如果您使用的是git，不要忘记使用 --标记标志。

在命令行中也可用作（-tag--no tag）

签名标记=（true false）

[可选]
默认值：false（不签署标记）

是否签署标签。

在命令行中也可用作（-sign tags--no sign tags）

标记名=

[可选]
默认值：v{new_version}

将创建的标记的名称。仅当使用--tag/tag=true时有效

这是使用python格式字符串语法的模板。 模板上下文中提供了当前版本和新版本 以及当前部件和新部件（例如，'当前主要部件 或"新的修补程序"。 此外，所有的环境变量都是公开的，前缀是$
您还可以使用变量now或utcnow来获取当前时间戳。双方接受 日期时间格式（如在{now:d.%m.%y}中使用时）。

也可用作命令行标志标记名。示例用法：
bump2version--标记"release-{new_version}"修补程序

提交=（true false）

[可选]
默认值：false（不创建提交）

是使用git还是mercurial创建提交。

也可用作（-commit--no commit）

在许多项目中，在 提交并在失败的情况下中止提交。对于某些用例，它可能 希望在碰撞版本并具有commit=true时， 预提交钩子应该执行与常规钩子稍有不同的操作 提交。例如，只对 软件。允许预提交挂钩区分bumpversion 提交，bumpversion\u当前版本和bumpversion\u新版本 执行commit命令时设置环境变量。

消息=

[可选]< BR>默认值：通气版本：{当前版本}→{新版本}

创建提交时要使用的提交消息。仅在使用--commit时有效/commit=true

这是使用python格式字符串语法的模板。 模板上下文中提供了当前版本和新版本 以及当前部件和新部件（例如，'当前主要部件 或"新的修补程序"。 此外，所有环境变量都将公开，前缀为$
您还可以使用变量now或utcnow来获取当前时间戳。双方接受 日期时间格式（如在{now:d.%m.%y}中使用时）。

也可用作命令行标志--message。示例用法：
bump2version--message'[{now:%y-%m-%d}]jenkins build{$build}：{new_version}'补丁）

配置文件—部件特定配置

版本字符串由一个或多个部分组成，例如版本1.0.2 有三个部分，由点（）字符分隔。默认情况下 配置这些部件命名为major，minor，patch，但是您可以 使用parse/serialize选项进行自定义。

默认情况下，所有被视为数字的部分，即其初始值为0 它们以整数的形式增加。此外，值0被认为是 如果序列化不需要，也就是说版本1.4.0是可选的 等于1.4如果{major}.{minor}作为序列化值给定。

对于高级版本控制方案，可能需要非数字部分（例如 确定α或β版本 指示开发阶段、软件包的风格或 发布名称）。为此，您可以使用[bumpversion:part:…]部分 包含零件名称（例如，在 名为[bumpversion:part:release\u name]的部分

以下选项在零件配置中有效：

值=

默认值：数字（即0，1，2，…）

当碰到指定的 部分，

示例：

[bumpversion:part:release_name]
values =
  witty-warthog
  ridiculous-rat
  marvelous-mantis

可选值

默认值：值中的第一个条目

如果零件的值与此值匹配，则认为它是可选的，即。 它的表示形式是--不需要序列化的可能性。

示例：

[bumpversion]
current_version = 1.alpha
parse = (?P<num>\d+)\.(?P<release>.*)
serialize =
  {num}.{release}
  {num}

[bumpversion:part:release]
optional_value = gamma
values =
  alpha
  beta
  gamma

在这里，bump2version发行版将把1.alpha提升到1.beta。执行 bump2version发布版再次将bump1.beta提升到1，因为 releasebeinggamma配置为可选。

第一个值=

默认值：值中的第一个条目

当零件复位时，该值将被设置为此处指定的值。

配置文件—特定于文件的配置

此配置位于以下部分：[bumpversion:file:…]

parse=

默认值：（？p<；主要>；\d+。（？p<；次要的>；\d+。（？p<；修补程序>；\d+

正则表达式（使用python正则表达式语法rel="nofollow">python正则表达式语法 如何查找和分析版本字符串。

要求Parse由serialize=生成的所有字符串。命名匹配 组（"（？p<；name>；…）"）将值提供给作为部分的参数。

也可用作--parse

序列化=

默认值：{major}.{minor}.{patch}

指定如何将版本部分序列化回版本的模板 字符串，

这是使用python格式字符串语法的模板。 模板上下文中提供了命名组的解析值 在parse=以及所有环境变量（前缀为 $）。

可以多次指定，bumpversion将尝试序列化 格式从第一个开始，然后选择最后一个，所有值都可以 表示如下：

serialize =
  {major}.{minor}
  {major}

在上面的示例中，新版本1.9将被序列化为 1.9，但版本2.0将被序列化为2

也可用作--serialize。命令行中的多个值是 给定如下：--serialize{major}.{minor}--serialize{major}

搜索=

默认值：{当前版本}

模板字符串如何在文件中搜索要替换的字符串。 如果当前版本号 可能在文件中多次出现，而您的意思是只碰撞其中一个 发生。可以是多行，使用python格式字符串语法进行模板化

替换=

默认值：{新版本}

用于创建将替换中当前版本号的字符串的模板 文件。

鉴于此，requirements.txt：

Django>=1.5.6,<1.6
MyProject==1.5.6

使用这个.bumpversion.cfg将确保只有包含 myproject将被更改：

pip install --upgrade bump2version

pip install --upgrade bump2version

pip install --upgrade bump2version

pip install --upgrade bump2version

pip install --upgrade bump2version