gitlab-customer-support-operations_gitlab 1.0.0

data/lib/support_ops_gitlab/gitlab/projects.rb

@@ -0,0 +1,741 @@
+# frozen_string_literal: true
+
+# Defines the module SupportOps.
+module SupportOps
+  # Defines the module GitLab
+  module GitLab
+    ##
+    # Defines the class Projects within the module {SupportOps::GitLab}.
+    #
+    # @author Jason Colyer
+    # @since 1.0.0
+    # @attr [Boolean] allow_merge_on_skipped_pipeline
+    # @attr [Boolean] allow_pipeline_trigger_approve_deployment
+    # @attr [String] analytics_access_level
+    # @attr [Boolean] archived
+    # @attr [String] auto_cancel_pending_pipelines
+    # @attr [Boolean] autoclose_referenced_issues
+    # @attr [String] auto_devops_deploy_strategy
+    # @attr [Boolean] auto_devops_enabled
+    # @attr [String] avatar_url
+    # @attr [String] build_git_strategy
+    # @attr [String] builds_access_level
+    # @attr [Integer] build_timeout
+    # @attr [Boolean] can_create_merge_request_in
+    # @attr [Boolean] ci_allow_fork_pipelines_to_run_in_parent_project
+    # @attr [String] ci_config_path
+    # @attr [Integer] ci_default_git_depth
+    # @attr [Boolean] ci_forward_deployment_enabled
+    # @attr [Boolean] ci_forward_deployment_rollback_allowed
+    # @attr [Array] ci_id_token_sub_claim_components
+    # @attr [String] ci_pipeline_variables_minimum_override_role
+    # @attr [Boolean] ci_push_repository_for_job_token_allowed
+    # @attr [String] ci_restrict_pipeline_cancellation_role
+    # @attr [Boolean] ci_separated_caches
+    # @attr [Array] compliance_frameworks
+    # @attr [Hash] container_expiration_policy
+    # @attr [Hash] container_expiration_policy_attributes
+    # @attr [String] container_registry_access_level
+    # @attr [Boolean] container_registry_enabled
+    # @attr [String] container_registry_image_prefix
+    # @attr [String] created_at
+    # @attr [Integer] creator_id
+    # @attr [String] default_branch
+    # @attr [String] description
+    # @attr [String] description_html
+    # @attr [Boolean] emails_enabled
+    # @attr [Boolean] enforce_auth_checks_on_uploads
+    # @attr [String] environments_access_level
+    # @attr [String] external_authorization_classification_label
+    # @attr [String] feature_flags_access_level
+    # @attr [Hash] forked_from_project
+    # @attr [String] forking_access_level
+    # @attr [Integer] forks_count
+    # @attr [Boolean] group_runners_enabled
+    # @attr [Integer] group_with_project_templates_id
+    # @attr [String] http_url_to_repo
+    # @attr [Integer] id
+    # @attr [String] import_error
+    # @attr [String] import_status
+    # @attr [String] import_type
+    # @attr [String] import_url
+    # @attr [String] infrastructure_access_level
+    # @attr [Boolean] initialize_with_readme
+    # @attr [String] issue_branch_template
+    # @attr [String] issues_access_level
+    # @attr [Boolean] issues_enabled
+    # @attr [String] issues_template
+    # @attr [Boolean] jobs_enabled
+    # @attr [String] last_activity_at
+    # @attr [Boolean] lfs_enabled
+    # @attr [Hash] license
+    # @attr [String] license_url
+    # @attr [Hash] _links
+    # @attr [String] marked_for_deletion_on
+    # @attr [String] merge_commit_template
+    # @attr [String] merge_method
+    # @attr [Boolean] merge_pipelines_enabled
+    # @attr [String] merge_requests_access_level
+    # @attr [Boolean] merge_requests_enabled
+    # @attr [String] merge_requests_template
+    # @attr [Boolean] merge_trains_enabled
+    # @attr [Boolean] merge_trains_skip_train_allowed
+    # @attr [Boolean] mirror
+    # @attr [Boolean] mirror_overwrites_diverged_branches
+    # @attr [Boolean] mirror_trigger_builds
+    # @attr [Integer] mirror_user_id
+    # @attr [String] model_experiments_access_level
+    # @attr [String] model_registry_access_level
+    # @attr [String] monitor_access_level
+    # @attr [Boolean] mr_default_target_self
+    # @attr [String] name
+    # @attr [String] namespace
+    # @attr [Integer] namespace_id
+    # @attr [String] name_with_namespace
+    # @attr [Boolean] only_allow_merge_if_all_discussions_are_resolved
+    # @attr [Boolean] only_allow_merge_if_all_status_checks_passed
+    # @attr [Boolean] only_allow_merge_if_pipeline_succeeds
+    # @attr [Boolean] only_mirror_protected_branches
+    # @attr [Integer] open_issues_count
+    # @attr [Hash] owner
+    # @attr [Boolean] packages_enabled
+    # @attr [String] pages_access_level
+    # @attr [String] path
+    # @attr [String] path_with_namespace
+    # @attr [Hash] permissions
+    # @attr [Boolean] printing_merge_request_link_enabled
+    # @attr [Boolean] printing_merge_requests_link_enabled
+    # @attr [Boolean] public_builds
+    # @attr [Boolean] public_jobs
+    # @attr [String] readme_url
+    # @attr [String] releases_access_level
+    # @attr [Boolean] remove_source_branch_after_merge
+    # @attr [String] repository_access_level
+    # @attr [String] repository_object_format
+    # @attr [String] repository_storage
+    # @attr [Boolean] request_access_enabled
+    # @attr [String] requirements_access_level
+    # @attr [Boolean] resolve_outdated_diff_discussions
+    # @attr [Boolean] restrict_user_defined_variables
+    # @attr [String] runners_token
+    # @attr [Boolean] secret_push_protection_enabled
+    # @attr [String] security_and_compliance_access_level
+    # @attr [String] service_desk_address
+    # @attr [Boolean] service_desk_enabled
+    # @attr [Boolean] shared_runners_enabled
+    # @attr [Array] shared_with_groups
+    # @attr [Boolean] show_default_award_emojis
+    # @attr [String] snippets_access_level
+    # @attr [Boolean] snippets_enabled
+    # @attr [String] squash_commit_template
+    # @attr [String] squash_option
+    # @attr [String] ssh_url_to_repo
+    # @attr [Integer] star_count
+    # @attr [Hash] statistics
+    # @attr [String] suggestion_commit_message
+    # @attr [String] template_name
+    # @attr [Integer] template_project_id
+    # @attr [Array] topics
+    # @attr [String] updated_at
+    # @attr [Boolean] use_custom_template
+    # @attr [String] visibility
+    # @attr [Boolean] warn_about_potentially_unwanted_characters
+    # @attr [String] web_url
+    # @attr [String] wiki_access_level
+    # @attr [Boolean] wiki_enabled
+    # @todo Add create/update example
+    # @todo Document members
+    #   https://docs.gitlab.com/api/members/#list-all-members-of-a-group-or-project
+    #   https://docs.gitlab.com/api/members/#list-all-members-of-a-group-or-project-including-inherited-and-invited-members
+    # @todo Document encoded_path
+    # @todo Document tokens
+    # @todo Document issues
+    # @todo Document merge_requests
+    # @todo Document pipelines
+    # @todo Document latest pipeline
+    # @todo Document latest jobs
+    # @todo Document webhooks
+    # @todo Document commits
+    # @todo Filters on #contributors
+    class Projects < SupportOps::GitLab::Base
+      # @!parse
+      #   # Creates/updates a project
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Object] Instance of {SupportOps::GitLab::Projects}
+      #   # @note This is inherited from {SupportOps::GitLab::Base#save!}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/projects/#create-a-project
+      #   #   GitLab API > Projects > Create a project
+      #   # @see
+      #   #   https://docs.gitlab.com/api/projects/#edit-a-project
+      #   #   GitLab API > Projects > Edit a project
+      #   def save!; end
+      # @!parse
+      #   # List events for a project
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::GitLab::Base#events}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/events/#list-all-visible-events-for-a-project
+      #   #   GitLab API > Events > List all visible events for a project
+      #   # @see SupportOps::GitLab::Configuration Setting up a client
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.example.com/api/v4'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   project = SupportOps::GitLab::Projects.get!(123456)
+      #   #   events = project.events
+      #   #   pp events.count
+      #   #   # => 482
+      #   def events; end
+      # @!parse
+      #   # Get contributor list
+      #   # 
+      #   # @author Jason Colyer
+      #   # @since 1.0.0
+      #   # @return [Boolean]
+      #   # @note This is inherited from {SupportOps::GitLab::Base#contributors}
+      #   # @see
+      #   #   https://docs.gitlab.com/api/repositories/#get-contributor-list
+      #   #   GitLab API > Repositories > Get contributor list
+      #   # @see SupportOps::GitLab::Configuration Setting up a client
+      #   # @example
+      #   #   require 'support_ops_gitlab'
+      #   #
+      #   #   SupportOps::GitLab::Configuration.configure do |config|
+      #   #     config.url = 'https://gitlab.example.com/api/v4'
+      #   #     config.token = 'abc123'
+      #   #   end
+      #   #
+      #   #   project = SupportOps::GitLab::Projects.get!(123456)
+      #   #   contributors = project.contributors
+      #   #   pp contributors.count
+      #   #   # => 13
+      #   #   pp contributors.first['commits']
+      #   #   # => 2
+      #   def contributors; end
+      define_attributes :allow_merge_on_skipped_pipeline,
+                        :allow_pipeline_trigger_approve_deployment,
+                        :analytics_access_level, :archived,
+                        :auto_cancel_pending_pipelines,
+                        :autoclose_referenced_issues,
+                        :auto_devops_deploy_strategy, :auto_devops_enabled,
+                        :avatar_url, :build_git_strategy, :builds_access_level,
+                        :build_timeout, :can_create_merge_request_in,
+                        :ci_allow_fork_pipelines_to_run_in_parent_project,
+                        :ci_config_path, :ci_default_git_depth,
+                        :ci_forward_deployment_enabled,
+                        :ci_forward_deployment_rollback_allowed,
+                        :ci_id_token_sub_claim_components,
+                        :ci_pipeline_variables_minimum_override_role,
+                        :ci_push_repository_for_job_token_allowed,
+                        :ci_restrict_pipeline_cancellation_role,
+                        :ci_separated_caches, :compliance_frameworks,
+                        :container_expiration_policy,
+                        :container_expiration_policy_attributes,
+                        :container_registry_access_level,
+                        :container_registry_enabled,
+                        :container_registry_image_prefix, :created_at,
+                        :creator_id, :default_branch, :description,
+                        :description_html, :emails_enabled,
+                        :enforce_auth_checks_on_uploads,
+                        :environments_access_level,
+                        :external_authorization_classification_label,
+                        :feature_flags_access_level, :forked_from_project,
+                        :forking_access_level, :forks_count,
+                        :group_runners_enabled,
+                        :group_with_project_templates_id, :http_url_to_repo,
+                        :id, :import_error, :import_status, :import_type,
+                        :import_url, :infrastructure_access_level,
+                        :initialize_with_readme, :issue_branch_template,
+                        :issues_access_level, :issues_enabled, :issues_template,
+                        :jobs_enabled, :last_activity_at, :lfs_enabled,
+                        :license, :license_url, :_links,
+                        :marked_for_deletion_on, :merge_commit_template,
+                        :merge_method, :merge_pipelines_enabled,
+                        :merge_requests_access_level, :merge_requests_enabled,
+                        :merge_requests_template, :merge_trains_enabled,
+                        :merge_trains_skip_train_allowed, :mirror,
+                        :mirror_overwrites_diverged_branches,
+                        :mirror_trigger_builds, :mirror_user_id,
+                        :model_experiments_access_level,
+                        :model_registry_access_level, :monitor_access_level,
+                        :mr_default_target_self, :name, :namespace,
+                        :namespace_id, :name_with_namespace,
+                        :only_allow_merge_if_all_discussions_are_resolved,
+                        :only_allow_merge_if_all_status_checks_passed,
+                        :only_allow_merge_if_pipeline_succeeds,
+                        :only_mirror_protected_branches, :open_issues_count,
+                        :owner, :packages_enabled, :pages_access_level, :path,
+                        :path_with_namespace, :permissions,
+                        :printing_merge_request_link_enabled,
+                        :printing_merge_requests_link_enabled, :public_builds,
+                        :public_jobs, :readme_url, :releases_access_level,
+                        :remove_source_branch_after_merge,
+                        :repository_access_level, :repository_object_format,
+                        :repository_storage, :request_access_enabled,
+                        :requirements_access_level,
+                        :resolve_outdated_diff_discussions,
+                        :restrict_user_defined_variables, :runners_token,
+                        :secret_push_protection_enabled,
+                        :security_and_compliance_access_level,
+                        :service_desk_address, :service_desk_enabled,
+                        :shared_runners_enabled, :shared_with_groups,
+                        :show_default_award_emojis, :snippets_access_level,
+                        :snippets_enabled, :squash_commit_template,
+                        :squash_option, :ssh_url_to_repo, :star_count,
+                        :statistics, :suggestion_commit_message, :template_name,
+                        :template_project_id, :topics, :updated_at,
+                        :use_custom_template, :visibility,
+                        :warn_about_potentially_unwanted_characters, :web_url,
+                        :wiki_access_level, :wiki_enabled
+      readonly_attributes :allow_pipeline_trigger_approve_deployment, :archived,
+                          :avatar_url, :can_create_merge_request_in,
+                          :ci_allow_fork_pipelines_to_run_in_parent_project,
+                          :ci_default_git_depth, :ci_forward_deployment_enabled,
+                          :ci_forward_deployment_rollback_allowed,
+                          :ci_id_token_sub_claim_components,
+                          :ci_pipeline_variables_minimum_override_role,
+                          :ci_push_repository_for_job_token_allowed,
+                          :ci_restrict_pipeline_cancellation_role,
+                          :ci_separated_caches, :compliance_frameworks,
+                          :container_expiration_policy,
+                          :container_registry_enabled,
+                          :container_registry_image_prefix, :created_at,
+                          :creator_id, :description_html,
+                          :enforce_auth_checks_on_uploads, :forked_from_project,
+                          :forks_count, :http_url_to_repo, :id, :import_error,
+                          :import_status, :import_type, :issue_branch_template,
+                          :issues_enabled, :issues_template, :jobs_enabled,
+                          :last_activity_at, :license, :license_url, :_links,
+                          :marked_for_deletion_on, :merge_commit_template,
+                          :merge_requests_enabled, :merge_requests_template,
+                          :mirror_overwrites_diverged_branches, :mirror_user_id,
+                          :mr_default_target_self, :namespace,
+                          :name_with_namespace, :only_mirror_protected_branches,
+                          :open_issues_count, :owner, :pages_access_level,
+                          :path_with_namespace, :permissions,
+                          :printing_merge_requests_link_enabled, :public_builds,
+                          :readme_url, :runners_token,
+                          :secret_push_protection_enabled,
+                          :service_desk_address, :service_desk_enabled,
+                          :shared_with_groups, :snippets_enabled,
+                          :squash_commit_template, :ssh_url_to_repo,
+                          :star_count, :statistics, :suggestion_commit_message,
+                          :updated_at, :web_url, :wiki_enabled
+
+      ##
+      # Lists projects in the GitLab system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param active [Boolean optional] Limit by projects that are not archived and not marked for deletion.
+      #   @param archived [Boolean optional] Limit by archived status.
+      #   @param id_after [Integer optional] Limit results to projects with IDs greater than the specified ID.
+      #   @param id_before [Integer optional] Limit results to projects with IDs less than the specified ID.
+      #   @param imported [Boolean optional] Limit results to projects which were imported from external systems by current user.
+      #   @param include_hidden [Boolean optional] Include hidden projects. (administrators only) Premium and Ultimate only.
+      #   @param include_pending_delete [Boolean optional] Include projects pending deletion. (administrators only)
+      #   @param last_activity_after [String optional] Limit results to projects with last activity after specified time. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ)
+      #   @param last_activity_before [String optional] Limit results to projects with last activity before specified time. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ)
+      #   @param marked_for_deletion_on [Boolean optional] Filter by date when project was marked for deletion. Introduced in GitLab 17.1. Premium and Ultimate only.
+      #   @param membership [Boolean optional] Limit by projects that the current user is a member of.
+      #   @param min_access_level [Integer optional] Limit by current user minimal role (access_level).
+      #   @param order_by [String optional] Return projects ordered by id, name, path, created_at, updated_at, star_count, last_activity_at, or similarity fields. repository_size, storage_size, packages_size or wiki_size fields are only allowed for administrators. similarity is only available when searching and is limited to projects that the current user is a member of. Default is created_at.
+      #   @param owned [Boolean optional] Limit by projects explicitly owned by the current user.
+      #   @param repository_checksum_failed [Boolean optional] Limit projects where the repository checksum calculation has failed. Premium and Ultimate only.
+      #   @param repository_storage [String optional] Limit results to projects stored on repository_storage. (administrators only)
+      #   @param search_namespaces [Boolean optional] Include ancestor namespaces when matching search criteria. Default is false.
+      #   @param sort [String optional] Return projects sorted in asc or desc order. Default is desc.
+      #   @param starred [Boolean optional] Limit by projects starred by the current user.
+      #   @param statistics [Boolean optional] Include project statistics. Available only to users with at least the Reporter role.
+      #   @param topic [String optional] Comma-separated topic names. Limit results to projects that match all of given topics. See topics attribute.
+      #   @param topic_id [Integer optional] Limit results to projects with the assigned topic given by the topic ID.
+      #   @param updated_after [String optional] Limit results to projects last updated after the specified time. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ). Introduced in GitLab 15.10. For this filter to work, you must also provide updated_at as the order_by attribute.
+      #   @param updated_before [String optional] Limit results to projects last updated before the specified time. Format: ISO 8601 (YYYY-MM-DDTHH:MM:SSZ). Introduced in GitLab 15.10. For this filter to work, you must also provide updated_at as the order_by attribute.
+      #   @param visibility [String optional] Limit by visibility public, internal, or private.
+      #   @param wiki_checksum_failed [Boolean optional] Limit projects where the wiki checksum calculation has failed. Premium and Ultimate only.
+      #   @param with_custom_attributes [Boolean optional] Include custom attributes in response. (administrator only)
+      #   @param with_issues_enabled [Boolean optional] Limit by enabled issues feature.
+      #   @param with_merge_requests_enabled [Boolean optional] Limit by enabled merge requests feature.
+      #   @param with_programming_language [String optional] Limit by projects which use the given programming language.      
+      #   @param limit [Integer optional] The limit to the number of users
+      #     returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://docs.gitlab.com/api/projects/#list-projects
+      #   GitLab API > Projects > List all projects
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.example.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   projects = SupportOps::GitLab::Projects.list(limit: 250)
+      #   pp projects.count
+      #   # => 250
+      #   pp projects.last.star_count
+      #   # => 4
+      def self.list(**args)
+        args[:active] = nil unless args[:active]
+        args[:archived] = nil unless args[:archived]
+        args[:id_after] = nil unless args[:id_after]
+        args[:id_before] = nil unless args[:id_before]
+        args[:imported] = nil unless args[:imported]
+        args[:include_hidden] = nil unless args[:include_hidden]
+        args[:include_pending_delete] = nil unless args[:include_pending_delete]
+        args[:last_activity_after] = nil unless args[:last_activity_after]
+        args[:last_activity_before] = nil unless args[:last_activity_before]
+        args[:marked_for_deletion_on] = nil unless args[:marked_for_deletion_on]
+        args[:membership] = nil unless args[:membership]
+        args[:min_access_level] = nil unless args[:min_access_level]
+        args[:order_by] = nil unless args[:order_by]
+        args[:owned] = nil unless args[:owned]
+        args[:repository_checksum_failed] = nil unless args[:repository_checksum_failed]
+        args[:repository_storage] = nil unless args[:repository_storage]
+        args[:search_namespaces] = nil unless args[:search_namespaces]
+        args[:sort] = nil unless args[:sort]
+        args[:starred] = nil unless args[:starred]
+        args[:statistics] = nil unless args[:statistics]
+        args[:topic] = nil unless args[:topic]
+        args[:topic_id] = nil unless args[:topic_id]
+        args[:updated_after] = nil unless args[:updated_after]
+        args[:updated_before] = nil unless args[:updated_before]
+        args[:visibility] = nil unless args[:visibility]
+        args[:wiki_checksum_failed] = nil unless args[:wiki_checksum_failed]
+        args[:with_custom_attributes] = nil unless args[:with_custom_attributes]
+        args[:with_issues_enabled] = nil unless args[:with_issues_enabled]
+        args[:with_merge_requests_enabled] = nil unless args[:with_merge_requests_enabled]
+        args[:with_programming_language] = nil unless args[:with_programming_language]
+        args[:limit] = 0 unless args[:limit]
+        params = ''
+        params += "active=#{args[:active]}&" unless args[:active].nil?
+        params += "archived=#{args[:archived]}&" unless args[:archived].nil?
+        params += "id_after=#{args[:id_after]}&" unless args[:id_after].nil?
+        params += "id_before=#{args[:id_before]}&" unless args[:id_before].nil?
+        params += "imported=#{args[:imported]}&" unless args[:imported].nil?
+        params += "include_hidden=#{args[:include_hidden]}&" unless args[:include_hidden].nil?
+        params += "include_pending_delete=#{args[:include_pending_delete]}&" unless args[:include_pending_delete].nil?
+        params += "last_activity_after=#{args[:last_activity_after]}&" unless args[:last_activity_after].nil?
+        params += "last_activity_before=#{args[:last_activity_before]}&" unless args[:last_activity_before].nil?
+        params += "marked_for_deletion_on=#{args[:marked_for_deletion_on]}&" unless args[:marked_for_deletion_on].nil?
+        params += "membership=#{args[:membership]}&" unless args[:membership].nil?
+        params += "min_access_level=#{args[:min_access_level]}&" unless args[:min_access_level].nil?
+        params += "order_by=#{args[:order_by]}&" unless args[:order_by].nil?
+        params += "owned=#{args[:owned]}&" unless args[:owned].nil?
+        params += "repository_checksum_failed=#{args[:repository_checksum_failed]}&" unless args[:repository_checksum_failed].nil?
+        params += "repository_storage=#{args[:repository_storage]}&" unless args[:repository_storage].nil?
+        params += "search_namespaces=#{args[:search_namespaces]}&" unless args[:search_namespaces].nil?
+        params += "sort=#{args[:sort]}&" unless args[:sort].nil?
+        params += "starred=#{args[:starred]}&" unless args[:starred].nil?
+        params += "statistics=#{args[:statistics]}&" unless args[:statistics].nil?
+        params += "topic=#{args[:topic]}&" unless args[:topic].nil?
+        params += "topic_id=#{args[:topic_id]}&" unless args[:topic_id].nil?
+        params += "updated_after=#{args[:updated_after]}&" unless args[:updated_after].nil?
+        params += "updated_before=#{args[:updated_before]}&" unless args[:updated_before].nil?
+        params += "visibility=#{args[:visibility]}&" unless args[:visibility].nil?
+        params += "wiki_checksum_failed=#{args[:wiki_checksum_failed]}&" unless args[:wiki_checksum_failed].nil?
+        params += "with_custom_attributes=#{args[:with_custom_attributes]}&" unless args[:with_custom_attributes].nil?
+        params += "with_issues_enabled=#{args[:with_issues_enabled]}&" unless args[:with_issues_enabled].nil?
+        params += "with_merge_requests_enabled=#{args[:with_merge_requests_enabled]}&" unless args[:with_merge_requests_enabled].nil?
+        params += "with_programming_language=#{args[:with_programming_language]}&" unless args[:with_programming_language].nil?
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("projects?#{params}&page=#{page}&per_page=100")
+          body = Oj.load(response.body)
+          array += body.map { |p| Projects.new(p) }
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break if body.count < 100
+
+          page += 1
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      ##
+      # Search for projects by name
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @overload list(key: value)
+      #   @param query [String optional] A string contained in the project name
+      #   @param sort [String optional] Return requests ordered by id, name,
+      #     created_at, star_count, or last_activity_at fields.
+      #   @param order_by [String optional] Return requests sorted in asc or
+      #     desc order
+      #   @param limit [Integer optional] The limit to the number of users
+      #     returned. Default to 0 (i.e. no limit)
+      # @return [Array]
+      # @see
+      #   https://docs.gitlab.com/api/projects/#search-for-projects-by-name
+      #   GitLab API > Projects > Search for projects by name
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.example.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   projects = SupportOps::GitLab::Projects.Search(query: 'Awesome', limit: 25)
+      #   pp projects.count
+      #   # => 25
+      #   pp projects.last.name
+      #   # => "Jason / Awesome project"
+      def self.search(**args)
+        args[:query] = nil unless args[:query]
+        raise 'You have to provide a search query' if args[:query].nil?
+
+        args[:order_by] = nil unless args[:order_by]
+        args[:sort] = nil unless args[:sort]
+        args[:limit] = 0 unless args[:limit]
+        params = ''
+        params += "order_by=#{args[:order_by]}&" unless args[:order_by].nil?
+        params += "sort=#{args[:sort]}&" unless args[:sort].nil?
+        params += "search=#{args[:query]}"
+        array = []
+        page = 1
+        loop do
+          response = client.connection.get("projects?#{params}&page=#{page}&per_page=100")
+          body = Oj.load(response.body)
+          pp body
+          array += body.map { |p| Projects.new(p) }
+          break if args[:limit].to_i.positive? && array.count >= args[:limit].to_i
+          break if body.count < 100
+
+          page += 1
+        end
+        return array if args[:limit].to_i.zero?
+        
+        array.first(args[:limit].to_i)
+      end
+
+      ##
+      # Locates a specific project in the GitLab system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://docs.gitlab.com/api/projects/#get-a-single-project
+      #   GitLab API > Projects > Get a single project
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   project = SupportOps::GitLab::Projects.get(13983927615772)
+      #   pp project.name
+      #   # => "Awesome project"
+      def self.get(object)
+        if object.is_a? Projects
+          Projects.new(id: id).find
+        else
+          Projects.new(id: object).find
+        end
+      end
+
+      ##
+      # Locates a specific project in the GitLab system
+      #
+      # @author Jason Colyer
+      # @since 1.0.0
+      # @see
+      #   https://docs.gitlab.com/api/projects/#get-a-single-project
+      #   GitLab API > Projects > Get a single project
+      # @see SupportOps::GitLab::Configuration Setting up a client
+      # @example
+      #   require 'support_ops_gitlab'
+      #
+      #   SupportOps::GitLab::Configuration.configure do |config|
+      #     config.url = 'https://gitlab.com/api/v4'
+      #     config.token = 'abc123'
+      #   end
+      #
+      #   project = SupportOps::GitLab::Projects.get!(13983927615772)
+      #   pp project.name
+      #   # => "Awesome project"
+      def self.get!(object)
+        if object.is_a? Projects
+          Projects.new(id: id).find!
+        else
+          Projects.new(id: object).find!
+        end
+      end
+
+      private
+
+      ##
+      # @private
+      def get_record
+        response = self.client.connection.get("projects/#{self.id}")
+        return nil if response.status != 200
+
+        Oj.load(response.body)
+      end
+
+      ##
+      # @private
+      def create_record
+        response = self.client.connection.post('projects', attributes_for_save.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to create project => #{body}" if response.status != 201
+        body
+      end
+
+      ##
+      # @private
+      def update_record
+        raise "Failed to update project => You didn't change anything in the object" if attributes_for_save.keys == [:id]
+        response = self.client.connection.put("projects/#{self.id}", attributes_for_save.to_json)
+        body = Oj.load(response.body)
+        raise "Failed to update project #{self.id} => #{body}" if response.status != 200
+        body
+      end
+
+      ##
+      # @private
+      def members_record(**args)
+        args[:all] = false unless args[:all]
+        args[:query] = nil unless args[:query]
+        args[:user_ids] = nil unless args[:user_ids]
+        args[:skip_users] = nil unless args[:skip_users]
+        args[:show_seat_info] = nil unless args[:show_seat_info]
+        params = ''
+        params += "query&" unless args[:query].nil?
+        params += "user_ids&" unless args[:user_ids].nil?
+        params += "skip_users&" unless args[:skip_users].nil?
+        params += "show_seat_info&" unless args[:show_seat_info].nil?
+        base_url = if args[:all]
+                     "projects/#{self.id}/members/all"
+                   else
+                    "projects/#{self.id}/members"
+                   end
+        array = []
+        page = 1
+        loop do
+          response = self.client.connection.get("#{base_url}?#{params}&page=#{page}&per_page=100")
+          pp "#{base_url}?#{params}&page=#{page}&per_page=100"
+          body = Oj.load(response.body)
+          array += body.map { |p| ProjectMemberships.new(p) }
+          break if body.count < 100
+          page += 1
+        end
+        array
+      end
+
+      ##
+      # @private
+      def encoded_path_record
+        ERB::Util.url_encode(self.path_with_namespace)
+      end
+
+      ##
+      # @private
+      def tokens_record
+        ProjectAccessTokens.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def badges_record
+        Badges.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def issues_record
+        Issues.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def merge_requests_record
+        MergeRequests.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def pipelines_record
+        Pipelines.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def latest_pipeline_record
+        response = self.client.connection.get("projects/#{self.id}/pipelines/latest")
+        body = Oj.load(response.body)
+        Pipelines.new(body)
+      end
+
+      ##
+      # @private
+      def jobs_record
+        array = []
+        page = 1
+        loop do
+          response = self.client.connection.get("projects/#{self.id}/jobs?per_page=100&page=#{page}")
+          body = Oj.load(response.body)
+          array += body.map { |j| Jobs.new(j) }
+          break if body.count < 100
+
+          page += 1
+        end
+        array
+      end
+
+      ##
+      # @private
+      def webhooks_record
+        ProjectWebhooks.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def commits_record
+        Commits.list(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def events_record
+        Events.list_project(project_id: self.id)
+      end
+
+      ##
+      # @private
+      def contributors_record
+        array = []
+        page = 1
+        loop do
+          response = self.client.connection.get("projects/#{self.id}/repository/contributors?per_page=100&page=#{page}")
+          body = Oj.load(response.body)
+          array += body
+          break if body.count < 100
+
+          page += 1
+        end
+        array
+      end
+    end
+  end
+end