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

184 lines
6.1 KiB
Ruby
Raw Normal View History

2018-12-05 23:21:45 +05:30
# frozen_string_literal: true
2017-08-17 22:00:37 +05:30
module API
# Snippets API
class Snippets < Grape::API
include PaginationParams
before { authenticate! }
resource :snippets do
2020-05-24 23:13:21 +05:30
helpers Helpers::SnippetsHelpers
2017-08-17 22:00:37 +05:30
helpers do
def snippets_for_current_user
SnippetsFinder.new(current_user, author: current_user).execute
end
def public_snippets
2020-01-01 13:55:28 +05:30
Snippet.only_personal_snippets.are_public.fresh
2017-08-17 22:00:37 +05:30
end
2019-07-07 11:18:12 +05:30
def snippets
SnippetsFinder.new(current_user).execute
end
2017-08-17 22:00:37 +05:30
end
desc 'Get a snippets list for authenticated user' do
detail 'This feature was introduced in GitLab 8.15.'
2020-05-24 23:13:21 +05:30
success Entities::Snippet
2017-08-17 22:00:37 +05:30
end
params do
use :pagination
end
get do
2020-05-24 23:13:21 +05:30
present paginate(snippets_for_current_user), with: Entities::Snippet
2017-08-17 22:00:37 +05:30
end
2020-01-01 13:55:28 +05:30
desc 'List all public personal snippets current_user has access to' do
2017-08-17 22:00:37 +05:30
detail 'This feature was introduced in GitLab 8.15.'
success Entities::PersonalSnippet
end
params do
use :pagination
end
get 'public' do
present paginate(public_snippets), with: Entities::PersonalSnippet
end
desc 'Get a single snippet' do
detail 'This feature was introduced in GitLab 8.15.'
success Entities::PersonalSnippet
end
params do
requires :id, type: Integer, desc: 'The ID of a snippet'
end
get ':id' do
2019-07-07 11:18:12 +05:30
snippet = snippets.find_by_id(params[:id])
break not_found!('Snippet') unless snippet
2017-08-17 22:00:37 +05:30
present snippet, with: Entities::PersonalSnippet
end
desc 'Create new snippet' do
detail 'This feature was introduced in GitLab 8.15.'
success Entities::PersonalSnippet
end
params do
2020-05-24 23:13:21 +05:30
requires :title, type: String, allow_blank: false, desc: 'The title of a snippet'
2017-08-17 22:00:37 +05:30
requires :file_name, type: String, desc: 'The name of a snippet file'
2020-05-24 23:13:21 +05:30
requires :content, type: String, allow_blank: false, desc: 'The content of a 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,
default: 'internal',
desc: 'The visibility of the snippet'
end
post do
2020-03-28 13:19:24 +05:30
authorize! :create_snippet
2017-08-17 22:00:37 +05:30
attrs = declared_params(include_missing: false).merge(request: request, api: true)
2020-03-13 15:44:24 +05:30
service_response = ::Snippets::CreateService.new(nil, current_user, attrs).execute
snippet = service_response.payload[:snippet]
2017-08-17 22:00:37 +05:30
2020-05-24 23:13:21 +05:30
if service_response.success?
2017-08-17 22:00:37 +05:30
present snippet, with: Entities::PersonalSnippet
else
2020-05-24 23:13:21 +05:30
render_spam_error! if snippet.spam?
render_api_error!({ error: service_response.message }, service_response.http_status)
2017-08-17 22:00:37 +05:30
end
end
desc 'Update an existing snippet' do
detail 'This feature was introduced in GitLab 8.15.'
success Entities::PersonalSnippet
end
params do
requires :id, type: Integer, desc: 'The ID of a snippet'
2020-05-24 23:13:21 +05:30
optional :title, type: String, allow_blank: false, desc: 'The title of a snippet'
2017-08-17 22:00:37 +05:30
optional :file_name, type: String, desc: 'The name of a snippet file'
2020-05-24 23:13:21 +05:30
optional :content, type: String, allow_blank: false, desc: 'The content of a 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, :content, :visibility
end
put ':id' do
2019-07-07 11:18:12 +05:30
snippet = snippets_for_current_user.find_by_id(params.delete(:id))
2018-10-15 14:42:47 +05:30
break not_found!('Snippet') unless snippet
2018-03-17 18:26:18 +05:30
2020-03-13 15:44:24 +05:30
authorize! :update_snippet, snippet
2017-08-17 22:00:37 +05:30
attrs = declared_params(include_missing: false).merge(request: request, api: true)
2020-03-13 15:44:24 +05:30
service_response = ::Snippets::UpdateService.new(nil, current_user, attrs).execute(snippet)
snippet = service_response.payload[:snippet]
2017-08-17 22:00:37 +05:30
2020-05-24 23:13:21 +05:30
if service_response.success?
2017-08-17 22:00:37 +05:30
present snippet, with: Entities::PersonalSnippet
else
2020-05-24 23:13:21 +05:30
render_spam_error! if snippet.spam?
render_api_error!({ error: service_response.message }, service_response.http_status)
2017-08-17 22:00:37 +05:30
end
end
desc 'Remove snippet' do
detail 'This feature was introduced in GitLab 8.15.'
success Entities::PersonalSnippet
end
params do
requires :id, type: Integer, desc: 'The ID of a snippet'
end
delete ':id' do
2019-07-07 11:18:12 +05:30
snippet = snippets_for_current_user.find_by_id(params.delete(:id))
2018-10-15 14:42:47 +05:30
break not_found!('Snippet') unless snippet
2017-08-17 22:00:37 +05:30
2020-03-13 15:44:24 +05:30
authorize! :admin_snippet, snippet
destroy_conditionally!(snippet) do |snippet|
service = ::Snippets::DestroyService.new(current_user, snippet)
response = service.execute
2017-08-17 22:00:37 +05:30
2020-03-13 15:44:24 +05:30
if response.error?
render_api_error!({ error: response.message }, response.http_status)
end
end
2017-08-17 22:00:37 +05:30
end
desc 'Get a raw snippet' do
detail 'This feature was introduced in GitLab 8.15.'
end
params do
requires :id, type: Integer, desc: 'The ID of a snippet'
end
get ":id/raw" do
2019-07-07 11:18:12 +05:30
snippet = snippets.find_by_id(params.delete(:id))
2018-10-15 14:42:47 +05:30
break not_found!('Snippet') unless snippet
2017-08-17 22:00:37 +05:30
env['api.format'] = :txt
content_type 'text/plain'
2019-02-15 15:39:39 +05:30
header['Content-Disposition'] = 'attachment'
2020-05-24 23:13:21 +05:30
present content_for(snippet)
2017-08-17 22:00:37 +05:30
end
2017-09-10 17:25:29 +05:30
desc 'Get the user agent details for a snippet' do
success Entities::UserAgentDetail
end
params do
requires :id, type: Integer, desc: 'The ID of a snippet'
end
get ":id/user_agent_detail" do
authenticated_as_admin!
2019-07-07 11:18:12 +05:30
snippet = Snippet.find_by_id!(params[:id])
2017-09-10 17:25:29 +05:30
2018-10-15 14:42:47 +05:30
break not_found!('UserAgentDetail') unless snippet.user_agent_detail
2017-09-10 17:25:29 +05:30
present snippet.user_agent_detail, with: Entities::UserAgentDetail
end
2017-08-17 22:00:37 +05:30
end
end
end