2

Github 的tag 方法返回推送到你的仓库的所有标签的列表，最新的标签列在顶部。这是一个示例调用：https ://api.github.com/repos/ff0000/rosy/tags生成以下 json 对象。

[{
    name: "rbp-folder-rename",
    zipball_url: "https://api.github.com/repos/ff0000/rosy/zipball/rbp-folder-rename",
    tarball_url: "https://api.github.com/repos/ff0000/rosy/tarball/rbp-folder-rename",
    commit: {
        sha: "09ebda2678d932a005fc86ab78f6c04eebdcd50d",
        url: "https://api.github.com/repos/ff0000/rosy/commits/09ebda2678d932a005fc86ab78f6c04eebdcd50d"
    }
},
{
    name: "2.0.10",
    zipball_url: "https://api.github.com/repos/ff0000/rosy/zipball/2.0.10",
    tarball_url: "https://api.github.com/repos/ff0000/rosy/tarball/2.0.10",
    commit: {
        sha: "fe284c7d461107d9d08d2d4dcb676759f9485fc1",
        url: "https://api.github.com/repos/ff0000/rosy/commits/fe284c7d461107d9d08d2d4dcb676759f9485fc1"
    }
},

// ....

{
    name: "2.1.5",
    zipball_url: "https://api.github.com/repos/ff0000/rosy/zipball/2.1.5",
    tarball_url: "https://api.github.com/repos/ff0000/rosy/tarball/2.1.5",
    commit: {
        sha: "db92baa49657b3c3d27b1475c415c19525cb2118",
        url: "https://api.github.com/repos/ff0000/rosy/commits/db92baa49657b3c3d27b1475c415c19525cb2118"
    }
}]

问题

  1. 此列表顶部似乎有最新的标签，然后是按时间倒序排列的以前标签的历史记录。为什么？第一个结果的排序与其他结果不同，这似乎很奇怪，也许我读错了？
  2. 有没有办法以编程方式检索仅应用于master分支的最新版本？我想以编程方式检索 repo 的最新稳定版本。

任何帮助/见解将不胜感激。

4

3 回答 3

2

获取最新版本号：

https://api.github.com/repos/user/repo/releases/latest

例如，对于这个 repo ( https://github.com/pyIDM/PyIDM )，你可以使用下面的 url：

https://api.github.com/repos/pyidm/pyidm/releases/latest

您将获得一个带有 tag_name=latest 版本的 json 文件

于 2020-10-29T01:45:25.957 回答
1

此列表顶部似乎有最新的标签，然后是按时间倒序排列的以前标签的历史记录。

您不应该依赖 GitHub API 返回标签的顺序，因为没有时间戳，并且 repo 贡献者可能使用了不一致的标签名称，例如v1.9.0和2.5.14. 在该特定示例中，v1.9.0将首先显示 - 请参阅此 repo。

您应该让维护者使用一致的标签（example），并根据semver规则对 GitHub 的输出进行排序。由于这些规则很重要（请参阅该链接的第 11 点），因此最好使用semver 库（为浏览器移植）。

var gitHubPath = 'ff0000/rosy';  // your example repo
var url = 'https://api.github.com/repos/' + gitHubPath + '/tags';

$.get(url).done(function (data) {
  var versions = data.sort(function (v1, v2) {
    return semver.compare(v2.name, v1.name)
  });
  $('#result').html(versions[0].name);
});
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<script src="https://rawgit.com/hippich/bower-semver/master/semver.min.js"></script>
<p>Latest tag: <span id="result"></span></p>

获取最新的“稳定”版本

GitHub 版本有一个prerelease标志，可以是真或假。如果您将“稳定”定义为prerelease: false，那么您可以获取版本、过滤prerelease: false和排序。

var gitHubPath = 'idorecall/selection-menu';  // your example repo doesn't have releases
var url = 'https://api.github.com/repos/' + gitHubPath + '/releases';

$.get(url).done(function (data) {
  var releases = data.filter(function (release) {
    return !release.prerelease;
  })
  releases = releases.sort(function (v1, v2) {
    return Date.parse(v2.published_at) - Date.parse(v1.published_at);
  });
  console.log(releases[0]);
  $('#result').html(releases[0].name);
});
<script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
<p>Latest release name: <span id="result"></span></p>

于 2015-09-02T00:11:02.300 回答
0

您可以简单地将标签替换为分支名称：

https://api.github.com/repos/ff0000/rosy/zipball/master

请参阅“无论如何以编程方式获取私有 github 存储库的 zipball？ ”中该查询的更一般形式（对于给定分支）。

但这假设一个 repo 的最新稳定版本在master（它可能是最新的“开发”，在它编译并通过基本单元测试的事实之后可能不是很稳定）：每个项目都可以有自己的约定。

对于它的价值，https://api.github.com/repos/ff0000/rosy/branches会列出同一个 repo 的分支。

于 2013-02-14T06:41:18.440 回答