跳转到主要内容

从git历史中获取版本信息的工具

项目描述

一个简单的工具,用于从git标签中提取版本信息,并可选地使用post-release提交信息进行格式化。

版本标签可以可选地使用 v 前缀,并可以包含预发布版本。

安装

从PyPI安装

pip install vergit

使用方法

完整使用方法

vergit [-h] [--format {long,short,default,json}] [path]

可以省略 path,默认为当前目录。

可以使用几种不同的格式

  • long 总是包含git修订信息。

  • short 永远不包含git修订信息,只包含发布版本。

  • default 如果在预发布或发布后有提交,则使用长格式,否则使用短格式。

  • json 输出描述版本的JSON数据。

示例

如果当前提交标记为 v1.0.0

$ vergit
1.0.0

$ vergit --format short
1.0.0

$ vergit --format long
1.0.0+git-0-123abcd

$ vergit --format json
{"version": "1.0.0", "git": "+git-0-123abcd", "gitn": "0", "gitsha": "123abcd", "pre_release": false}

如果当前提交之前的提交标记为 1.0.0

$ vergit
1.0.0+git-1-123abcd

$ vergit --format short
1.0.0

$ vergit --format long
1.0.0+git-0-123abcd

$ vergit --format json
{"version": "1.0.0", "git": "+git-1-123abcd", "gitn": "1", "gitsha": "123abcd", "pre_release": false}

如果当前提交标记为 v1.0.0rc1

$ vergit
1.0.0rc1+git-0-123abcd

$ vergit --format short
1.0.0rc1

$ vergit --format long
1.0.0rc1+git-0-123abcd

$ vergit --format json
{"version": "1.0.0rc1", "git": "+git-0-123abcd", "gitn": "0", "gitsha": "123abcd", "pre_release": true}

项目详情


下载文件

下载适用于您平台的应用程序。如果您不确定选择哪个,请了解更多关于 安装包 的信息。

源代码分发

vergit-1.0.2.tar.gz (3.2 kB 查看哈希值)

上传时间 源代码