2016-11-26 15:37:26 +00:00
|
|
|
module API
|
|
|
|
# Snippets API
|
|
|
|
class Snippets < Grape::API
|
|
|
|
include PaginationParams
|
|
|
|
|
|
|
|
before { authenticate! }
|
|
|
|
|
|
|
|
resource :snippets do
|
|
|
|
helpers do
|
|
|
|
def snippets_for_current_user
|
2017-04-28 22:06:27 +00:00
|
|
|
SnippetsFinder.new(current_user, author: current_user).execute
|
2016-11-26 15:37:26 +00:00
|
|
|
end
|
|
|
|
|
|
|
|
def public_snippets
|
2017-04-28 22:06:27 +00:00
|
|
|
SnippetsFinder.new(current_user, visibility: Snippet::PUBLIC).execute
|
2016-11-26 15:37:26 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
|
|
|
|
desc 'Get a snippets list for authenticated user' do
|
|
|
|
detail 'This feature was introduced in GitLab 8.15.'
|
|
|
|
success Entities::PersonalSnippet
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
use :pagination
|
|
|
|
end
|
|
|
|
get do
|
|
|
|
present paginate(snippets_for_current_user), with: Entities::PersonalSnippet
|
|
|
|
end
|
|
|
|
|
|
|
|
desc 'List all public snippets current_user has access to' do
|
|
|
|
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
|
|
|
|
snippet = snippets_for_current_user.find(params[:id])
|
|
|
|
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
|
|
|
|
requires :title, type: String, desc: 'The title of a snippet'
|
|
|
|
requires :file_name, type: String, desc: 'The name of a snippet file'
|
|
|
|
requires :content, type: String, desc: 'The content of a snippet'
|
2017-05-03 15:26:49 +00:00
|
|
|
optional :description, type: String, desc: 'The description of a snippet'
|
2017-02-16 15:42:17 +00:00
|
|
|
optional :visibility, type: String,
|
|
|
|
values: Gitlab::VisibilityLevel.string_values,
|
|
|
|
default: 'internal',
|
|
|
|
desc: 'The visibility of the snippet'
|
2016-11-26 15:37:26 +00:00
|
|
|
end
|
|
|
|
post do
|
2017-03-01 20:23:00 +00:00
|
|
|
attrs = declared_params(include_missing: false).merge(request: request, api: true)
|
2016-11-26 15:37:26 +00:00
|
|
|
snippet = CreateSnippetService.new(nil, current_user, attrs).execute
|
|
|
|
|
2017-02-14 19:07:11 +00:00
|
|
|
render_spam_error! if snippet.spam?
|
|
|
|
|
2016-11-26 15:37:26 +00:00
|
|
|
if snippet.persisted?
|
|
|
|
present snippet, with: Entities::PersonalSnippet
|
|
|
|
else
|
|
|
|
render_validation_error!(snippet)
|
|
|
|
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'
|
|
|
|
optional :title, type: String, desc: 'The title of a snippet'
|
|
|
|
optional :file_name, type: String, desc: 'The name of a snippet file'
|
|
|
|
optional :content, type: String, desc: 'The content of a snippet'
|
2017-05-03 15:26:49 +00:00
|
|
|
optional :description, type: String, desc: 'The description of a snippet'
|
2017-02-16 15:42:17 +00:00
|
|
|
optional :visibility, type: String,
|
|
|
|
values: Gitlab::VisibilityLevel.string_values,
|
|
|
|
desc: 'The visibility of the snippet'
|
|
|
|
at_least_one_of :title, :file_name, :content, :visibility
|
2016-11-26 15:37:26 +00:00
|
|
|
end
|
|
|
|
put ':id' do
|
|
|
|
snippet = snippets_for_current_user.find_by(id: params.delete(:id))
|
2018-04-18 09:19:40 +00:00
|
|
|
break not_found!('Snippet') unless snippet
|
2017-11-14 09:02:39 +00:00
|
|
|
|
2016-11-26 15:37:26 +00:00
|
|
|
authorize! :update_personal_snippet, snippet
|
|
|
|
|
2017-03-01 20:23:00 +00:00
|
|
|
attrs = declared_params(include_missing: false).merge(request: request, api: true)
|
2016-11-26 15:37:26 +00:00
|
|
|
|
|
|
|
UpdateSnippetService.new(nil, current_user, snippet, attrs).execute
|
2017-02-14 19:07:11 +00:00
|
|
|
|
|
|
|
render_spam_error! if snippet.spam?
|
|
|
|
|
2016-11-26 15:37:26 +00:00
|
|
|
if snippet.persisted?
|
|
|
|
present snippet, with: Entities::PersonalSnippet
|
|
|
|
else
|
|
|
|
render_validation_error!(snippet)
|
|
|
|
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
|
|
|
|
snippet = snippets_for_current_user.find_by(id: params.delete(:id))
|
2018-04-18 09:19:40 +00:00
|
|
|
break not_found!('Snippet') unless snippet
|
2017-02-20 18:18:12 +00:00
|
|
|
|
2016-11-26 15:37:26 +00:00
|
|
|
authorize! :destroy_personal_snippet, snippet
|
2017-02-20 18:18:12 +00:00
|
|
|
|
2017-03-02 12:14:13 +00:00
|
|
|
destroy_conditionally!(snippet)
|
2016-11-26 15:37:26 +00:00
|
|
|
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
|
|
|
|
snippet = snippets_for_current_user.find_by(id: params.delete(:id))
|
2018-04-18 09:19:40 +00:00
|
|
|
break not_found!('Snippet') unless snippet
|
2016-11-26 15:37:26 +00:00
|
|
|
|
|
|
|
env['api.format'] = :txt
|
|
|
|
content_type 'text/plain'
|
|
|
|
present snippet.content
|
|
|
|
end
|
2017-07-05 14:27:32 +00:00
|
|
|
|
|
|
|
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!
|
|
|
|
|
2017-07-06 13:19:14 +00:00
|
|
|
snippet = Snippet.find_by!(id: params[:id])
|
2017-07-05 14:27:32 +00:00
|
|
|
|
2018-04-18 09:19:40 +00:00
|
|
|
break not_found!('UserAgentDetail') unless snippet.user_agent_detail
|
2017-07-05 14:27:32 +00:00
|
|
|
|
|
|
|
present snippet.user_agent_detail, with: Entities::UserAgentDetail
|
|
|
|
end
|
2016-11-26 15:37:26 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|