libgit2sharp 提供给 GitHub API 合并拉取请求的正确 sha 是什么？

Question

GitHub API 要求合并拉取请求提交为

PUT /repos/:owner/:repo/pulls/:number/merge

带有请求正文 json

{
  "commit_message": "blah",
  "sha": "{SHA that pull request head must match to allow merge}",
}

在提交、推送、创建 PR 之后，什么 libgit2sharp 属性提供了正确的 sha？

对于当前分支，Branch.Tip.Sha 似乎是正确的值，但我收到响应错误：

{ "message": "Head 分支已修改。查看并尝试合并 再次。", "documentation_url": “https://developer.github.com/v3/pulls/#merge-a-pull-request-merge-button” }

Answer 1

当涉及到拉取请求时，有两种不同的提交和 shas 发挥作用。

• 你的分支的尖端（你在你的分支上推送的最后一次提交）

  • 语法： GET /repos/:owner/:repo/git/refs/:ref（其中:ref 应为pull/{number}/head 格式）
  • 示例： https://api.github.com/repos/libgit2/libgit2sharp/git/refs/pull/1123/head

• GitHub 在后台动态创建的虚拟合并提交以确定可合并性并允许 CI 服务器运行您的构建/测试，就好像您的分支已经合并（因此，提前检测任何潜在问题）

  • 语法： GET /repos/:owner/:repo/git/refs/:ref（其中:ref 应为pull/{number}/merge 格式）
  • 示例： https://api.github.com/repos/libgit2/libgit2sharp/git/refs/pull/1123/merge

当利用 GitHub API 合并打开的拉取请求时，json 有效负载中的可选 sha 属性应与分支提示的 sha 匹配目前 GitHub 已知。

如果您的本地存储库与 GitHub 对您的存储库的了解保持同步，那么这绝对应该与 repo.Branches["your_topic_branch"].Tip.Sha 返回的内容相匹配。

注意：为了确保 GitHub 已知的 PR 头与您的本地分支提示匹配，使用 LibGit2Sharp，您可以通过直接获取特殊的 GitHub PR 合并/指向提交的头来检索引用命名空间。下面的代码演示了这一点

var remoteName = "origin"; // or whatever your remote is named
var remote = repo.Network.Remotes[remoteName];
var prNumber = "1123"; // or whatever your pr number is

// Build the refspec
string refSpec = string.Format("+refs/pull/{1}/*:refs/remotes/{0}/pull/{1}/*", 
                        remoteName, prNumber);

// Perform the actual fetch
repo.Network.Fetch(remote, new[] { refSpec });

Console.WriteLine(repo.Branches[string.Format("pull/{0}/merge", prNumber)].Tip.Sha);