从darcs历史中生成版本号
项目描述
我需要一个新的维护者!
Darcsver需要一个新的维护者。原始作者Zooko Wilcox-O’Hearn除非有意外需要,否则不打算对其进行进一步更改。
它做什么
根据最新的darcs发布标签创建包含版本号的文件。
如果您的源树来自darcs(即它位于darcs存储库中),此工具将确定最新的发布标签,计算自那时以来应用的所有补丁,并计算要写入_version.py(以及可选的其他版本文件)的版本号。此版本号可通过以下方式获得
from your_package_name import __version__
不来自darcs(例如,发布tar包,夜间tar包)且不在darcs存储库中的源树应包含一个在制作tar包之前生成的_version.py。在这种情况下,此工具将静默退出而不会修改现有的_version.py。
‘发布标签’是源存储库中与以下正则表达式匹配的标签
^your_package_name-(d+)(.(d+)(.(d+))?)?((a|b|c|rc)(d+))?
安装
使用easy_install
easy_install darcsver
替代手动安装
tar -zxvf darcsver-X.Y.Z.tar.gz cd darcsver-X.Y.Z python setup.py install
其中X.Y.Z是版本号。
在不安装darcsver到系统中的情况下使用它的替代方案
在包的setup.py文件中调用setup()时,加入“setup_requires=[‘darcsver’]”。
使用方法
有两种方式使用它:命令行工具和setuptools插件。
要使用命令行工具,请按以下方式执行:
darcsver $PACKAGE_NAME $PATH_TO_VERSION_PY
要使用setuptools插件(它允许您编写“./setup.py darcsver”,并智能地确定_version.py文件应该放在哪里),您必须首先使用setup.py包装您的python模块,并使用setuptools。
前者在distutils手册中有详细说明
要使用setuptools而不是distutils,只需编辑setup.py并更改
from distutils.core import setup
to
from setuptools import setup
参考资料
如何使用Distutils分发Python模块
Setuptools完整手册
感谢Yannick Gingras为这个README.rst提供的原型。
项目详情
darcsver-1.7.4.tar.gz 的哈希
算法 | 哈希摘要 | |
---|---|---|
SHA256 | 66b1864999764459a61fb9048802309cde12b141cb6e1ef1c8c46fdce56061f9 |
|
MD5 | e38aecd1343ab8447888a479ab12cb59 |
|
BLAKE2b-256 | 6d9f8c9ea1786f6e3380bad6717438faae1445e1e2757f9ed3ef1621844c44d3 |