incremental 24.7.2

使用setuptools

将Incremental添加到您的pyproject.toml

[build-system]
requires = [
    "setuptools",
    "incremental>=24.7.2",  # ← Add incremental as a build dependency
]
build-backend = "setuptools.build_meta"

[project]
name = "<projectname>"
dynamic = ["version"]     # ← Mark the version dynamic
dependencies = [
    "incremental>=24.7.2",  # ← Depend on incremental at runtime
]
# ...

[tool.incremental]        # ← Activate Incremental's setuptools plugin

如果[tool.incremental]表为空，则没关系，但它必须存在。

删除任何 [项目] 版本 = 条目和任何 [tool.setuptools.dynamic] 版本 = 条目。

接下来，初始化项目。

使用Hatchling

如果您使用 Hatchling 打包项目，通过修改您的 pyproject.toml 来激活 Incremental 的 Hatchling 插件。

[build-system]
requires = [
    "hatchling",
    "incremental>=24.7.2",  # ← Add incremental as a build dependency
]
build-backend = "hatchling.build"

[project]
name = "<projectname>"
dynamic = ["version"]     # ← Mark the version dynamic
dependencies = [
    "incremental>=24.7.2",  # ← Depend on incremental at runtime
]
# ...

[tool.hatch.version]
source = "incremental"    # ← Activate Incremental's Hatchling plugin

Incremental 可以在可选的 [tool.incremental] 表中像往常一样进行配置。

hatch version 命令将报告 Incremental 管理的版本。使用 python -m incremental.update 命令来更改版本（不支持使用 hatch version 设置版本）。

接下来，初始化项目。

使用setup.py

Incremental 可以在 setup.py 中使用，而不是 pyproject.toml。将此添加到您的 setup() 调用中，删除任何其他版本参数

setup(
    use_incremental=True,
    setup_requires=['incremental'],
    install_requires=['incremental'], # along with any other install dependencies
    ...
}

然后 初始化项目。

初始化项目

使用 pip install incremental[scripts] 在您的本地环境中安装 Incremental。然后运行 python -m incremental.update <项目名称> --create。它将在您的包中创建一个名为 _version.py 的文件，如下所示

from incremental import Version

__version__ = Version("<projectname>", 24, 1, 0)
__all__ = ["__version__"]

然后，为了让项目用户找到您的版本，在您的根包的 __init__.py 中添加

from ._version import __version__

随后安装的项目将使用 Incremental 进行版本管理。