Skip to main content

处理注释

使用 REST API,您可以访问和管理拉取请求、议题或提交中的注释。

对于任何拉取请求,GitHub Enterprise Server 提供三种类型的注释视图:针对整个拉取请求的拉取请求注释、针对拉取请求内的特定行的注释,以及针对拉取请求内的特定提交的注释

每种类型的评论都会经过 API GitHub Enterprise Server 的不同部分。 在本指南中,我们将探讨如何访问和处理每种注释。 对于每个示例,我们将使用在“octocat”存储库上发出的此示例拉取请求。 和往常一样,可以在平台示例存储库中找到示例。

拉取请求注释

若要访问针对拉取请求的注释,请使用用于管理问题的终结点。 乍一看这似乎不符合直觉。 但是,一旦你理解了拉取请求只是包含代码的问题,使用这些终结点来针对拉取请求创建注释就合情合理了。

我们将演示如何使用 Octokit.rb 创建 Ruby 脚本来提取拉取请求注释。 你还需要创建 personal access token

以下代码应该可以帮助你开始使用 Octokit.rb 访问拉取请求中的注释:

require 'octokit'

# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!!
# Instead, set and test environment variables, like below
client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN']

client.issue_comments("octocat/Spoon-Knife", 1176).each do |comment|
  username = comment[:user][:login]
  post_date = comment[:created_at]
  content = comment[:body]

  puts "#{username} made a comment on #{post_date}. It says:\n'#{content}'\n"
end

在这里,我们专门调用 API 来获取注释 (issue_comments),同时提供存储库的名称 (octocat/Spoon-Knife),以及我们感兴趣的拉取请求 ID (1176)。 之后,只需遍历注释以获取有关每个注释的信息即可。

拉取请求行注释

在差异视图中,你可以针对在拉取请求中进行的某个更改的特定方面开启讨论。 这些注释出现在已更改文件中的各个行上。 此讨论的终结点 URL 来自用于管理拉取请求评审的终结点

以下代码将获取文件中所做的所有拉取请求注释(给定一个拉取请求编号):

require 'octokit'

# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!!
# Instead, set and test environment variables, like below
client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN']

client.pull_request_comments("octocat/Spoon-Knife", 1176).each do |comment|
  username = comment[:user][:login]
  post_date = comment[:created_at]
  content = comment[:body]
  path = comment[:path]
  position = comment[:position]

  puts "#{username} made a comment on #{post_date} for the file called #{path}, on line #{position}. It says:\n'#{content}'\n"
end

您会注意到,它与上面的示例非常相似。 此视图与拉取请求注释之间的不同之处在于对话的焦点。 对拉取请求的注释应予以保留,以供讨论或就代码的总体方向提出意见。 在拉取请求评审中所做的注释应该以在文件中实施特定更改的方式进行专门处理。

提交注释

最后一类注释专门针对单个提交。 因此,他们使用用于管理提交注释的终结点

要检索对提交的注释,您需要使用该提交的 SHA1。 换句话说,您不能使用与拉取请求相关的任何标识符。 下面是一个示例:

require 'octokit'

# !!! DO NOT EVER USE HARD-CODED VALUES IN A REAL APP !!!
# Instead, set and test environment variables, like below
client = Octokit::Client.new :access_token => ENV['MY_PERSONAL_TOKEN']

client.commit_comments("octocat/Spoon-Knife", "cbc28e7c8caee26febc8c013b0adfb97a4edd96e").each do |comment|
  username = comment[:user][:login]
  post_date = comment[:created_at]
  content = comment[:body]

  puts "#{username} made a comment on #{post_date}. It says:\n'#{content}'\n"
end

请注意,此 API 调用将检索单行注释以及对整个提交所做的注释。