CalVer

calver软件包是setuptools的一个扩展，用于自动将Python包版本定义为日历版本。

用法

首先，确保在项目的构建步骤中包含calver，将其指定为构建要求之一

pyproject.toml:

[build-system]
requires = ["setuptools>=42", "calver"]

要启用基于日期自动生成版本，请将以下内容添加到setup.py

setup.py:

from setuptools import setup

setup(
    ...
    use_calver=True,
    setup_requires=['calver'],
    ...
)

您可以使用以下命令测试其是否工作

$ python setup.py --version
2020.6.16

配置

默认情况下，当设置use_calver=True时，它使用以下内容生成版本字符串

>>> import datetime
>>> datetime.datetime.now().strftime("%Y.%m.%d")
2020.6.16

您可以通过传递格式字符串来覆盖它，而不是传递True

setup.py:

from setuptools import setup

setup(
    ...
    use_calver="%Y.%m.%d.%H.%M",
    setup_requires=['calver'],
    ...
)

您可以通过传递一个可调用来完全覆盖它，该可调用在构建时将不带参数调用

setup.py:

import datetime
from setuptools import setup

def long_now_version():
    now = datetime.datetime.now()
    return now.strftime("%Y").zfill(5) + "." + now.strftime("%m.%d")

setup(
    ...
    use_calver=long_now_version,
    setup_requires=['calver'],
    ...
)