github - github 拉取请求评论 API 中的 position 和 original_position 字段是什么意思？

Question

github v3 API 让你 list comments on a pull request通过

curl 'https://api.github.com/repos/danvk/dygraphs/pulls/296/comments'

响应如下所示:

[
  {
    "id": 11908831,
    "diff_hunk": "@@ -1521,16 +1576,6 @@ Dygraph.prototype.doZoomX_ = function(lowX, highX) {\n };\n \n /**\n- * Transition function to use in animations. Returns values between 0.0\n- * (totally old values) and 1.0 (totally new values) for each frame.\n- * @private\n- */\n-Dygraph.zoomAnimationFunction = function(frame, numFrames) {",
    "path": "dygraph.js",
    "position": 140,
    "original_position": 140,
    "commit_id": "bacf5ce283d6871ce1c090f29bf5411341622248",
    "original_commit_id": "335011fd4473f55aaaceb69726d15e0063373149",
    "user": { ... }
    "body": "I'm not sure why this is showing up in the diff -- did you move it?",
  }
]

(你可以在 github here 上看到这个评论。)

我的问题是:“position”和“original_position”字段中的 140 究竟是什么意思？

我想将此转换为/从特定提交的行号。 API documentation表示这是统一差异中的行号，但我不知道它索引到哪个统一差异。 “dygraph.js”没有从 335011f..bacf5ce 改变，即 original_commit_id..commit_id。

Answer 1

您可以在“create comment”中看到

position number Required. 

The line index in the diff to comment on.

如果您展开与 comment of PR296 关联的所有差异，您将看到该差异的第 140 行是注释的那一行。
返回上一个 @@部分，您将拥有与该评论匹配的差异 header :

 -1521,16 +1576,6 @@ Dygraph.prototype.doZoomX_ = function(lowX, highX) {

如果那个 PR 进化了(改变了它的修改)， original_position应引用上次更改前的前一行索引。