debian-mirror-gitlab/lib/api/project_snippets.rb

155 lines
5.2 KiB
Ruby
Raw Normal View History

2014-09-02 18:07:02 +05:30
module API
class ProjectSnippets < Grape::API
2017-08-17 22:00:37 +05:30
include PaginationParams
2014-09-02 18:07:02 +05:30
before { authenticate! }
2017-08-17 22:00:37 +05:30
params do
requires :id, type: String, desc: 'The ID of a project'
end
2018-03-17 18:26:18 +05:30
resource :projects, requirements: API::PROJECT_ENDPOINT_REQUIREMENTS do
2014-09-02 18:07:02 +05:30
helpers do
def handle_project_member_errors(errors)
if errors[:project_access].any?
error!(errors[:project_access], 422)
end
2018-03-17 18:26:18 +05:30
2014-09-02 18:07:02 +05:30
not_found!
end
2016-06-02 11:05:42 +05:30
def snippets_for_current_user
2017-08-17 22:00:37 +05:30
SnippetsFinder.new(current_user, project: user_project).execute
2016-06-02 11:05:42 +05:30
end
2014-09-02 18:07:02 +05:30
end
2017-08-17 22:00:37 +05:30
desc 'Get all project snippets' do
success Entities::ProjectSnippet
end
params do
use :pagination
end
2014-09-02 18:07:02 +05:30
get ":id/snippets" do
2016-06-02 11:05:42 +05:30
present paginate(snippets_for_current_user), with: Entities::ProjectSnippet
2014-09-02 18:07:02 +05:30
end
2017-08-17 22:00:37 +05:30
desc 'Get a single project snippet' do
success Entities::ProjectSnippet
end
params do
requires :snippet_id, type: Integer, desc: 'The ID of a project snippet'
end
2014-09-02 18:07:02 +05:30
get ":id/snippets/:snippet_id" do
2017-08-17 22:00:37 +05:30
snippet = snippets_for_current_user.find(params[:snippet_id])
present snippet, with: Entities::ProjectSnippet
end
desc 'Create a new project snippet' do
success Entities::ProjectSnippet
end
params do
requires :title, type: String, desc: 'The title of the snippet'
requires :file_name, type: String, desc: 'The file name of the snippet'
requires :code, type: String, desc: 'The content of the snippet'
2017-09-10 17:25:29 +05:30
optional :description, type: String, desc: 'The description of a snippet'
2017-08-17 22:00:37 +05:30
requires :visibility, type: String,
values: Gitlab::VisibilityLevel.string_values,
desc: 'The visibility of the snippet'
end
2014-09-02 18:07:02 +05:30
post ":id/snippets" do
2015-09-11 14:41:01 +05:30
authorize! :create_project_snippet, user_project
2017-08-17 22:00:37 +05:30
snippet_params = declared_params.merge(request: request, api: true)
snippet_params[:content] = snippet_params.delete(:code)
snippet = CreateSnippetService.new(user_project, current_user, snippet_params).execute
2014-09-02 18:07:02 +05:30
2017-08-17 22:00:37 +05:30
render_spam_error! if snippet.spam?
2014-09-02 18:07:02 +05:30
2017-08-17 22:00:37 +05:30
if snippet.persisted?
present snippet, with: Entities::ProjectSnippet
2014-09-02 18:07:02 +05:30
else
2017-08-17 22:00:37 +05:30
render_validation_error!(snippet)
2014-09-02 18:07:02 +05:30
end
end
2017-08-17 22:00:37 +05:30
desc 'Update an existing project snippet' do
success Entities::ProjectSnippet
end
params do
requires :snippet_id, type: Integer, desc: 'The ID of a project snippet'
optional :title, type: String, desc: 'The title of the snippet'
optional :file_name, type: String, desc: 'The file name of the snippet'
optional :code, type: String, desc: 'The content of the snippet'
2017-09-10 17:25:29 +05:30
optional :description, type: String, desc: 'The description of a snippet'
2017-08-17 22:00:37 +05:30
optional :visibility, type: String,
values: Gitlab::VisibilityLevel.string_values,
desc: 'The visibility of the snippet'
at_least_one_of :title, :file_name, :code, :visibility_level
end
2014-09-02 18:07:02 +05:30
put ":id/snippets/:snippet_id" do
2017-08-17 22:00:37 +05:30
snippet = snippets_for_current_user.find_by(id: params.delete(:snippet_id))
not_found!('Snippet') unless snippet
authorize! :update_project_snippet, snippet
snippet_params = declared_params(include_missing: false)
.merge(request: request, api: true)
snippet_params[:content] = snippet_params.delete(:code) if snippet_params[:code].present?
2014-09-02 18:07:02 +05:30
2017-08-17 22:00:37 +05:30
UpdateSnippetService.new(user_project, current_user, snippet,
snippet_params).execute
2014-09-02 18:07:02 +05:30
2017-08-17 22:00:37 +05:30
render_spam_error! if snippet.spam?
if snippet.valid?
present snippet, with: Entities::ProjectSnippet
2014-09-02 18:07:02 +05:30
else
2017-08-17 22:00:37 +05:30
render_validation_error!(snippet)
2014-09-02 18:07:02 +05:30
end
end
2017-08-17 22:00:37 +05:30
desc 'Delete a project snippet'
params do
requires :snippet_id, type: Integer, desc: 'The ID of a project snippet'
end
2014-09-02 18:07:02 +05:30
delete ":id/snippets/:snippet_id" do
2017-08-17 22:00:37 +05:30
snippet = snippets_for_current_user.find_by(id: params[:snippet_id])
not_found!('Snippet') unless snippet
authorize! :admin_project_snippet, snippet
2018-03-17 18:26:18 +05:30
destroy_conditionally!(snippet)
2014-09-02 18:07:02 +05:30
end
2017-08-17 22:00:37 +05:30
desc 'Get a raw project snippet'
params do
requires :snippet_id, type: Integer, desc: 'The ID of a project snippet'
end
2014-09-02 18:07:02 +05:30
get ":id/snippets/:snippet_id/raw" do
2017-08-17 22:00:37 +05:30
snippet = snippets_for_current_user.find_by(id: params[:snippet_id])
not_found!('Snippet') unless snippet
2014-09-02 18:07:02 +05:30
env['api.format'] = :txt
content_type 'text/plain'
2017-08-17 22:00:37 +05:30
present snippet.content
2014-09-02 18:07:02 +05:30
end
2017-09-10 17:25:29 +05:30
desc 'Get the user agent details for a project snippet' do
success Entities::UserAgentDetail
end
params do
requires :snippet_id, type: Integer, desc: 'The ID of a project snippet'
end
get ":id/snippets/:snippet_id/user_agent_detail" do
authenticated_as_admin!
2018-03-17 18:26:18 +05:30
snippet = Snippet.find_by!(id: params[:snippet_id], project_id: params[:id])
2017-09-10 17:25:29 +05:30
return not_found!('UserAgentDetail') unless snippet.user_agent_detail
present snippet.user_agent_detail, with: Entities::UserAgentDetail
end
2014-09-02 18:07:02 +05:30
end
end
end