Commit f030ee84 authored by Bernhard Kaindl's avatar Bernhard Kaindl

API: Initial support for forking a project via the API

This change adds POST /projects/fork/:id to the API for forking
a project into the namespace of the authenticated user, like the
"create fork" link in the GUI does. It also calls the same code.

Failure and permission checks (except for conflict) are already
implemented and handled in ForkService and the API, so the added
code is simple and does not alter anything.
parent 88d3e97e
No related merge requests found
......@@ -10,6 +10,7 @@ v 7.4.0
- Do not delete tmp/repositories itself during clean-up, only its contents
- Support for backup uploads to remote storage
- Prevent notes polling when there are not notes
- API: Add support for forking a project via the API (Bernhard Kaindl)
- API: filter project issues by milestone (Julien Bianchi)
v 7.3.1
......
......@@ -281,6 +281,18 @@ Parameters:
- `visibility_level` (optional)
- `import_url` (optional)
### Fork project
Forks a project into the user namespace of the authenticated user.
```
POST /projects/fork/:id
```
Parameters:
- `id` (required) - The ID of the project to be forked
### Remove project
Removes a project including all associated resources (issues, merge requests etc.)
......
......@@ -153,6 +153,23 @@ module API
end
end
# Fork new project for the current user.
#
# Parameters:
# id (required) - The ID of a project
# Example Request
# POST /projects/fork/:id
post 'fork/:id' do
@forked_project =
::Projects::ForkService.new(user_project,
current_user).execute
if @forked_project.errors.any?
conflict!(@forked_project.errors.messages)
else
present @forked_project, with: Entities::Project
end
end
# Remove project
#
# Parameters:
......
require 'spec_helper'
describe API::API, api: true do
include ApiHelpers
let(:user) { create(:user) }
let(:user2) { create(:user) }
let(:user3) { create(:user) }
let(:admin) { create(:admin) }
let(:project) {
create(:project, creator_id: user.id,
namespace: user.namespace)
}
let(:project_user2) {
create(:project_member, user: user2,
project: project,
access_level: ProjectMember::GUEST)
}
describe 'POST /projects/fork/:id' do
before { project_user2 }
before { user3 }
context 'when authenticated' do
it 'should fork if user has sufficient access to project' do
post api("/projects/fork/#{project.id}", user2)
response.status.should == 201
json_response['name'].should == project.name
json_response['path'].should == project.path
json_response['owner']['id'].should == user2.id
json_response['namespace']['id'].should == user2.namespace.id
json_response['forked_from_project']['id'].should == project.id
end
it 'should fork if user is admin' do
post api("/projects/fork/#{project.id}", admin)
response.status.should == 201
json_response['name'].should == project.name
json_response['path'].should == project.path
json_response['owner']['id'].should == admin.id
json_response['namespace']['id'].should == admin.namespace.id
json_response['forked_from_project']['id'].should == project.id
end
it 'should fail on missing project access for the project to fork' do
post api("/projects/fork/#{project.id}", user3)
response.status.should == 404
json_response['message'].should == '404 Not Found'
end
it 'should fail if forked project exists in the user namespace' do
post api("/projects/fork/#{project.id}", user)
response.status.should == 409
json_response['message']['base'].should == ['Invalid fork destination']
json_response['message']['name'].should == ['has already been taken']
json_response['message']['path'].should == ['has already been taken']
end
it 'should fail if project to fork from does not exist' do
post api('/projects/fork/424242', user)
response.status.should == 404
json_response['message'].should == '404 Not Found'
end
end
context 'when unauthenticated' do
it 'should return authentication error' do
post api("/projects/fork/#{project.id}")
response.status.should == 401
json_response['message'].should == '401 Unauthorized'
end
end
end
end
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment