position和original_position字段在github pull请求注释API中的含义是什么?

时间:2014-06-03 04:20:49

标签: github github-api pull-request

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上看到此评论。)

我的问题是:在"位置"中的140位究竟是什么?和" original_position"字段意味着什么?

我希望将此转换为特定提交的行号/从行号转换。 API documentation表示这是统一差异中的行号,但我不能告诉它索引到哪个统一差异。 " dygraph.js"没有改变335011f..bacf5ce,即original_commit_id..commit_id。

1 个答案:

答案 0 :(得分:3)

您可以在" create comment"

中看到
position number Required. 
  

差异中的行索引要评论。

如果展开与comment of PR296关联的所有差异,您将看到该差异的第140行是评论的那一行。
返回上一个@@部分,您将获得与该评论匹配的差异标题:

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

如果PR发展(更改了修改),original_position应该在最后一次更改之前引用上一行索引。