Commit 53b52b11d5cbaa32f98c267eb53b4b7c928a92c4
Exists in
spb-stable
and in
3 other branches
Merge pull request #6699 from criteo/api_get_open_merge_requests
Add optional parameter to list merge requests
Showing
3 changed files
with
52 additions
and
4 deletions
Show diff stats
doc/api/merge_requests.md
1 | 1 | ## List merge requests |
2 | 2 | |
3 | -Get all merge requests for this project. This function takes pagination parameters | |
4 | -`page` and `per_page` to restrict the list of merge requests. | |
3 | +Get all merge requests for this project. | |
4 | +The `state` parameter can be used to get only merge requests with a | |
5 | +given state (`opened`, `closed`, or `merged`) or all of them (`all`). | |
6 | +The pagination parameters `page` and `per_page` can be used to restrict the | |
7 | +list of merge requests. | |
5 | 8 | |
6 | 9 | ``` |
7 | 10 | GET /projects/:id/merge_requests |
11 | +GET /projects/:id/merge_requests?state=opened | |
12 | +GET /projects/:id/merge_requests?state=all | |
8 | 13 | ``` |
9 | 14 | |
10 | 15 | Parameters: |
11 | 16 | |
12 | 17 | + `id` (required) - The ID of a project |
18 | ++ `state` (optional) - Return `all` requests or just those that are `merged`, `opened` or `closed` | |
13 | 19 | |
14 | 20 | ```json |
15 | 21 | [ | ... | ... |
lib/api/merge_requests.rb
... | ... | @@ -19,14 +19,24 @@ module API |
19 | 19 | # |
20 | 20 | # Parameters: |
21 | 21 | # id (required) - The ID of a project |
22 | + # state (optional) - Return requests "merged", "opened" or "closed" | |
22 | 23 | # |
23 | 24 | # Example: |
24 | 25 | # GET /projects/:id/merge_requests |
26 | + # GET /projects/:id/merge_requests?state=opened | |
27 | + # GET /projects/:id/merge_requests?state=closed | |
25 | 28 | # |
26 | 29 | get ":id/merge_requests" do |
27 | 30 | authorize! :read_merge_request, user_project |
28 | 31 | |
29 | - present paginate(user_project.merge_requests), with: Entities::MergeRequest | |
32 | + mrs = case params["state"] | |
33 | + when "opened" then user_project.merge_requests.opened | |
34 | + when "closed" then user_project.merge_requests.closed | |
35 | + when "merged" then user_project.merge_requests.merged | |
36 | + else user_project.merge_requests | |
37 | + end | |
38 | + | |
39 | + present paginate(mrs), with: Entities::MergeRequest | |
30 | 40 | end |
31 | 41 | |
32 | 42 | # Show MR | ... | ... |
spec/requests/api/merge_requests_spec.rb
... | ... | @@ -7,6 +7,8 @@ describe API::API, api: true do |
7 | 7 | let(:user) { create(:user) } |
8 | 8 | let!(:project) {create(:project, creator_id: user.id, namespace: user.namespace) } |
9 | 9 | let!(:merge_request) { create(:merge_request, :simple, author: user, assignee: user, source_project: project, target_project: project, title: "Test") } |
10 | + let!(:merge_request_closed) { create(:merge_request, state: "closed", author: user, assignee: user, source_project: project, target_project: project, title: "Closed test") } | |
11 | + let!(:merge_request_merged) { create(:merge_request, state: "merged", author: user, assignee: user, source_project: project, target_project: project, title: "Merged test") } | |
10 | 12 | let!(:note) { create(:note_on_merge_request, author: user, project: project, noteable: merge_request, note: "a comment on a MR") } |
11 | 13 | before { |
12 | 14 | project.team << [user, :reporters] |
... | ... | @@ -21,12 +23,42 @@ describe API::API, api: true do |
21 | 23 | end |
22 | 24 | |
23 | 25 | context "when authenticated" do |
24 | - it "should return an array of merge_requests" do | |
26 | + it "should return an array of all merge_requests" do | |
25 | 27 | get api("/projects/#{project.id}/merge_requests", user) |
26 | 28 | response.status.should == 200 |
27 | 29 | json_response.should be_an Array |
30 | + json_response.length.should == 3 | |
28 | 31 | json_response.first['title'].should == merge_request.title |
29 | 32 | end |
33 | + it "should return an array of all merge_requests" do | |
34 | + get api("/projects/#{project.id}/merge_requests?state", user) | |
35 | + response.status.should == 200 | |
36 | + json_response.should be_an Array | |
37 | + json_response.length.should == 3 | |
38 | + json_response.first['title'].should == merge_request.title | |
39 | + end | |
40 | + it "should return an array of open merge_requests" do | |
41 | + get api("/projects/#{project.id}/merge_requests?state=opened", user) | |
42 | + response.status.should == 200 | |
43 | + json_response.should be_an Array | |
44 | + json_response.length.should == 1 | |
45 | + json_response.first['title'].should == merge_request.title | |
46 | + end | |
47 | + it "should return an array of closed merge_requests" do | |
48 | + get api("/projects/#{project.id}/merge_requests?state=closed", user) | |
49 | + response.status.should == 200 | |
50 | + json_response.should be_an Array | |
51 | + json_response.length.should == 2 | |
52 | + json_response.first['title'].should == merge_request_closed.title | |
53 | + json_response.second['title'].should == merge_request_merged.title | |
54 | + end | |
55 | + it "should return an array of merged merge_requests" do | |
56 | + get api("/projects/#{project.id}/merge_requests?state=merged", user) | |
57 | + response.status.should == 200 | |
58 | + json_response.should be_an Array | |
59 | + json_response.length.should == 1 | |
60 | + json_response.first['title'].should == merge_request_merged.title | |
61 | + end | |
30 | 62 | end |
31 | 63 | end |
32 | 64 | ... | ... |