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

140 lines
4.7 KiB
Ruby
Raw Normal View History

2018-12-05 23:21:45 +05:30
# frozen_string_literal: true
2018-03-17 18:26:18 +05:30
module API
2021-01-03 14:25:43 +05:30
class Search < ::API::Base
2018-03-17 18:26:18 +05:30
include PaginationParams
before { authenticate! }
2021-01-29 00:20:46 +05:30
feature_category :global_search
2018-03-17 18:26:18 +05:30
helpers do
SCOPE_ENTITY = {
merge_requests: Entities::MergeRequestBasic,
issues: Entities::IssueBasic,
projects: Entities::BasicProjectDetails,
milestones: Entities::Milestone,
notes: Entities::Note,
commits: Entities::CommitDetail,
blobs: Entities::Blob,
wiki_blobs: Entities::Blob,
snippet_titles: Entities::Snippet,
2019-07-07 11:18:12 +05:30
users: Entities::UserBasic
2018-03-17 18:26:18 +05:30
}.freeze
2020-06-23 00:09:42 +05:30
SCOPE_PRELOAD_METHOD = {
merge_requests: :with_api_entity_associations,
projects: :with_api_entity_associations,
issues: :with_api_entity_associations,
2020-07-28 23:09:34 +05:30
milestones: :with_api_entity_associations,
commits: :with_api_commit_entity_associations
2020-06-23 00:09:42 +05:30
}.freeze
2018-03-17 18:26:18 +05:30
def search(additional_params = {})
search_params = {
scope: params[:scope],
search: params[:search],
2020-11-24 15:15:51 +05:30
state: params[:state],
2021-01-03 14:25:43 +05:30
confidential: params[:confidential],
2018-03-17 18:26:18 +05:30
snippets: snippets?,
2021-01-29 00:20:46 +05:30
basic_search: params[:basic_search],
2018-03-17 18:26:18 +05:30
page: params[:page],
2021-01-29 00:20:46 +05:30
per_page: params[:per_page],
order_by: params[:order_by],
sort: params[:sort]
2018-03-17 18:26:18 +05:30
}.merge(additional_params)
2020-06-23 00:09:42 +05:30
results = SearchService.new(current_user, search_params).search_objects(preload_method)
Gitlab::UsageDataCounters::SearchCounter.count(:all_searches)
2018-03-17 18:26:18 +05:30
2019-02-15 15:39:39 +05:30
paginate(results)
2018-03-17 18:26:18 +05:30
end
def snippets?
2020-05-24 23:13:21 +05:30
%w(snippet_titles).include?(params[:scope]).to_s
2018-03-17 18:26:18 +05:30
end
def entity
SCOPE_ENTITY[params[:scope].to_sym]
end
2019-07-07 11:18:12 +05:30
2020-06-23 00:09:42 +05:30
def preload_method
SCOPE_PRELOAD_METHOD[params[:scope].to_sym]
end
2020-03-13 15:44:24 +05:30
def verify_search_scope!(resource:)
2019-07-07 11:18:12 +05:30
# In EE we have additional validation requirements for searches.
# Defining this method here as a noop allows us to easily extend it in
# EE, without having to modify this file directly.
end
2018-03-17 18:26:18 +05:30
end
resource :search do
desc 'Search on GitLab' do
detail 'This feature was introduced in GitLab 10.5.'
end
params do
requires :search, type: String, desc: 'The expression it should be searched for'
requires :scope,
type: String,
2019-07-07 11:18:12 +05:30
desc: 'The scope of the search',
values: Helpers::SearchHelpers.global_search_scopes
2020-11-24 15:15:51 +05:30
optional :state, type: String, desc: 'Filter results by state', values: Helpers::SearchHelpers.search_states
2021-01-03 14:25:43 +05:30
optional :confidential, type: Boolean, desc: 'Filter results by confidentiality'
2018-03-17 18:26:18 +05:30
use :pagination
end
get do
2020-03-13 15:44:24 +05:30
verify_search_scope!(resource: nil)
2019-07-07 11:18:12 +05:30
2018-03-17 18:26:18 +05:30
present search, with: entity
end
end
2019-02-15 15:39:39 +05:30
resource :groups, requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS do
2018-03-17 18:26:18 +05:30
desc 'Search on GitLab' do
detail 'This feature was introduced in GitLab 10.5.'
end
params do
requires :id, type: String, desc: 'The ID of a group'
requires :search, type: String, desc: 'The expression it should be searched for'
requires :scope,
type: String,
2019-07-07 11:18:12 +05:30
desc: 'The scope of the search',
values: Helpers::SearchHelpers.group_search_scopes
2020-11-24 15:15:51 +05:30
optional :state, type: String, desc: 'Filter results by state', values: Helpers::SearchHelpers.search_states
2021-01-03 14:25:43 +05:30
optional :confidential, type: Boolean, desc: 'Filter results by confidentiality'
2018-03-17 18:26:18 +05:30
use :pagination
end
2018-05-09 12:01:36 +05:30
get ':id/(-/)search' do
2020-03-13 15:44:24 +05:30
verify_search_scope!(resource: user_group)
2019-07-07 11:18:12 +05:30
2018-03-17 18:26:18 +05:30
present search(group_id: user_group.id), with: entity
end
end
2019-02-15 15:39:39 +05:30
resource :projects, requirements: API::NAMESPACE_OR_PROJECT_REQUIREMENTS do
2018-03-17 18:26:18 +05:30
desc 'Search on GitLab' do
detail 'This feature was introduced in GitLab 10.5.'
end
params do
requires :id, type: String, desc: 'The ID of a project'
requires :search, type: String, desc: 'The expression it should be searched for'
requires :scope,
type: String,
2019-07-07 11:18:12 +05:30
desc: 'The scope of the search',
values: Helpers::SearchHelpers.project_search_scopes
2019-09-04 21:01:54 +05:30
optional :ref, type: String, desc: 'The name of a repository branch or tag. If not given, the default branch is used'
2020-11-24 15:15:51 +05:30
optional :state, type: String, desc: 'Filter results by state', values: Helpers::SearchHelpers.search_states
2021-01-03 14:25:43 +05:30
optional :confidential, type: Boolean, desc: 'Filter results by confidentiality'
2018-03-17 18:26:18 +05:30
use :pagination
end
2018-05-09 12:01:36 +05:30
get ':id/(-/)search' do
2019-09-04 21:01:54 +05:30
present search({ project_id: user_project.id, repository_ref: params[:ref] }), with: entity
2018-03-17 18:26:18 +05:30
end
end
end
end
2019-12-04 20:38:33 +05:30
API::Search.prepend_if_ee('EE::API::Search')