符合PEP440的规范和git描述可从已部署包中获取的信息

Question

我想使用与PEP440兼容的版本标识，但要包含git信息：

$ git describe --long
4.1-202-gab0f789

在PEP 440中有一章是关于dvc的，但是我不清楚.devN后缀如何容纳像上面这样的非数字哈希：ab0f789。我需要一种从生产脚本中请求4.1-202-gab0f789信息的方法，那么setup.py我可以将项目元数据放在哪里？

Answer 1

该部分告诉您不要使用哈希：

由于无法可靠地订购哈希，因此在公共版本字段中不允许使用此类版本。

强调我的。

他们提供.devN了替代方案。如果您打算从一个Git仓库释放开发人员的版本，数他们，所以.dev0，.dev1等你可以使用标签来追踪这些版本，并跟踪他们回到具体的修改意见。

但是，如果您继续阅读，有一种方法可以将哈希作为本地版本号添加：

标识哈希信息也可以包括在本地版本标签中。

添加+，然后添加您的哈希：

4.1.dev0+gab0f789

但是，本地版本号仅应在创建本地非索引打包或项目安装时使用。例如，不要+<hash>在PyPI上放置版本。但是，如果您要从持续集成服务器生产软件包以供开发人员进行测试，则可以使用本地版本号。