跳转到主要内容

从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手册中有详细说明

https://docs.pythonlang.cn/dist/dist.html

要使用setuptools而不是distutils,只需编辑setup.py并更改

from distutils.core import setup

to

from setuptools import setup

参考资料

如何使用Distutils分发Python模块

https://docs.pythonlang.cn/dist/dist.html

Setuptools完整手册

http://peak.telecommunity.com/DevCenter/setuptools

感谢Yannick Gingras为这个README.rst提供的原型。

项目详情


下载文件

下载适合您平台的文件。如果您不确定要选择哪一个,请了解更多关于安装包的信息。

源分布

darcsver-1.7.4.tar.gz (8.9 kB 查看哈希)

上传时间

由以下支持