跳转到主要内容

由setuptools_scm替代

项目描述

此模块是支持基于mercurial和git的项目中的setup.py的简单替换。

或者它可以是设置时间的要求。

它从scm中提取最后一个标签以及到它的提交距离,并使用这些信息来计算版本号

默认情况下,它将版本号的最后一个部分增加1,并在最后部分为.dev的情况下,在版本号后附加 .dev{distance},如果最后部分已经是 .dev,则版本号不变

这要求始终在标签中使用所有组件(即2.0.0而不是2.0),以避免错误地发布更高版本(即2.1.devX而不是2.0.1.devX)

它使用4种策略来完成其任务

  1. 直接询问hg获取标签/距离

  2. .hg_archival.txt文件推断它

  3. 如果存在,则读取缓存文件的准确版本

  4. 从由setup.py sdists生成的'PKG-INFO'文件中读取准确版本(这是一个令人讨厌的滥用)

最简单的用法是

from setuptools import setup
from hgdistver import get_version
setup(
    ...,
    version=get_version(),
    ...,
)

get_version接受可选参数cachefile,这将导致它将版本信息存储在Python脚本中,而不是滥用sdist中的PKG-INFO。

设置要求用法是

from setuptools import setup
setup(
    ...,
    get_version_from_hg=True,
    setup_requires=['hgdistver'],
    ...,
)

要求使用设置参数cache_hg_version_to而不是cachefile。

项目详情


下载文件

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

源分发

hgdistver-0.25.tar.gz (9.9 kB 查看哈希值)

上传时间

构建分发

hgdistver-0.25-py2.py3-none-any.whl (7.4 kB 查看哈希值)

上传时间 Python 2 Python 3

由以下支持