debian-mirror-gitlab/lib/api/helpers/label_helpers.rb

151 lines
5 KiB
Ruby
Raw Normal View History

2019-03-02 22:35:43 +05:30
# frozen_string_literal: true
module API
module Helpers
module LabelHelpers
extend Grape::API::Helpers
params :label_create_params do
requires :name, type: String, desc: 'The name of the label to be created'
requires :color, type: String, desc: "The color of the label given in 6-digit hex notation with leading '#' sign (e.g. #FFAABB) or one of the allowed CSS color names"
2021-09-04 01:27:46 +05:30
optional :description, type: String, desc: 'The description of label to be created'
2019-03-02 22:35:43 +05:30
end
2019-12-21 20:55:43 +05:30
params :label_update_params do
optional :new_name, type: String, desc: 'The new name of the label'
optional :color, type: String, desc: "The new color of the label given in 6-digit hex notation with leading '#' sign (e.g. #FFAABB) or one of the allowed CSS color names"
2021-09-04 01:27:46 +05:30
optional :description, type: String, desc: 'The new description of label'
2019-12-21 20:55:43 +05:30
end
params :project_label_update_params do
use :label_update_params
optional :priority, type: Integer, desc: 'The priority of the label', allow_blank: true
2021-09-04 01:27:46 +05:30
at_least_one_of :new_name, :color, :description, :priority
2019-12-21 20:55:43 +05:30
end
params :group_label_update_params do
use :label_update_params
2021-09-04 01:27:46 +05:30
at_least_one_of :new_name, :color, :description
2019-12-21 20:55:43 +05:30
end
2021-01-29 00:20:46 +05:30
def find_label(parent, id_or_title, params = { include_ancestor_groups: true })
labels = available_labels_for(parent, params)
2019-12-04 20:38:33 +05:30
label = labels.find_by_id(id_or_title) || labels.find_by_title(id_or_title)
2019-03-02 22:35:43 +05:30
label || not_found!('Label')
end
2021-01-29 00:20:46 +05:30
def get_labels(parent, entity, params = {})
present paginate(available_labels_for(parent, params)),
2019-10-12 21:52:04 +05:30
with: entity,
current_user: current_user,
parent: parent,
with_counts: params[:with_counts]
2019-03-02 22:35:43 +05:30
end
2021-01-29 00:20:46 +05:30
def get_label(parent, entity, params = {})
label = find_label(parent, params_id_or_title, params)
2019-12-21 20:55:43 +05:30
present label, with: entity, current_user: current_user, parent: parent
end
2019-03-02 22:35:43 +05:30
def create_label(parent, entity)
authorize! :admin_label, parent
label = available_labels_for(parent).find_by_title(params[:name])
conflict!('Label already exists') if label
priority = params.delete(:priority)
label_params = declared_params(include_missing: false)
2019-12-04 20:38:33 +05:30
label = ::Labels::CreateService.new(label_params).execute(create_service_params(parent))
2019-03-02 22:35:43 +05:30
if label.persisted?
if parent.is_a?(Project)
label.prioritize!(parent, priority) if priority
end
present label, with: entity, current_user: current_user, parent: parent
else
render_validation_error!(label)
end
end
def update_label(parent, entity)
authorize! :admin_label, parent
2019-12-04 20:38:33 +05:30
label = find_label(parent, params_id_or_title, include_ancestor_groups: false)
2019-03-02 22:35:43 +05:30
update_priority = params.key?(:priority)
priority = params.delete(:priority)
2019-12-04 20:38:33 +05:30
# params is used to update the label so we need to remove this field here
params.delete(:label_id)
2019-12-21 20:55:43 +05:30
params.delete(:name)
2019-12-04 20:38:33 +05:30
2022-07-01 11:34:44 +05:30
update_params = declared_params(include_missing: false)
if update_params.present?
authorize! :admin_label, label
label = ::Labels::UpdateService.new(update_params).execute(label)
render_validation_error!(label) unless label.valid?
end
2019-03-02 22:35:43 +05:30
if parent.is_a?(Project) && update_priority
if priority.nil?
label.unprioritize!(parent)
else
label.prioritize!(parent, priority)
end
end
present label, with: entity, current_user: current_user, parent: parent
end
def delete_label(parent)
2019-12-04 20:38:33 +05:30
label = find_label(parent, params_id_or_title, include_ancestor_groups: false)
2019-03-02 22:35:43 +05:30
2022-07-01 11:34:44 +05:30
authorize! :admin_label, label
2019-03-02 22:35:43 +05:30
destroy_conditionally!(label)
end
2019-12-04 20:38:33 +05:30
2019-12-21 20:55:43 +05:30
def promote_label(parent)
2022-01-26 12:08:38 +05:30
unless parent.group
render_api_error!('Failed to promote project label to group label', 400)
end
authorize! :admin_label, parent.group
2019-12-21 20:55:43 +05:30
label = find_label(parent, params[:name], include_ancestor_groups: false)
begin
group_label = ::Labels::PromoteService.new(parent, current_user).execute(label)
if group_label
present group_label, with: Entities::GroupLabel, current_user: current_user, parent: parent.group
else
render_api_error!('Failed to promote project label to group label', 400)
end
2021-06-08 01:23:25 +05:30
rescue StandardError => error
2019-12-21 20:55:43 +05:30
render_api_error!(error.to_s, 400)
end
end
2019-12-04 20:38:33 +05:30
def params_id_or_title
@params_id_or_title ||= params[:label_id] || params[:name]
end
def create_service_params(parent)
if parent.is_a?(Project)
{ project: parent }
elsif parent.is_a?(Group)
{ group: parent }
else
raise TypeError, 'Parent type is not supported'
end
end
2019-03-02 22:35:43 +05:30
end
end
end