【发布时间】:2012-05-25 20:40:59
【问题描述】:
如何从(未签出的)远程仓库中获取最后一个标签?
在我的本地副本上,我使用describe
git describe --abbrev=0 --tags
但我不能将describe 与远程存储一起使用
【问题讨论】:
标签: git git-tag git-describe
如何从(未签出的)远程仓库中获取最后一个标签?
在我的本地副本上,我使用describe
git describe --abbrev=0 --tags
但我不能将describe 与远程存储一起使用
【问题讨论】:
标签: git git-tag git-describe
使用git ls-remote,您可以从远程存储库获取引用列表。
要查看最新版本是什么,请查看以下输出的最后一行:
git -c 'versionsort.suffix=-' ls-remote --tags --sort='v:refname' <repository>
仅输出使用Semantic Versioning的存储库的最新标签(例如在shell脚本中)使用:
git -c 'versionsort.suffix=-' \
ls-remote --exit-code --refs --sort='version:refname' --tags <repository> '*.*.*' \
| tail --lines=1 \
| cut --delimiter='/' --fields=3
对于没有 --sort 标志(pre v2.18)的旧版本 Git,或不支持 versionsort.suffix(pre v2.4)的版本,请使用:
git ls-remote --refs --tags <repository> \
| cut --delimiter='/' --fields=3 \
| tr '-' '~' \
| sort --version-sort \
| tail --lines=1
没有--version-sort 标志的旧版本sort 超出了此问题的范围...
使用--tags 确保列表只包含标签引用。
这将包括引用和取消引用的标签。这意味着某些标签的引用名末尾会有^{}。 (有关更多信息,请参阅this question elsewhere on StackOverflow。)
对于人类消费来说这并不重要,但如果你不想看到那些^{}'s add --refs。
可以使用--sort 对引用列表进行排序。
排序选项使用与git for-each-ref 相同的排序键。由于我们在本地没有所有信息,因此并非所有选项都可供我们使用(例如与日期相关的排序键)。
我们想使用版本排序,基于参考名称。为此,我们使用version:refname 键。这也可以缩写为v:refname。
这将对版本进行升序排序,这意味着最新版本将是最后一个。
要反转列表,请在排序键前添加-:--sort='-v:refname'。
此时,version-sort 会将候选版本(例如 v2.28.0-rc2)放在他们应该在前面的稳定版本之后。
从 v2.12 开始,我们可以 use a configuration flag 告诉 Git 对具有特定字符后缀的引用名称进行排序 没有该字符后缀的引用:git -c 'versionsort.suffix=-'。
要始终像这样使用versionsort.suffix,可以全局设置:
git config --global 'versionsort.suffix' '-'
在 v2.4 和 v2.12 之间,该标志称为 versionsort.prereleaseSuffix。
对于较旧的 Git 版本,可以使用一个技巧:破折号 - 排序 之前 空格 但波浪号 ~ 排序 之后一个空格。
因此,通过将破折号 - 替换为波浪号 ~,事情会以正确的顺序排序。这可以使用tr '-' '~'来完成
由于我们并不真正关心所有输出,除了最后一行,我们只显示尾部:tail --lines=1。当然,如果列表按降序检索(使用--sort='-v:refname'),则为:head --lines=1。
ls-remote 命令的输出还输出引用hash:
ada126bd28d66c8c8ff5966a52d63ce2c9e4d031 refs/tags/v2.28.0-rc0
要只看到实际的标签(即引用名称),我们可以剪切该行的第一部分:cut --delimiter='/' --fields=3
最后要注意的是,ls-remote 可以被赋予一个过滤器以仅显示与过滤器模式匹配的引用。例如,对于语义版本控制,我们可以使用:'*.*.*'。与该模式不匹配的任何内容都不会显示。
如果存储库始终以 v 为版本标记添加前缀,则可以进一步缩小到 'v*.*.*'。
另一个例子是只检索特定主版本的最新标签。例如,要仅查看 repo 版本 2 的标签,我们可以使用 'v2.*'。
请确保在过滤器周围使用引号,否则* 会给您带来麻烦!
使用过滤器时最好使用--exit-code 标志。
这是因为 Git 将始终以状态码 0 退出,以表明它已成功与远程存储库通信。
对于人类来说,这很好,如果找到任何参考,您将在屏幕上看到。
但是,如果在 shell 脚本中使用此代码,则可能会出现问题。
当在远程存储库中找不到匹配的引用时,可以告诉 Git 使用状态码 2。这是通过使用--exit-code 标志来完成的。
这样脚本会知道什么时候出错了!
显然,如果不使用过滤器,使用--exit-code 并没有真正意义。
假设我们想知道 Git 的最新标签是什么。
我们会这样做:
git ls-remote --sort='version:refname' --tags https://github.com/git/git.git
这将返回一个包含所有标签的长列表,如下所示(为了理智而截断)。
...
4c8bcdda4d6e4757caf876ddc401b5392e874e21 refs/tags/v2.28.0
ada126bd28d66c8c8ff5966a52d63ce2c9e4d031 refs/tags/v2.28.0-rc0
bd42bbe1a46c0fe486fc33e82969275e27e4dc19 refs/tags/v2.28.0-rc0^{}
49bfe36405d1631a303992cac5cc408980a0454e refs/tags/v2.28.0-rc1
3ddac3d691c3633cd4d9a74c07e3b2301f546f77 refs/tags/v2.28.0-rc1^{}
84a0d5cc2107b83a791aa4034cc54874e1d50668 refs/tags/v2.28.0-rc2
b066807397fd55553f4910ede74839e319b661fd refs/tags/v2.28.0-rc2^{}
47ae905ffb98cc4d4fd90083da6bc8dab55d9ecc refs/tags/v2.28.0^{}
这告诉我们最新的标签是v2.28.0。
另一个例子是全局设置versionsort.suffix,然后只获取最后一个标签:
git config --global 'versionsort.suffix' '-'
git ls-remote --refs --sort=':refname' --tags https://github.com/git/git.git \
| tail --lines=1 | cut --delimiter='/' --fields=3
现在,让我们看看是否已经有 Git 3 版!
$ git ls-remote --exit-code --refs --tags https://github.com/git/git.git 'v3.*'
$ echo $?
2 # nope, not yet
【讨论】:
| awk -F/ '{ print $3 }'
- 将颠倒顺序,例如--sort="-version:refname"
不幸的是,git ls-remote --tags 实际上是按字母顺序列出标签的(至少从 1.7.2.5 开始)。因此,在 1.7.10、1.7.11 或 1.7.12 是最新标签时,1.7.9 将是列表中的最后一个:
git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."
[...]
bf68fe0313c833fa62755176f6e24988ef7cf80f refs/tags/v1.7.9.6
cb2ed324fc917db0b79d7b1f3756575ffa5f70d5 refs/tags/v1.7.9.6^{}
3996bb24c84013ec9ce9fa0980ce61f9ef97be4d refs/tags/v1.7.9.7
d0f1ea6003d97e63110fa7d50bb07f546a909b6e refs/tags/v1.7.9.7^{}
但是,我们可以通过“排序”来管道这些结果,以更接近我们正在寻找的结果:
git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."| sort -g -k3 -t.
[...]
eab05abaeb51531e11835aaa4c26564a1babebac refs/tags/v1.7.9-rc2
eac2d83247ea0a265d923518c26873bb12c33778 refs/tags/v1.7.9-rc0^{}
f59f511e26b4924b22c6966e79fe4f754bc81dc6 refs/tags/v1.7.9.2
0e2d57fd50f61e668be3180bc8f25991ea88aa8c refs/tags/v1.7.10-rc1^{}
121f71f0da1bc9a4e1e96be2c3e683191a82a354 refs/tags/v1.7.10.4^{}
26e5c5d09334d157bd04f794f16f6e338d50c752 refs/tags/v1.7.10.3^{}
[...]
cffb45719f60d6fc2cc98ead6af88a895c63c9ac refs/tags/v1.7.12.4
d8cf053dacb4f78920c112d10c7be21e4f5a5817 refs/tags/v1.7.12.2^{}
dcd07fb6262fd8bb9f531890df3986a8b719a0b5 refs/tags/v1.7.12-rc0
e15c16de396a1e1f42001b03cb885ce64eb4098e refs/tags/v1.7.12-rc2^{}
虽然仍然不正确,但它更接近。如果我们排除 -rc 和 ^{},并在最后一个子版本号上添加一个额外的排序,我们可能可以满足大多数需求:
git ls-remote --tags git://github.com/git/git.git |grep "1\.7\."|grep -v -|grep -v {| sort -n -t. -k3 -k4
23ed9debf17263ed6bed478a4d6d86e71342c18a refs/tags/v1.7.11.6
527b331100ddba839cc54bb31c1bcd66acc08321 refs/tags/v1.7.11.7
14d20a75e3d57a872a8c81ae90dcc4c61ddba011 refs/tags/v1.7.12
51993a414a76120fda20d56ba767fa513d9ff440 refs/tags/v1.7.12.1
04043f4d1ae42bddee67d354a2e6fd2464592a1e refs/tags/v1.7.12.2
b38da673be332933b8f3a873ce46ffea08d2ee2c refs/tags/v1.7.12.3
cffb45719f60d6fc2cc98ead6af88a895c63c9ac refs/tags/v1.7.12.4
【讨论】:
git ls-remote --tags "#{github_repo}" | awk '{print $2}' | grep -v '{}' | awk -F"/" '{print $3}' | sort -n -t. -k1,1 -k2,2 -k3,3 | tail -n 1.chomp
【讨论】:
这是我的单线:-)
git ls-remote --tags --refs --sort="version:refname" git://github.com/git/git.git | awk -F/ 'END{print$NF}'
【讨论】:
从版本2.18 git has 开始,一个内置的--sort 选项用于对引用名称进行排序。
所以最新的命令是
git ls-remote --tags --sort="v:refname" git://github.com/git/git.git | tail -n1
要同时删除哈希和取消引用标记 (^{}),只需输入一些简单的 sed
git ls-remote --tags --sort="v:refname" git://github.com/git/git.git | tail -n1 | sed 's/.*\///; s/\^{}//'
根据@Frederik Nord 的建议,您还可以使用--refs 开关来摆脱^{},只留下一个sed 命令(使oneliner 缩短4 个字符):
git ls-remote --tags --refs --sort="v:refname" git://github.com/git/git.git | tail -n1 | sed 's/.*\///'
# output: v2.18.0
对于2.18 之前的git 版本,这是通过sort 进行管道输出的组合
git ls-remote --tags git://github.com/git/git.git | sort -t '/' -k 3 -V | awk -F/ '{ print $3 }' | awk '!/\^\{\}/' | tail -n 1
【讨论】:
--refs 是否有助于删除一个 sed 命令,即删除 {}?
% git -c 'versionsort.suffix=-' ls-remote -t --exit-code --refs --sort=-v:refname \
https://github.com/robert7/nixnote2 'v*' \
| sed -En '1!q;s/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/gp'
v2.1.0-beta4g
将--refs 传递给git ls-remote 以摆脱其他答案中显示的{} 参考:
$ git ls-remote -t --refs <URL>
这会给出如下输出:
8f235769a2853c415f811b19cd5effc47cc89433 refs/tags/continuous
24e666ed73486a2ac65f09a1479e91e6ae4a1bbe refs/tags/continuous-develop
7c2cff2c26c1c2ad4b4023a975cd2365751ec97d refs/tags/v2.0
35b69eed46e5b163927c78497983355ff6a5dc6b refs/tags/v2.0-beta10
要仅获取标签名称,请通过:
sed -E 's/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/g':
$ git ls-remote -t --exit-code --refs https://github.com/robert7/nixnote2.git \
| sed -E 's/^[[:xdigit:]]+[[:space:]]+refs\/tags\/(.+)/\1/g'
continuous
continuous-develop
v2.0
v2.0-beta10
然后,您可以通过适当的 grep 和/或 head -n1 传递清理后的列表(如果您希望保持较低的 PID 编号,也可以添加到您的 sed 命令中。)
建议:
'v*',如果所有版本标签都以v开头。--exit-code 以确保在没有返回匹配的引用时退出非0。https:// 版本:它更快,并且如果您正在打包,您不想冒被要求提供 ssh 密钥的风险。--sort=-v:refname 按版本而不是按字典排序,最大的版本位于顶部git -c versionsort.suffix=- 防止2.0-rc 出现在“之后”2.0
【讨论】:
对于 Git 不支持ls-remote --sort:
用法:git ls-remote [--heads] [--tags] [-u | --上传包 ] [-q|--quiet] [--exit-code] [--get-url] [ [...]]
要列出最新的标签,以及较旧的 Git 版本,请使用内置的 sort 命令。
打印标签,按第二列的版本号排序(倒序):
git ls-remote --tags $my_repo | sort -Vr -k2
...哈希 id... refs/tags/v0.10.0-rc0
...哈希 id... refs/tags/v0.9.0-rc0
...哈希 id... refs/tags/v0.9.0
...哈希 id... refs/tags/v0.8.1
...哈希 id... refs/tags/v0.8.0-rc1
使用grep获取特定版本的最新标签(例如最新的0.8版本):
git ls-remote --tags $my_repo | sort -Vr -k2 | grep -Po -m 1 "tags/\K.*0.8.*"
v0.8.1
【讨论】: