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

112 lines
3.6 KiB
Ruby
Raw Normal View History

2016-06-22 15:30:34 +05:30
module API
class Templates < Grape::API
2017-08-17 22:00:37 +05:30
include PaginationParams
2016-09-13 17:45:13 +05:30
GLOBAL_TEMPLATE_TYPES = {
2016-11-03 12:29:30 +05:30
gitignores: {
klass: Gitlab::Template::GitignoreTemplate,
gitlab_version: 8.8
},
gitlab_ci_ymls: {
klass: Gitlab::Template::GitlabCiYmlTemplate,
gitlab_version: 8.9
2017-08-17 22:00:37 +05:30
},
dockerfiles: {
klass: Gitlab::Template::DockerfileTemplate,
gitlab_version: 8.15
2016-11-03 12:29:30 +05:30
}
2016-06-22 15:30:34 +05:30
}.freeze
2016-11-03 12:29:30 +05:30
PROJECT_TEMPLATE_REGEX =
2018-03-17 18:26:18 +05:30
%r{[\<\{\[]
2016-11-03 12:29:30 +05:30
(project|description|
one\sline\s.+\swhat\sit\sdoes\.) # matching the start and end is enough here
2018-03-17 18:26:18 +05:30
[\>\}\]]}xi.freeze
2016-11-03 12:29:30 +05:30
YEAR_TEMPLATE_REGEX = /[<{\[](year|yyyy)[>}\]]/i.freeze
FULLNAME_TEMPLATE_REGEX =
2018-03-17 18:26:18 +05:30
%r{[\<\{\[]
2016-11-03 12:29:30 +05:30
(fullname|name\sof\s(author|copyright\sowner))
2018-03-17 18:26:18 +05:30
[\>\}\]]}xi.freeze
2016-06-22 15:30:34 +05:30
2016-09-13 17:45:13 +05:30
helpers do
2016-11-03 12:29:30 +05:30
def parsed_license_template
# We create a fresh Licensee::License object since we'll modify its
# content in place below.
template = Licensee::License.new(params[:name])
template.content.gsub!(YEAR_TEMPLATE_REGEX, Time.now.year.to_s)
template.content.gsub!(PROJECT_TEMPLATE_REGEX, params[:project]) if params[:project].present?
fullname = params[:fullname].presence || current_user.try(:name)
template.content.gsub!(FULLNAME_TEMPLATE_REGEX, fullname) if fullname
template
end
2016-09-13 17:45:13 +05:30
def render_response(template_type, template)
not_found!(template_type.to_s.singularize) unless template
present template, with: Entities::Template
end
end
2017-08-17 22:00:37 +05:30
desc 'Get the list of the available license template' do
detail 'This feature was introduced in GitLab 8.7.'
2018-03-17 18:26:18 +05:30
success ::API::Entities::License
2017-08-17 22:00:37 +05:30
end
params do
optional :popular, type: Boolean, desc: 'If passed, returns only popular licenses'
use :pagination
end
get "templates/licenses" do
options = {
2018-03-17 18:26:18 +05:30
featured: declared(params)[:popular].present? ? true : nil
2017-08-17 22:00:37 +05:30
}
licences = ::Kaminari.paginate_array(Licensee::License.all(options))
2018-03-17 18:26:18 +05:30
present paginate(licences), with: Entities::License
2016-11-03 12:29:30 +05:30
end
2017-08-17 22:00:37 +05:30
desc 'Get the text for a specific license' do
detail 'This feature was introduced in GitLab 8.7.'
2018-03-17 18:26:18 +05:30
success ::API::Entities::License
2017-08-17 22:00:37 +05:30
end
params do
requires :name, type: String, desc: 'The name of the template'
end
get "templates/licenses/:name", requirements: { name: /[\w\.-]+/ } do
2018-03-17 18:26:18 +05:30
not_found!('License') unless Licensee::License.find(declared(params)[:name])
2016-11-03 12:29:30 +05:30
2017-08-17 22:00:37 +05:30
template = parsed_license_template
2016-11-03 12:29:30 +05:30
2018-03-17 18:26:18 +05:30
present template, with: ::API::Entities::License
2016-11-03 12:29:30 +05:30
end
2017-08-17 22:00:37 +05:30
2016-11-03 12:29:30 +05:30
GLOBAL_TEMPLATE_TYPES.each do |template_type, properties|
klass = properties[:klass]
gitlab_version = properties[:gitlab_version]
2017-08-17 22:00:37 +05:30
desc 'Get the list of the available template' do
detail "This feature was introduced in GitLab #{gitlab_version}."
success Entities::TemplatesList
end
params do
use :pagination
end
get "templates/#{template_type}" do
templates = ::Kaminari.paginate_array(klass.all)
present paginate(templates), with: Entities::TemplatesList
2016-11-03 12:29:30 +05:30
end
2017-08-17 22:00:37 +05:30
desc 'Get the text for a specific template present in local filesystem' do
detail "This feature was introduced in GitLab #{gitlab_version}."
success Entities::Template
end
params do
requires :name, type: String, desc: 'The name of the template'
end
get "templates/#{template_type}/:name" do
2018-03-17 18:26:18 +05:30
new_template = klass.find(declared(params)[:name])
2016-11-03 12:29:30 +05:30
2017-08-17 22:00:37 +05:30
render_response(template_type, new_template)
2016-06-22 15:30:34 +05:30
end
end
end
end