CalVer

calver-pinning 包是 setuptools 扩展，用于自动将Python包版本定义为日历版本。

这是原始 calver 的分支。

用法

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

pyproject.toml:

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

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

setup.py:

from setuptools import setup

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

您可以使用以下方法测试它是否正常工作

$ 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-pinning'],
    ...
)