从DARCS历史记录生成版本号
darcsver的Python项目详细描述
我需要一个新的维修人员!
Darcsver需要一个新的维护人员原著作者佐科·威尔科克斯·奥赫恩, 不打算对它做进一步的修改,除非有一些意想不到的事情 必须这样做
它做什么
根据最新的DARC创建包含版本号的文件 释放标签
如果源树来自DARC(即,它在DARC中 存储库),此工具将确定最新的发布标记, 计算自那时起应用的修补程序,并计算 要写入_version.py的版本号(以及可选的其他 版本文件)。此版本号将通过以下操作提供:
from your_package_name import __version__
不是来自DARC的源树(例如,每晚释放tarballs tarballs)并且不在darcs存储库中,应该使用 _在生成tarball之前生成的version.py在这种情况下, 该工具将悄悄地退出,而不必修改现有的版本号。
“release tags”是源存储库中与以下内容匹配的标记 正则表达式:
^your_package_name-(d+)(.(d+)(.(d+))?)?((a|b|c|rc)(d+))?
安装
使用简易安装:
easy_install darcsver
替代手动安装:
tar -zxvf darcsver-X.Y.Z.tar.gz cd darcsver-X.Y.Z python setup.py install
其中x.y.z是版本号。
使特定包使用darcsver而不安装 darcsver进入系统:
Put “setup_requires=[‘darcsver’]” in the call to setup() in the package’s setup.py file.
用法
有两种使用方法:命令行工具和 设置工具插件
要使用命令行工具,请按以下方式执行:
darcsver$package_name$path_to_version_py
使用setuptools插件(允许您编写“./setup.py darcsver”和它巧妙地找出了 您必须首先使用 setup.py并使用setuptools。
前者在distutils手册中有详细记录:
http://docs.python.org/dist/dist.html
要使用setuptools而不是distutils,只需编辑setup.py 改变
from distutils.core import setup
到
from setuptools import setup
参考文献
如何使用distutils分发python模块:
http://docs.python.org/dist/dist.html
安装工具完整手册:
http://peak.telecommunity.com/DevCenter/setuptools
感谢Yannick Gingras提供的原型 自述文件。