Bumpversion 高级技巧：实现可选的开发版本后缀

本教程将详细介绍如何使用 Bumpversion 工具为应用程序版本号任选的开发版本（dev）后缀。通过巧妙地配置 dev 版本部分的值列表，我们能够解决凹凸版本在处理单值部分时的限制，从而实现灵活的版本管理，允许在标准版本号后连接或简化 dev 添加构建号，有效提升版本控制的前缀。的版本部分机制处理

Bumpversion是一个强大的版本管理工具，它通过解析（parse）当前版本字符串，识别出不同的版本部分（如major、minor、patch、dev、build等），然后根据用户指令递增或修改特定部分，最后再将这些部分序列化（serialize）成新的版本字符串。

在bumpversion的配置中，我们可以为每个版本部分定义一个值列表，指定该部分可能包含的所有合法值。当bumpversion尝试递增某些部分时，它会在该部分的值 列表中查找当前值，并尝试将其替换为列表中的下一个值。

然而，当一个版本部分（例如 dev）的值列表中只包含一个值时，bumpversion 认为其已达到该部分的“顶点”。在这种情况下，如果你尝试该部分执行凹凸操作，bumpversion 会导出 ValueError：该部分已经是最大值...错误，因为它认为没有下一个值可以递增。对于这实现“任选”的dev 版本后缀（即有时需要 dev 后缀，有时不需要）构成了挑战。解决方案：引入空值作为初始状态

为了实现任选的 dev 版本后缀，我们需要“欺骗”bumpversion，认为使 dev 部分在未指定时也有一个“前一个”状态。最简单有效的方法是，在 [bumpversion：part：dev] 配置的值列表中，将第一个元素设置为空字符串""。

示例配置：[bumpversion]current_version = 1.5.3parse = (?Plt；majorgt；\d )\.(?Plt；minorgt；\d )\.(?Plt；patchgt；\d )(-(?Plt；devgt；.*)-(?Plt；buildgt；\d ))?serialize = {major}.{minor}.{patch}-{dev}-{build} {major}.{minor}.{patch}[bumpversion：part：dev]values = quot；quot； dev[bumpversion：part：build]first_value = 1 登录后复制

配置解析：

[bumpversion] 部分：current_version：应用程序的当前版本。parse：这是一个正则表达式，用于解析版本字符串。(?P\d )\.(?P\d )\.(?P\d )：匹配主、次、补丁版本号。(-(?P.*)-(?P\d ))?：这是一个关键部分。? 使整个 (-(?P.*)-(?P\d )) 部分成为任选的。

这意味着bumpversion可以匹配1.5.3这样的版本，也可以匹配1.5.3-dev-1这样的版本。(?P.*)：捕获dev部分的任意字符定义。(?P\d)：捕获构建部分的数字。serialize：了如何将解析出的版本部分组合字符串。{major}.{minor}.{patch}-{dev}-{build}：用于生成带dev和build后缀的版本。{major}.{minor}.{patch}：用于生成不带后缀的标准版本。bumpversion会尝试匹配最后的序列化格式，如果dev和build部分为空，则匹配第二个格式。

[bumpversion：part：dev]部分：values = ""\n dev：核心继承。通过将""作为dev部分的第一个值，bumpversion在初始状态（即版本号不带 dev 后缀时，dev 部分被解析为空字符串）下，会认为 dev 部分当前有一个 ""

[bumpversion：part：build] 部分：first_value = 1：定义build部分的初始值。工作原理深入解析

当current_version为1.5.3时则：bumpversion使用parse正表达式解析1.5.3。由于(-(?P.*)-(?P\d ))? 部分是任选的，dev 和 build 部分会被解析为空。此时，dev 部分的内部状态被为“”。当你执行bumpversion dev 命令时，bumpversion 会查找 [bumpversion：part：dev] 配置中的值列表。它发现“”是列表中的第一个值，而 dev 是下一个值。因此，bumpversion 可以成功删除 dev 部分从“”递增到 dev，同时将 build 部分初始化为first_value（即1）。最终生成1.5.3-dev-1这样的版本号。

重要提示：bumpversion的版本递增通常是非循环的。这意味着一旦dev部分从“”到dev，你就无法通过bumpversion dev命令再将其变回“”。要回到标准版本，你需要手动编辑current_version或使用其他bumpversion命令（如bumpversion patch等），这些命令在序列化时会选择不包含dev和 build 的格式。

实际操作示例

假设bumpversion.cfg按照上述配置：

初始状态：current_version = 1.5.3执行bumpversion dev结果：current_version = 1.5.3-dev-1 (或 1.5.3-dev-1 build 如果部分被bump到1)

在开发版本上逐步构建号：current_version = 1.5.3-dev-1执行bumpversion build结果：current_version = 1.5.3-dev-2

在开发版本上递增补丁号（会重置dev和build）：current_version = 1.5.3-dev-2执行bumpversion patch结果：current_version = 1.5.4（注意dev和build部分被移除，因为它们不是patch的子部分，并且在化序列时，不带dev和build的格式被选择)

再次进入开发版本：current_version = 1.5.4执行bumpversion dev结果：current_version = 1.5.4-dev-1注意事项正则表达式的精确性：确保解析正则表达式能够正确符合你期望的所有版本格式，特别是任选部分的逗号和问号。序列化顺序：序列化列表的顺序很重要。bumpversion会尝试匹配第一个能完全填充所有结果组的序列化格式。如果dev和build部分为包含空，它会退回到不包含它们的序列化格式。非循环性：明确此方法是为了从无dev主要后缀状态“进入” dev 后缀状态。要从 dev 后缀状态“退出”到无后缀状态，通常需要通过递增更高级别的版本部分（如 patch、minor、major）进行修改，或者手动 current_version。first_value 的使用：first_value 属性对于像构建这样的数字递增部分非常有用，它定义了该部分在第一次出现时的起始值。

通过上述配置和理解，您可以灵活使用 Bumpversion管理标记任选开发版本后缀的项目版本，从而更好地适应不同的发布和开发流程。

以上就是Bumpversion 高级技巧：实现可选的开发版本后缀的详细内容，更多请关注乐哥常识网其他文章！