2018-09-29 22:34:47 +00:00
|
|
|
# frozen_string_literal: true
|
|
|
|
|
2013-11-15 13:24:10 +00:00
|
|
|
module API
|
2020-10-15 00:08:42 +00:00
|
|
|
class Namespaces < ::API::Base
|
2016-12-04 17:11:19 +00:00
|
|
|
include PaginationParams
|
|
|
|
|
2015-05-25 20:51:37 +00:00
|
|
|
before { authenticate! }
|
2013-11-15 13:24:10 +00:00
|
|
|
|
2018-12-07 13:29:53 +00:00
|
|
|
helpers do
|
|
|
|
params :optional_list_params_ee do
|
|
|
|
# EE::API::Namespaces would override this helper
|
|
|
|
end
|
|
|
|
|
|
|
|
# EE::API::Namespaces would override this method
|
|
|
|
def custom_namespace_present_options
|
|
|
|
{}
|
|
|
|
end
|
|
|
|
end
|
|
|
|
|
2021-05-11 21:10:21 +00:00
|
|
|
prepend_mod_with('API::Namespaces') # rubocop: disable Cop/InjectEnterpriseEditionModule
|
2019-09-13 13:26:31 +00:00
|
|
|
|
2013-11-15 13:24:10 +00:00
|
|
|
resource :namespaces do
|
2016-09-13 18:55:26 +00:00
|
|
|
desc 'Get a namespaces list' do
|
|
|
|
success Entities::Namespace
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
optional :search, type: String, desc: "Search query for namespaces"
|
2021-07-29 21:10:10 +00:00
|
|
|
optional :owned_only, type: Boolean, desc: "Owned namespaces only"
|
2018-12-07 13:29:53 +00:00
|
|
|
|
2016-12-04 17:11:19 +00:00
|
|
|
use :pagination
|
2018-12-07 13:29:53 +00:00
|
|
|
use :optional_list_params_ee
|
2016-09-13 18:55:26 +00:00
|
|
|
end
|
2022-04-06 15:08:23 +00:00
|
|
|
get feature_category: :subgroups do
|
2021-07-29 21:10:10 +00:00
|
|
|
owned_only = params[:owned_only] == true
|
|
|
|
|
|
|
|
namespaces = current_user.admin ? Namespace.all : current_user.namespaces(owned_only: owned_only)
|
2016-09-13 18:55:26 +00:00
|
|
|
|
2021-10-22 12:09:12 +00:00
|
|
|
namespaces = namespaces.without_project_namespaces.include_route
|
2020-10-12 03:08:20 +00:00
|
|
|
|
|
|
|
namespaces = namespaces.include_gitlab_subscription_with_hosted_plan if Gitlab.ee?
|
2019-12-23 15:07:48 +00:00
|
|
|
|
2016-09-13 18:55:26 +00:00
|
|
|
namespaces = namespaces.search(params[:search]) if params[:search].present?
|
2013-11-15 13:24:10 +00:00
|
|
|
|
2018-12-07 13:29:53 +00:00
|
|
|
options = { with: Entities::Namespace, current_user: current_user }
|
|
|
|
|
|
|
|
present paginate(namespaces), options.reverse_merge(custom_namespace_present_options)
|
2013-11-15 13:24:10 +00:00
|
|
|
end
|
2017-11-17 01:43:55 +00:00
|
|
|
|
|
|
|
desc 'Get a namespace by ID' do
|
|
|
|
success Entities::Namespace
|
|
|
|
end
|
|
|
|
params do
|
2017-11-23 13:32:16 +00:00
|
|
|
requires :id, type: String, desc: "Namespace's ID or path"
|
2017-11-17 01:43:55 +00:00
|
|
|
end
|
2022-04-06 15:08:23 +00:00
|
|
|
get ':id', requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS, feature_category: :subgroups do
|
2019-04-24 17:39:59 +00:00
|
|
|
user_namespace = find_namespace!(params[:id])
|
|
|
|
|
2017-11-23 13:32:16 +00:00
|
|
|
present user_namespace, with: Entities::Namespace, current_user: current_user
|
2017-11-17 01:43:55 +00:00
|
|
|
end
|
2021-04-19 18:09:09 +00:00
|
|
|
|
|
|
|
desc 'Get existence of a namespace including alternative suggestions' do
|
|
|
|
success Entities::NamespaceExistence
|
|
|
|
end
|
|
|
|
params do
|
|
|
|
requires :namespace, type: String, desc: "Namespace's path"
|
|
|
|
optional :parent_id, type: Integer, desc: "The ID of the parent namespace. If no ID is specified, only top-level namespaces are considered."
|
|
|
|
end
|
2022-04-06 15:08:23 +00:00
|
|
|
get ':namespace/exists', requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS, feature_category: :subgroups do
|
2021-04-19 18:09:09 +00:00
|
|
|
namespace_path = params[:namespace]
|
|
|
|
|
2021-10-29 12:14:45 +00:00
|
|
|
exists = Namespace.without_project_namespaces.by_parent(params[:parent_id]).filter_by_path(namespace_path).exists?
|
2021-04-19 18:09:09 +00:00
|
|
|
suggestions = exists ? [Namespace.clean_path(namespace_path)] : []
|
|
|
|
|
|
|
|
present :exists, exists
|
|
|
|
present :suggests, suggestions
|
|
|
|
end
|
2013-11-15 13:24:10 +00:00
|
|
|
end
|
|
|
|
end
|
|
|
|
end
|