Commit 3bdf0e2921c4cac46084834899302b25858e6bde
Exists in
spb-stable
and in
2 other branches
Merge branch 'compare-api' into 'master'
Compare api Fixes #1165
Showing
4 changed files
with
133 additions
and
0 deletions
Show diff stats
doc/api/repositories.md
| ... | ... | @@ -131,3 +131,56 @@ GET /projects/:id/repository/archive |
| 131 | 131 | Parameters: |
| 132 | 132 | + `id` (required) - The ID of a project |
| 133 | 133 | + `sha` (optional) - The commit sha to download defaults to the tip of the default branch |
| 134 | + | |
| 135 | + | |
| 136 | +## Compare branches, tags or commits | |
| 137 | + | |
| 138 | +``` | |
| 139 | +GET /projects/:id/repository/compare | |
| 140 | +``` | |
| 141 | + | |
| 142 | +Parameters: | |
| 143 | ++ `id` (required) - The ID of a project | |
| 144 | ++ `from` (required) - the commit sha or branch name | |
| 145 | ++ `to` (required) - the commit sha or branch name | |
| 146 | + | |
| 147 | + | |
| 148 | +``` | |
| 149 | +GET /projects/:id/repository/compare?from=master&to=feature | |
| 150 | +``` | |
| 151 | + | |
| 152 | +Response: | |
| 153 | + | |
| 154 | +```json | |
| 155 | + | |
| 156 | +{ | |
| 157 | + "commit": { | |
| 158 | + "id": "12d65c8dd2b2676fa3ac47d955accc085a37a9c1", | |
| 159 | + "short_id": "12d65c8dd2b", | |
| 160 | + "title": "JS fix", | |
| 161 | + "author_name": "Dmitriy Zaporozhets", | |
| 162 | + "author_email": "dmitriy.zaporozhets@gmail.com", | |
| 163 | + "created_at": "2014-02-27T10:27:00+02:00" | |
| 164 | + }, | |
| 165 | + "commits": [{ | |
| 166 | + "id": "12d65c8dd2b2676fa3ac47d955accc085a37a9c1", | |
| 167 | + "short_id": "12d65c8dd2b", | |
| 168 | + "title": "JS fix", | |
| 169 | + "author_name": "Dmitriy Zaporozhets", | |
| 170 | + "author_email": "dmitriy.zaporozhets@gmail.com", | |
| 171 | + "created_at": "2014-02-27T10:27:00+02:00" | |
| 172 | + }], | |
| 173 | + "diffs": [{ | |
| 174 | + "old_path": "files/js/application.js", | |
| 175 | + "new_path": "files/js/application.js", | |
| 176 | + "a_mode": null, | |
| 177 | + "b_mode": "100644", | |
| 178 | + "diff": "--- a/files/js/application.js\n+++ b/files/js/application.js\n@@ -24,8 +24,10 @@\n //= require g.raphael-min\n //= require g.bar-min\n //= require branch-graph\n-//= require highlightjs.min\n-//= require ace/ace\n //= require_tree .\n //= require d3\n //= require underscore\n+\n+function fix() { \n+ alert(\"Fixed\")\n+}", | |
| 179 | + "new_file": false, | |
| 180 | + "renamed_file": false, | |
| 181 | + "deleted_file": false | |
| 182 | + }], | |
| 183 | + "compare_timeout": false, | |
| 184 | + "compare_same_ref": false | |
| 185 | +} | |
| 186 | +``` | ... | ... |
lib/api/entities.rb
| ... | ... | @@ -194,5 +194,30 @@ module API |
| 194 | 194 | class Label < Grape::Entity |
| 195 | 195 | expose :name |
| 196 | 196 | end |
| 197 | + | |
| 198 | + class RepoDiff < Grape::Entity | |
| 199 | + expose :old_path, :new_path, :a_mode, :b_mode, :diff | |
| 200 | + expose :new_file, :renamed_file, :deleted_file | |
| 201 | + end | |
| 202 | + | |
| 203 | + class Compare < Grape::Entity | |
| 204 | + expose :commit, using: Entities::RepoCommit do |compare, options| | |
| 205 | + if compare.commit | |
| 206 | + Commit.new compare.commit | |
| 207 | + end | |
| 208 | + end | |
| 209 | + expose :commits, using: Entities::RepoCommit do |compare, options| | |
| 210 | + Commit.decorate compare.commits | |
| 211 | + end | |
| 212 | + expose :diffs, using: Entities::RepoDiff do |compare, options| | |
| 213 | + compare.diffs | |
| 214 | + end | |
| 215 | + | |
| 216 | + expose :compare_timeout do |compare, options| | |
| 217 | + compare.timeout | |
| 218 | + end | |
| 219 | + | |
| 220 | + expose :same, as: :compare_same_ref | |
| 221 | + end | |
| 197 | 222 | end |
| 198 | 223 | end | ... | ... |
lib/api/repositories.rb
| ... | ... | @@ -15,6 +15,7 @@ module API |
| 15 | 15 | not_found! |
| 16 | 16 | end |
| 17 | 17 | end |
| 18 | + | |
| 18 | 19 | # Get a project repository tags |
| 19 | 20 | # |
| 20 | 21 | # Parameters: |
| ... | ... | @@ -118,6 +119,21 @@ module API |
| 118 | 119 | not_found! |
| 119 | 120 | end |
| 120 | 121 | end |
| 122 | + | |
| 123 | + # Compare two branches, tags or commits | |
| 124 | + # | |
| 125 | + # Parameters: | |
| 126 | + # id (required) - The ID of a project | |
| 127 | + # from (required) - the commit sha or branch name | |
| 128 | + # to (required) - the commit sha or branch name | |
| 129 | + # Example Request: | |
| 130 | + # GET /projects/:id/repository/compare?from=master&to=feature | |
| 131 | + get ':id/repository/compare' do | |
| 132 | + authorize! :download_code, user_project | |
| 133 | + required_attributes! [:from, :to] | |
| 134 | + compare = Gitlab::Git::Compare.new(user_project.repository.raw_repository, params[:from], params[:to], MergeRequestDiff::COMMITS_SAFE_SIZE) | |
| 135 | + present compare, with: Entities::Compare | |
| 136 | + end | |
| 121 | 137 | end |
| 122 | 138 | end |
| 123 | 139 | end | ... | ... |
spec/requests/api/repositories_spec.rb
| ... | ... | @@ -112,4 +112,43 @@ describe API::API, api: true do |
| 112 | 112 | response.status.should == 404 |
| 113 | 113 | end |
| 114 | 114 | end |
| 115 | + | |
| 116 | + describe 'GET /GET /projects/:id/repository/compare' do | |
| 117 | + it "should compare branches" do | |
| 118 | + get api("/projects/#{project.id}/repository/compare", user), from: 'master', to: 'simple_merge_request' | |
| 119 | + response.status.should == 200 | |
| 120 | + json_response['commits'].should be_present | |
| 121 | + json_response['diffs'].should be_present | |
| 122 | + end | |
| 123 | + | |
| 124 | + it "should compare tags" do | |
| 125 | + get api("/projects/#{project.id}/repository/compare", user), from: 'v1.0.1', to: 'v1.0.2' | |
| 126 | + response.status.should == 200 | |
| 127 | + json_response['commits'].should be_present | |
| 128 | + json_response['diffs'].should be_present | |
| 129 | + end | |
| 130 | + | |
| 131 | + it "should compare commits" do | |
| 132 | + get api("/projects/#{project.id}/repository/compare", user), from: 'b1e6a9dbf1c85', to: '1e689bfba395' | |
| 133 | + response.status.should == 200 | |
| 134 | + json_response['commits'].should be_empty | |
| 135 | + json_response['diffs'].should be_empty | |
| 136 | + json_response['compare_same_ref'].should be_false | |
| 137 | + end | |
| 138 | + | |
| 139 | + it "should compare commits in reverse order" do | |
| 140 | + get api("/projects/#{project.id}/repository/compare", user), from: '1e689bfba395', to: 'b1e6a9dbf1c85' | |
| 141 | + response.status.should == 200 | |
| 142 | + json_response['commits'].should be_present | |
| 143 | + json_response['diffs'].should be_present | |
| 144 | + end | |
| 145 | + | |
| 146 | + it "should compare same refs" do | |
| 147 | + get api("/projects/#{project.id}/repository/compare", user), from: 'master', to: 'master' | |
| 148 | + response.status.should == 200 | |
| 149 | + json_response['commits'].should be_empty | |
| 150 | + json_response['diffs'].should be_empty | |
| 151 | + json_response['compare_same_ref'].should be_true | |
| 152 | + end | |
| 153 | + end | |
| 115 | 154 | end | ... | ... |