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

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

207 lines
12 KiB
Ruby
Raw Normal View History

2018-12-05 23:21:45 +05:30
# frozen_string_literal: true
2018-05-09 12:01:36 +05:30
module API
module Helpers
module ProjectsHelpers
extend ActiveSupport::Concern
2019-09-04 21:01:54 +05:30
extend Grape::API::Helpers
2018-05-09 12:01:36 +05:30
2021-02-22 17:27:13 +05:30
STATISTICS_SORT_PARAMS = %w[storage_size repository_size wiki_size packages_size].freeze
2020-07-28 23:09:34 +05:30
2019-09-04 21:01:54 +05:30
params :optional_project_params_ce do
optional :description, type: String, desc: 'The description of the project'
2019-09-30 21:07:59 +05:30
optional :build_git_strategy, type: String, values: %w(fetch clone), desc: 'The Git strategy. Defaults to `fetch`'
optional :build_timeout, type: Integer, desc: 'Build timeout'
optional :auto_cancel_pending_pipelines, type: String, values: %w(disabled enabled), desc: 'Auto-cancel pending pipelines'
2019-09-04 21:01:54 +05:30
optional :ci_config_path, type: String, desc: 'The path to CI config file. Defaults to `.gitlab-ci.yml`'
2020-07-28 23:09:34 +05:30
optional :service_desk_enabled, type: Boolean, desc: 'Disable or enable the service desk'
2021-09-04 01:27:46 +05:30
optional :keep_latest_artifact, type: Boolean, desc: 'Indicates if the latest artifact should be kept for this project.'
2019-09-30 21:07:59 +05:30
# TODO: remove in API v5, replaced by *_access_level
2019-09-04 21:01:54 +05:30
optional :issues_enabled, type: Boolean, desc: 'Flag indication if the issue tracker is enabled'
optional :merge_requests_enabled, type: Boolean, desc: 'Flag indication if merge requests are enabled'
optional :wiki_enabled, type: Boolean, desc: 'Flag indication if the wiki is enabled'
optional :jobs_enabled, type: Boolean, desc: 'Flag indication if jobs are enabled'
optional :snippets_enabled, type: Boolean, desc: 'Flag indication if snippets are enabled'
2019-09-30 21:07:59 +05:30
optional :issues_access_level, type: String, values: %w(disabled private enabled), desc: 'Issues access level. One of `disabled`, `private` or `enabled`'
optional :repository_access_level, type: String, values: %w(disabled private enabled), desc: 'Repository access level. One of `disabled`, `private` or `enabled`'
optional :merge_requests_access_level, type: String, values: %w(disabled private enabled), desc: 'Merge requests access level. One of `disabled`, `private` or `enabled`'
2020-04-22 19:07:51 +05:30
optional :forking_access_level, type: String, values: %w(disabled private enabled), desc: 'Forks access level. One of `disabled`, `private` or `enabled`'
2019-09-30 21:07:59 +05:30
optional :wiki_access_level, type: String, values: %w(disabled private enabled), desc: 'Wiki access level. One of `disabled`, `private` or `enabled`'
optional :builds_access_level, type: String, values: %w(disabled private enabled), desc: 'Builds access level. One of `disabled`, `private` or `enabled`'
optional :snippets_access_level, type: String, values: %w(disabled private enabled), desc: 'Snippets access level. One of `disabled`, `private` or `enabled`'
2020-03-13 15:44:24 +05:30
optional :pages_access_level, type: String, values: %w(disabled private enabled public), desc: 'Pages access level. One of `disabled`, `private`, `enabled` or `public`'
2021-02-22 17:27:13 +05:30
optional :operations_access_level, type: String, values: %w(disabled private enabled), desc: 'Operations access level. One of `disabled`, `private` or `enabled`'
optional :analytics_access_level, type: String, values: %w(disabled private enabled), desc: 'Analytics access level. One of `disabled`, `private` or `enabled`'
2021-10-27 15:23:28 +05:30
optional :container_registry_access_level, type: String, values: %w(disabled private enabled), desc: 'Controls visibility of the container registry. One of `disabled`, `private` or `enabled`. `private` will make the container registry accessible only to project members (reporter role and above). `enabled` will make the container registry accessible to everyone who has access to the project. `disabled` will disable the container registry'
2022-05-07 20:08:51 +05:30
optional :security_and_compliance_access_level, type: String, values: %w(disabled private enabled), desc: 'Security and compliance access level. One of `disabled`, `private` or `enabled`'
2019-09-30 21:07:59 +05:30
2020-03-13 15:44:24 +05:30
optional :emails_disabled, type: Boolean, desc: 'Disable email notifications'
2020-05-24 23:13:21 +05:30
optional :show_default_award_emojis, type: Boolean, desc: 'Show default award emojis'
2021-10-29 20:43:33 +05:30
optional :warn_about_potentially_unwanted_characters, type: Boolean, desc: 'Warn about Potentially Unwanted Characters'
2022-07-16 23:28:13 +05:30
optional :enforce_auth_checks_on_uploads, type: Boolean, desc: 'Enforce auth check on uploads'
2019-09-04 21:01:54 +05:30
optional :shared_runners_enabled, type: Boolean, desc: 'Flag indication if shared runners are enabled for that project'
2022-07-16 23:28:13 +05:30
optional :resolve_outdated_diff_discussions, type: Boolean, desc: 'Automatically resolve merge request diff threads on lines changed with a push'
2019-12-26 22:10:19 +05:30
optional :remove_source_branch_after_merge, type: Boolean, desc: 'Remove the source branch by default after merge'
2021-10-27 15:23:28 +05:30
optional :container_registry_enabled, type: Boolean, desc: 'Deprecated: Use :container_registry_access_level instead. Flag indication if the container registry is enabled for that project'
2020-03-13 15:44:24 +05:30
optional :container_expiration_policy_attributes, type: Hash do
use :optional_container_expiration_policy_params
end
2019-09-04 21:01:54 +05:30
optional :lfs_enabled, type: Boolean, desc: 'Flag indication if Git LFS is enabled for that project'
optional :visibility, type: String, values: Gitlab::VisibilityLevel.string_values, desc: 'The visibility of the project.'
optional :public_builds, type: Boolean, desc: 'Perform public builds'
optional :request_access_enabled, type: Boolean, desc: 'Allow users to request member access'
optional :only_allow_merge_if_pipeline_succeeds, type: Boolean, desc: 'Only allow to merge if builds succeed'
2020-06-23 00:09:42 +05:30
optional :allow_merge_on_skipped_pipeline, type: Boolean, desc: 'Allow to merge if pipeline is skipped'
2022-07-16 23:28:13 +05:30
optional :only_allow_merge_if_all_discussions_are_resolved, type: Boolean, desc: 'Only allow to merge if all threads are resolved'
2021-09-04 01:27:46 +05:30
optional :tag_list, type: Array[String], coerce_with: ::API::Validations::Types::CommaSeparatedToArray.coerce, desc: 'Deprecated: Use :topics instead'
optional :topics, type: Array[String], coerce_with: ::API::Validations::Types::CommaSeparatedToArray.coerce, desc: 'The list of topics for a project'
2019-12-04 20:38:33 +05:30
# TODO: remove rubocop disable - https://gitlab.com/gitlab-org/gitlab/issues/14960
optional :avatar, type: File, desc: 'Avatar image for project' # rubocop:disable Scalability/FileUploads
2019-09-04 21:01:54 +05:30
optional :printing_merge_request_link_enabled, type: Boolean, desc: 'Show link to create/view merge request when pushing from the command line'
optional :merge_method, type: String, values: %w(ff rebase_merge merge), desc: 'The merge method used when merging merge requests'
2020-03-13 15:44:24 +05:30
optional :suggestion_commit_message, type: String, desc: 'The commit message used to apply merge request suggestions'
2021-12-11 22:18:48 +05:30
optional :merge_commit_template, type: String, desc: 'Template used to create merge commit message'
2022-01-26 12:08:38 +05:30
optional :squash_commit_template, type: String, desc: 'Template used to create squash commit message'
2019-09-04 21:01:54 +05:30
optional :initialize_with_readme, type: Boolean, desc: "Initialize a project with a README.md"
optional :ci_default_git_depth, type: Integer, desc: 'Default number of revisions for shallow cloning'
2019-09-30 21:07:59 +05:30
optional :auto_devops_enabled, type: Boolean, desc: 'Flag indication if Auto DevOps is enabled'
optional :auto_devops_deploy_strategy, type: String, values: %w(continuous manual timed_incremental), desc: 'Auto Deploy strategy'
2020-03-13 15:44:24 +05:30
optional :autoclose_referenced_issues, type: Boolean, desc: 'Flag indication if referenced issues auto-closing is enabled'
2020-04-08 14:13:33 +05:30
optional :repository_storage, type: String, desc: 'Which storage shard the repository is on. Available only to admins'
2020-10-24 23:57:45 +05:30
optional :packages_enabled, type: Boolean, desc: 'Enable project packages feature'
2021-09-30 23:02:18 +05:30
optional :squash_option, type: String, values: %w(never always default_on default_off), desc: 'Squash default for project. One of `never`, `always`, `default_on`, or `default_off`.'
2022-03-02 08:16:31 +05:30
optional :mr_default_target_self, Boolean, desc: 'Merge requests of this forked project targets itself by default'
2019-09-04 21:01:54 +05:30
end
params :optional_project_params_ee do
end
2019-07-07 11:18:12 +05:30
2019-09-04 21:01:54 +05:30
params :optional_project_params do
use :optional_project_params_ce
use :optional_project_params_ee
end
2019-12-04 20:38:33 +05:30
params :optional_create_project_params_ee do
end
params :optional_create_project_params do
use :optional_project_params
use :optional_create_project_params_ee
end
2019-09-04 21:01:54 +05:30
params :optional_filter_params_ee do
end
2018-05-09 12:01:36 +05:30
2021-01-03 14:25:43 +05:30
params :optional_update_params_ce do
optional :ci_forward_deployment_enabled, type: Boolean, desc: 'Skip older deployment jobs that are still pending'
2022-08-13 15:12:31 +05:30
optional :ci_separated_caches, type: Boolean, desc: 'Enable or disable separated caches based on branch protection.'
2021-03-08 18:12:59 +05:30
optional :restrict_user_defined_variables, type: Boolean, desc: 'Restrict use of user-defined variables when triggering a pipeline'
2021-01-03 14:25:43 +05:30
end
2019-09-04 21:01:54 +05:30
params :optional_update_params_ee do
2018-05-09 12:01:36 +05:30
end
2019-07-07 11:18:12 +05:30
2021-01-03 14:25:43 +05:30
params :optional_update_params do
use :optional_update_params_ce
use :optional_update_params_ee
end
2020-03-13 15:44:24 +05:30
params :optional_container_expiration_policy_params do
optional :cadence, type: String, desc: 'Container expiration policy cadence for recurring job'
2021-03-08 18:12:59 +05:30
optional :keep_n, type: Integer, desc: 'Container expiration policy number of images to keep'
2020-03-13 15:44:24 +05:30
optional :older_than, type: String, desc: 'Container expiration policy remove images older than value'
optional :name_regex, type: String, desc: 'Container expiration policy regex for image removal'
2020-04-22 19:07:51 +05:30
optional :name_regex_keep, type: String, desc: 'Container expiration policy regex for image retention'
2020-03-13 15:44:24 +05:30
optional :enabled, type: Boolean, desc: 'Flag indication if container expiration policy is enabled'
end
2019-07-07 11:18:12 +05:30
def self.update_params_at_least_one_of
[
2020-06-23 00:09:42 +05:30
:allow_merge_on_skipped_pipeline,
2022-05-07 20:08:51 +05:30
:analytics_access_level,
2020-03-13 15:44:24 +05:30
:autoclose_referenced_issues,
2019-09-30 21:07:59 +05:30
:auto_devops_enabled,
:auto_devops_deploy_strategy,
:auto_cancel_pending_pipelines,
:build_git_strategy,
:build_timeout,
:builds_access_level,
2019-07-07 11:18:12 +05:30
:ci_config_path,
2019-09-30 21:07:59 +05:30
:ci_default_git_depth,
2021-01-03 14:25:43 +05:30
:ci_forward_deployment_enabled,
2022-08-13 15:12:31 +05:30
:ci_separated_caches,
2021-10-27 15:23:28 +05:30
:container_registry_access_level,
2020-03-13 15:44:24 +05:30
:container_expiration_policy_attributes,
2019-07-07 11:18:12 +05:30
:default_branch,
:description,
2020-03-13 15:44:24 +05:30
:emails_disabled,
2020-04-22 19:07:51 +05:30
:forking_access_level,
2019-09-30 21:07:59 +05:30
:issues_access_level,
2019-07-07 11:18:12 +05:30
:lfs_enabled,
2021-10-27 15:23:28 +05:30
:merge_pipelines_enabled,
2019-09-30 21:07:59 +05:30
:merge_requests_access_level,
2021-10-27 15:23:28 +05:30
:merge_requests_template,
:merge_trains_enabled,
2019-07-07 11:18:12 +05:30
:merge_method,
:name,
:only_allow_merge_if_all_discussions_are_resolved,
:only_allow_merge_if_pipeline_succeeds,
2022-05-07 20:08:51 +05:30
:operations_access_level,
2020-03-13 15:44:24 +05:30
:pages_access_level,
2019-07-07 11:18:12 +05:30
:path,
:printing_merge_request_link_enabled,
:public_builds,
2019-12-26 22:10:19 +05:30
:remove_source_branch_after_merge,
2019-09-30 21:07:59 +05:30
:repository_access_level,
2019-07-07 11:18:12 +05:30
:request_access_enabled,
2019-09-30 21:07:59 +05:30
:resolve_outdated_diff_discussions,
2021-03-08 18:12:59 +05:30
:restrict_user_defined_variables,
2022-05-07 20:08:51 +05:30
:security_and_compliance_access_level,
2021-09-30 23:02:18 +05:30
:squash_option,
2019-07-07 11:18:12 +05:30
:shared_runners_enabled,
2019-09-30 21:07:59 +05:30
:snippets_access_level,
2019-07-07 11:18:12 +05:30
:tag_list,
2021-09-04 01:27:46 +05:30
:topics,
2019-07-07 11:18:12 +05:30
:visibility,
2019-09-30 21:07:59 +05:30
:wiki_access_level,
2019-07-07 11:18:12 +05:30
:avatar,
2020-03-13 15:44:24 +05:30
:suggestion_commit_message,
2021-12-11 22:18:48 +05:30
:merge_commit_template,
2022-01-26 12:08:38 +05:30
:squash_commit_template,
2020-04-08 14:13:33 +05:30
:repository_storage,
2020-10-24 23:57:45 +05:30
:packages_enabled,
2020-07-28 23:09:34 +05:30
:service_desk_enabled,
2021-09-04 01:27:46 +05:30
:keep_latest_artifact,
2022-03-02 08:16:31 +05:30
:mr_default_target_self,
2022-07-16 23:28:13 +05:30
:enforce_auth_checks_on_uploads,
2019-09-30 21:07:59 +05:30
# TODO: remove in API v5, replaced by *_access_level
:issues_enabled,
:jobs_enabled,
:merge_requests_enabled,
:wiki_enabled,
2021-10-27 15:23:28 +05:30
:snippets_enabled,
:container_registry_enabled
2019-07-07 11:18:12 +05:30
]
end
2019-09-30 21:07:59 +05:30
def filter_attributes_using_license!(attrs)
end
2021-12-11 22:18:48 +05:30
2022-01-26 12:08:38 +05:30
def validate_git_import_url!(import_url)
2021-12-11 22:18:48 +05:30
return if import_url.blank?
2022-01-26 12:08:38 +05:30
2021-12-11 22:18:48 +05:30
result = Import::ValidateRemoteGitEndpointService.new(url: import_url).execute # network call
if result.error?
render_api_error!(result.message, 422)
end
end
2018-05-09 12:01:36 +05:30
end
end
end
2019-12-04 20:38:33 +05:30
2021-06-08 01:23:25 +05:30
API::Helpers::ProjectsHelpers.prepend_mod_with('API::Helpers::ProjectsHelpers')