如何使用 github graphql API 创建新的提交？

Question

我正在尝试使用 github graphql api 创建一个新的提交，使用createCommitOnBranch突变。 应该为 expectedHeadOid 使用什么值：“？？？？？？”？ 如何从 Graphql API 中获得这样的价值？

这是我迄今为止的尝试：

{ 突变 m1 { createCommitOnBranch（输入：{ 分支：{repositoryNameWithOwner：“some_repo/some_owner”，branchName：“main”}，消息：{headline：“headline”}：fileChanges：{添加：{path.“README,md ": 内容: "SGVsbG8gV29ybGQ="} } 预期HeadOid? "???? " } ) } }

Answer 1

它应该是您要创建的新提交的父提交。
因此"expectedHeadOid": "git rev-parse HEAD"打印HEAD的 SHA1 hash （远程存储库的HEAD ，您希望在其上 append 使用createcommitonbranch createcommitonbranch 的新提交， 及其端点）

expectedHeadOid的HeadOid (GitObjectID )
git 提交 oid 预期在提交之前的分支头部。

在 octokit中，它被描述为：

git 提交 oid 预期在提交之前的分支头部。

Carl Brasic在他的要点“createCommitOnBranch 错误示例”中展示了如果传递过期的expectedHeadOid值会发生什么

我们故意告诉 API 到 append 提交到分支，只有当提示是一个我们知道它不是的值时。
假设这个克隆与远程是最新的，这将总是失败并出现描述性错误。

 expectedHeadOid=`git rev-parse HEAD~`

错误：

"message": "Expected branch to point to \"f786b7e2e0ec290972a2ada6858217ba16305933\" 
            but it did not.  Pull and try again."

---

此示例使用第一个查询 ( defaultBranchRef ) 来获取第二个查询 ( CreateCommitOnBranchInput ) 的参数值，这在您没有本地克隆的存储库时很有用：

步骤 1. 查询最后一次提交到分支的 OID，因为它是提交所必需的。
示例 graphQL 查询如下所示：

{
  repository(name: "my-new-repository", owner: "AnnaBurd") {
    defaultBranchRef {
      target {
        ... on Commit {
          history(first: 1) {
            nodes {
              oid
            }
          }
        }
      }
    }
  }
}

步骤 2. 使用名为“ CreateCommitOnBranchInput ”的 graphQL 突变创建具有新文件内容的提交：

----------------------mutation ------------------
mutation ($input: CreateCommitOnBranchInput!) {
  createCommitOnBranch(input: $input) {
    commit {
      url
    }
  }
}

-----------variables for mutation---------------
{
  "input": {
    "branch": {
      "repositoryNameWithOwner": "AnnaBurd/my-new-repository",
      "branchName": "main"
    },
    "message": {
      "headline": "Hello from GraphQL!"
    },
    "fileChanges": {
      "additions": [
        {
          "path": "myfile.txt",
          "contents": "SGVsbG8gZnJvbSBKQVZBIGFuZCBHcmFwaFFM"      <------- encoded base 64
        }
      ]
    },
    "expectedHeadOid": "db7a5d870738bf11ce1fc115267d13406f5d0e76"  <----- oid from step 1
  }
}