跳转到主要内容

处理VCS存储库的设施

项目描述

https://img.shields.io/pypi/v/jaraco.vcs.svg https://img.shields.io/pypi/pyversions/jaraco.vcs.svg tests Ruff https://img.shields.io/badge/skeleton-2024-informational

用法

jaraco.vcs提供用于检查和使用Mercurial和Git版本控制系统(VCS)存储库的类。

提供的类设计为使用子进程调用,以利用VCS工具的命令行界面(hg和git)。存在Mercurial的进程内Repo,但由于在特定环境中运行时出现的问题(特别是setuptools沙盒化),已禁用。

自动版本编号

此项目添加了对从开发中的源代码存储库自动生成项目版本号的支持。

要使用此功能,项目必须遵循以下假设

  • 使用存储库标签来指示已发布版本。

  • 标签名称指定为版本(即0.1或v0.1,而不是release-0.1)

  • 目前,已发布版本必须符合packaging中的版本。不匹配此方案的任何标签都将被忽略。

之后,使用Repo.get_current_version确定本地代码的版本。如果当前修订版带有有效的版本,则将使用该版本。否则,将在存储库中搜索标签,找到最新的发布版本,函数将推断即将发布的版本。

例如,如果存储库包含标签0.1、0.2和0.3,并且存储库不在这些标签上,则get_current_version将返回‘0.3.1dev’,而get_current_version(increment=’0.1’)将返回‘0.4dev’。

示例

>>> import jaraco.vcs
>>> jaraco.vcs.repo().get_current_version()
'9.0.1.dev0'

项目详情


下载文件

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

源代码分发

jaraco_vcs-2.4.0.tar.gz (17.2 kB 查看哈希值)

上传时间 源代码

构建分发

jaraco.vcs-2.4.0-py3-none-any.whl (9.9 kB 查看哈希值)

上传时间 Python 3