hatch-calver

用于hatch以支持日历版本控制的插件。

设置

将hatch-calver添加为项目的构建依赖。

[build-system]
requires = [
    "hatchling",
    "hatch-calver",
]
build-backend = "hatchling.build"

然后，将tool.hatch.version.scheme设置为"calver"。

[tool.hatch.version]
scheme = "calver"

配置CalVer方案

您可以选择将calver-scheme设置为calver方案规范中指定的点分隔的字符串形式的各个部分。默认为YYYY.MM.DD。

[tool.hatch.version]
scheme = "calver"
calver-scheme = "YY.MM"

请注意，您项目的版本应遵守您指定的方案；否则，例如确定补丁版本放置的位置将相当模糊。

使用方法

您可以使用Hatch的标准版本控制命令。

要将项目的版本更新到当前日期，运行hatch version release（或hatch version date）。

与常规版本控制方案一样，您可以链式更新多个部分。除非您明确指定，版本中的日期部分将不会更新。

为您的项目指定的CalVer方案指定了PEP 440 "发布"段中哪个部分是自动确定的；例如，对于YYYY.MM.DD方案，发布段中的第4字段将视为patch字段。

换句话说，如果您指定YYYY.MM.DD作为您的方案，并且今天是2024年9月16日

版本历史

2024.9.17

• 初始发布

2024.9.26

• 修改了date/release升级说明以重置任何非日期段。换句话说，从2024.07.22.1升级到2024.09.16.1的release不再发生。