Python项目中的一致版本控制

Question

我有一个Python项目,它有Sphinx文档和distutils用于发布到Pip.

这两个功能都需要一个版本(例如,0.4b3)

是否有最佳实践可以在需要版本号的各种实用程序中自动维护一致的版本号？

作为奖励,是否有任何与git集成的东西(例如,通过标签)？

Answer 1

这是一个未经测试的答案，但我想在脚本中使用 sphinx 可以很容易地做到这一点conf.py。由于此脚本只是 Python，因此您可以执行以下操作：

import subprocess

...

path_to_source = "../src"
release = subprocess.check_output(["git", "rev-parse", "HEAD"], cwd=path_to_source)
version = subprocess.check_output(["git", "describe", "--tags", "HEAD"], cwd=path_to_source)

当然，您可能希望对命令的输出进行一些字符串处理，以按照您的需要进行一些错误检查，但基本思想应该成立。

正如我所说，我还没有测试过这个，所以我可能完全错误，所以如果你发现这个想法有问题，请告诉我。