setuptools-scm：当前版本而不是下一版本

Question

我想用setuptools-scm来控制我的包版本。我的 setup.py:

setuptools.setup(
...
    use_scm_version={'write_to': 'my-package/version.py'},
...
)

目前我的仓库中有 v0.2 标签。我创建了新分支并添加了一些提交。当我运行 python setup.py --version 创建 my-package/version.py 文件时，我得到下一个标签 v0.3 而不是当前 v0.2:

$ SETUPTOOLS_SCM_DEBUG=1 python3 setup.py --version
...
cmd 'git describe --dirty --tags --long --match *.*'
out b'v0.2-1-gb13420a\n'
cmd 'git rev-parse --abbrev-ref HEAD'
out b'feature-version-system\n'
tag v0.2
tag 'v0.2' parsed to {'version': 'v0.2', 'prefix': '', 'suffix': ''}
version pre parse v0.2
version <Version('0.2')>
version v0.2 -> 0.2
scm version <ScmVersion 0.2 d=1 n=gb13420a d=False b=feature-version-system>
config {'version_scheme': 'guess-next-dev', 'local_scheme': 'node-and-date'}
ep ('setuptools_scm.version_scheme', 'guess-next-dev')
ep found: guess-next-dev
ep ('setuptools_scm.local_scheme', 'node-and-date')
ep found: node-and-date
version 0.3.dev1
local_version +gb13420a
0.3.dev1+gb13420a  # <- I want to see 0.2.dev1+gb13420a here

$ git tag

v0.1
v0.2

我认为这是错误的方式，因为我正在进行的更改是针对当前版本标签 v0.2，但 setuptools_scm 说它们属于 v0.3。如何处理？

Answer 1

setuptools_scm 工作正常，因为它正在创建下一个版本的 pre-release。根据 PEP440 section on pre-releases:

The pre-release segment consists of an alphabetical identifier for the pre-release phase, along with a non-negative integer value. Pre-releases for a given release are ordered first by phase (alpha, beta, release candidate) and then by the numerical component within that phase.

他们还将示例显示为：

X.YaN   # Alpha release
X.YbN   # Beta release
X.YrcN  # Release Candidate
X.Y     # Final release

这意味着 0.3.dev1+gb13420a 是 0.3 的 pre-release 版本，位于 0.2 之后。 0.2.dev1+gb13420a 表示它是 0.2 的 pre-release，并且比 0.2.

早

Answer 2

一段时间以来，setuptools-scm 提供了使用 post-release 方案的选项，请参阅 setuptools_scm.version_scheme section。然后 python setup.py --version 和 git describe --tag 将为您提供相同的信息（尽管格式不同）。要切换到 post-release 方案，请在 setup.py 中包含以下行：

setup(...
      use_scm_version={'version_scheme': 'post-release'},
      ...
      )

setuptools-scm：当前版本而不是下一版本

setuptools-scm: current version instead of next version

python

git

version-control

setuptools

setuptools-scm