如何在不下载整个文件的情况下从GitHub API获取"sha"参数？

Question

我一直在尝试使用GitHub API更新GitHub存储库中的文件,同时只有该文件的路径.我的计划是第一个,获取如下所述的文件内容:https://developer.github.com/v3/repos/contents/,然后使用"sha"字段"更新文件".

它的工作正常,如答案中所述如何找到Github文件的SHA blob.

但是,使用GET/repos /:owner /:repo/contents /:path,将整个文件作为返回的JSON中的字段下载,这是低效的.所以,我的问题是:有没有办法在不下载整个文件的情况下获得"sha"字段？

Answer 1

您可以利用<rev>:<path> 扩展的SHA-1语法从其父树中检索有关Blob的一些元数据.

例如,如果您使用libgit2/libgit2sharp存储库,并且您想Lib/MoQ/Moq.license.txt从master分支中检索文件的sha :

• 利用GitHub Trees API检索与Lib/MoQ父目录匹配的树的内容
• 从返回的Json有效负载中检索路径为的blo的sha Moq.license.txt
• 确保对<rev>:<path>段进行url编码,因为它包含正斜杠

简单来说:

• 语法: GET/repos/<owner>/<repo>/git/trees/url_encode(<branch_name>:<parent_path>)
• 示例: https ://api.github.com/repos/libgit2/libgit2sharp/git/trees/master : Lib%2FMoQ

上面的示例链接将返回以下有效内容

{
  "sha": "2f2c87728225f9cbb6e2d8c5997b6031e72ddca4",
  "url": "https://api.github.com/repos/libgit2/libgit2sharp/git/trees/2f2c87728225f9cbb6e2d8c5997b6031e72ddca4",
  "tree": [
    {
      "path": "Moq.dll",
      "mode": "100644",
      "type": "blob",
      "sha": "bdd4235f215541017a9f37b6155f18e309573838",
      "size": 659968,
      "url": "https://api.github.com/repos/libgit2/libgit2sharp/git/blobs/bdd4235f215541017a9f37b6155f18e309573838"
    },
    {
      "path": "Moq.license.txt",
      "mode": "100644",
      "type": "blob",
      "sha": "c9216ccba318292d76fd308f232e7871bbbe77be",
      "size": 1748,
      "url": "https://api.github.com/repos/libgit2/libgit2sharp/git/blobs/c9216ccba318292d76fd308f232e7871bbbe77be"
    },
    {
      "path": "Moq.xml",
      "mode": "100644",
      "type": "blob",
      "sha": "160c1b5165fd967f4c79bc6043f0cc2ec28710d8",
      "size": 314572,
      "url": "https://api.github.com/repos/libgit2/libgit2sharp/git/blobs/160c1b5165fd967f4c79bc6043f0cc2ec28710d8"
    }
  ],
  "truncated": false
}