如何从给定存储库的 github API 获取最新标签值

Question

我可以使用以下命令从 GitHub api 获取最新提交：

$ curl 'https://api.github.com/repos/dwkns/test/commits?per_page=1'

但是，生成的 JSON 不包含对我在提交时创建的标签的任何引用。

我可以使用以下方法获取标签列表：

$ curl 'https://api.github.com/repos/dwkns/test/tags'

然而，生成的 JSON 虽然包含我想要的标签名称，但与它们的创建顺序不同 - 无法判断哪个标签是最新的。

编辑：创建的最新标签是LatestLatestLatest

我的问题是我需要执行哪些 API 调用才能获取存储库中最新标记的名称？

Answer 1

将jq与curl结合使用，您可以获得一个非常简单的命令：

curl -s \
  -H "Accept: application/vnd.github.v3+json" \
  https://api.github.com/repos/dwkns/test/tags \
  | jq -r '.[0].name' 

输出（截至今天）：

v56

jq命令说明：

• -r用于“raw”，避免在 jq 的输出中使用 json 引号
• .[0]选择我们从 github 获得的 json array的第一个（最新）标签object
• .name选择这个最新的 json object的name属性

Answer 2

#!/bin/sh
curl -s https://github.com/dwkns/test/tags |
awk '/tag-name/{print $3;exit}' FS='[<>]'

或者

#!/bin/awk -f    
BEGIN {
  FS = "[<>]"
  while ("curl -s https://github.com/dwkns/test/tags" | getline) {
    if(/tag-name/){print $3;exit}
  }
}

Answer 3

语义版本控制示例

注意：如果您很着急并且不需要解释所有细节，只需跳到“解决方案”并执行命令。

此解决方案使用curl和grep来匹配最新的语义版本号。 将使用我自己的 Github 存储库“ pi-ap ”（一堆 bash 脚本，可将 Raspberry Pi 自动配置为无线 AP）来演示一个示例。

您可以在 CLI 上测试我给您的示例，在您对它按预期工作感到满意后，您可以将其调整为您自己的用例。

版本控制格式构建：

由于我们使用grep来匹配版本号，因此我需要解释它的构造。 由 2 个点分隔并以“v”开头的 3 对整数：

vXX.XX.XX
 ^  ^  ^
 |  |  |
 |  |  Patch
 |  Minor
 Major

注意：如果一个字段只有一个数字，我会用零填充它以确保结果格式是可预测的：总是 3 对整数，由 2 个点分隔。

解决方案：

Github 用户名： F1Linux
Github Repo 名称： pi-ap （注意：排除“ .git ”后缀）

curl -s 'https://github.com/f1linux/pi-ap/tags/'|grep -Eo "$Version v[0-9]{1,2}.[0-9]{1,2}.[0-9]{1,2}"|sort -r|head -n1

验证结果正确：

在浏览器中，转到：

https://github.com/f1linux/pi-ap/tags

并验证从命令返回的最新标记。

对于大多数用例，上述内容是相当可扩展的。 如果您在标记您的存储库时不使用此约定，只需要更改用户和存储库名称并删除/替换“v”。