gitlab 4.8.0 → 4.13.0

data/lib/gitlab/client/commits.rb

@@ -8,11 +8,11 @@ class Gitlab::Client
     #
     # @example
     #   Gitlab.commits('viking')
-    #   Gitlab.repo_commits('gitlab', { ref_name: 'api' })
+    #   Gitlab.repo_commits('gitlab', { ref: 'api' })
     #
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [Hash] options A customizable set of options.
-    # @option options [String] :ref_name The branch or tag name of a project repository.
+    # @option options [String] :ref The branch or tag name of a project repository.
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
@@ -35,6 +35,22 @@ class Gitlab::Client
     end
     alias repo_commit commit
 
+    # Get all references (from branches or tags) a commit is pushed to.
+    #
+    # @example
+    #   Gitlab.commit_refs(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :type The scope of commits. Possible values `branch`, `tag`, `all`. Default is `all`.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Gitlab::ObjectifiedHash]
+    def commit_refs(project, sha, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{sha}/refs", query: options)
+    end
+
     # Cherry picks a commit to a given branch.
     #
     # @example

data/lib/gitlab/client/container_registry.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to GitLab Container Registry.
+  # @see https://docs.gitlab.com/ce/api/container_registry.html
+  module ContainerRegistry
+    # Get a list of registry repositories in a project.
+    #
+    # @example
+    #   Gitlab.registry_repositories(5)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>] Returns list of registry repositories in a project.
+    def registry_repositories(project)
+      get("/projects/#{url_encode project}/registry/repositories")
+    end
+
+    # Delete a repository in registry.
+    #
+    # @example
+    #   Gitlab.delete_registry_repository(5, 2)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of registry repository.
+    # @return [void] This API call returns an empty response body.
+    def delete_registry_repository(project, id)
+      delete("/projects/#{url_encode project}/registry/repositories/#{id}")
+    end
+
+    # Get a list of tags for given registry repository.
+    #
+    # @example
+    #   Gitlab.registry_repository_tags(5, 2)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] repository_id The ID of registry repository.
+    # @return [Array<Gitlab::ObjectifiedHash>] Returns list of tags of a registry repository.
+    def registry_repository_tags(project, repository_id)
+      get("/projects/#{url_encode project}/registry/repositories/#{repository_id}/tags")
+    end
+
+    # Get details of a registry repository tag.
+    #
+    # @example
+    #   Gitlab.registry_repository_tag(5, 2, 'v10.0.0')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] repository_id The ID of registry repository.
+    # @param  [String] tag_name The name of tag.
+    # @return <Gitlab::ObjectifiedHash> Returns details about the registry repository tag
+    def registry_repository_tag(project, repository_id, tag_name)
+      get("/projects/#{url_encode project}/registry/repositories/#{repository_id}/tags/#{tag_name}")
+    end
+
+    # Delete a registry repository tag.
+    #
+    # @example
+    #   Gitlab.delete_registry_repository_tag(5, 2, 'v10.0.0')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] repository_id The ID of registry repository.
+    # @param  [String] tag_name The name of tag.
+    # @return [void] This API call returns an empty response body.
+    def delete_registry_repository_tag(project, repository_id, tag_name)
+      delete("/projects/#{url_encode project}/registry/repositories/#{repository_id}/tags/#{tag_name}")
+    end
+
+    # Delete repository tags in bulk based on given criteria.
+    #
+    # @example
+    #   Gitlab.bulk_delete_registry_repository_tags(5, 2, name_regex: '.*')
+    #   Gitlab.bulk_delete_registry_repository_tags(5, 2, name_regex: '[0-9a-z]{40}', keep_n: 5, older_than: '1d')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] repository_id The ID of registry repository.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :name_regex(required) The regex of the name to delete. To delete all tags specify .*.
+    # @option options [Integer] :keep_n(optional) The amount of latest tags of given name to keep.
+    # @option options [String] :older_than(required) Tags to delete that are older than the given time, written in human readable form 1h, 1d, 1month.
+    # @return [void] This API call returns an empty response body.
+    def bulk_delete_registry_repository_tags(project, repository_id, options = {})
+      delete("/projects/#{url_encode project}/registry/repositories/#{repository_id}/tags", query: options)
+    end
+  end
+end

data/lib/gitlab/client/epics.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to Epics.
+  # @see https://docs.gitlab.com/ee/api/epics.html
+  module Epics
+    # Gets a list of epics.
+    #
+    # @example
+    #   Gitlab.epics(123)
+    #   Gitlab.epics(123, { per_page: 40, page: 2 })
+    #
+    # @param  [Integer] group_id The ID of a group.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def epics(group_id, options = {})
+      get("/groups/#{group_id}/epics", query: options)
+    end
+
+    # Gets a single epic.
+    #
+    # @example
+    #   Gitlab.epic(123, 1)
+    #
+    # @param  [Integer] group_id The ID of a group.
+    # @param  [Integer] epic_iid The ID of a epic.
+    # @param  [Hash] options A customizable set of options.
+    # @return [Gitlab::ObjectifiedHash]
+    def epic(group_id, epic_iid, options = {})
+      get("/groups/#{group_id}/epics/#{epic_iid}", query: options)
+    end
+
+    # Creates a new epic.
+    #
+    # @example
+    #   Gitlab.create_epic(123, "My new epic title")
+    #
+    # @param  [Integer] group_id The ID of a group.
+    # @param  [String] title
+    # @param  [Hash] options A customizable set of options.
+    # @return [Gitlab::ObjectifiedHash] Information about created epic.
+    def create_epic(group_id, title, options = {})
+      body = options.merge(title: title)
+      post("/groups/#{group_id}/epics", body: body)
+    end
+
+    # Deletes an epic.
+    #
+    # @example
+    #   Gitlab.delete_epic(42, 123)
+    # @param  [Integer] group_id The ID of a group.
+    # @param  [Integer] epic_iid The IID of an epic.
+    def delete_epic(group_id, epic_iid)
+      delete("/groups/#{group_id}/epics/#{epic_iid}")
+    end
+
+    # Updates an existing epic.
+    #
+    # @example
+    #   Gitlab.edit_epic(42)
+    #   Gitlab.edit_epic(42, 123, { title: 'New epic title' })
+    #
+    # @param  [Integer] group_id The ID.
+    # @param  [Integer] epic_iid The IID of an epic.
+    # @param  [Hash] options A customizable set of options
+    # @return [Gitlab::ObjectifiedHash] Information about the edited epic.
+    def edit_epic(group_id, epic_iid, options = {})
+      put("/groups/#{group_id}/epics/#{epic_iid}", body: options)
+    end
+  end
+end

data/lib/gitlab/client/features.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to feature flags.
+  # https://docs.gitlab.com/ce/api/features.html
+  module Features
+    # Get a list of all persisted features, with its gate values.
+    #
+    # @example
+    #   Gitlab.features
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def features
+      get('/features')
+    end
+
+    # Set a features gate value.
+    # If a feature with the given name does not exist yet it will be created. The value can be a boolean, or an integer to indicate percentage of time.
+    #
+    # @example
+    #   Gitlab.set_feature('new_library', true)
+    #   Gitlab.set_feature('new_library', 8)
+    #   Gitlab.set_feature('new_library', true, {user: 'gitlab'})
+    #
+    # @param  [String] name(required) Name of the feature to create or update
+    # @param  [String, Integer] value(required) true or false to enable/disable, or an integer for percentage of time
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :feature_group(optional) A Feature group name
+    # @option options [String] :user(optional) A GitLab username
+    # @option options [String] :project(optional) A projects path, for example "gitlab-org/gitlab-ce"
+    # @return [Gitlab::ObjectifiedHash] Information about the set/created/updated feature.
+    def set_feature(name, value, options = {})
+      body = { value: value }.merge(options)
+      post("/features/#{name}", body: body)
+    end
+
+    # Delete a feature.
+    #
+    # @example
+    #   Gitlab.delete_feature('new_library')
+    #
+    # @param  [String] name Name of the feature to delete
+    # @return [void] This API call returns an empty response body.
+    def delete_feature(name)
+      delete("/features/#{name}")
+    end
+  end
+end

data/lib/gitlab/client/group_boards.rb

@@ -0,0 +1,141 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to group issue boards.
+  # @see https://docs.gitlab.com/ee/api/group_boards.html
+  module GroupBoards
+    # Lists Issue Boards in the given group.
+    #
+    # @example
+    #   Gitlab.group_boards(5)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @return [Array<Gitlab::ObjectifiedHash>] List of issue boards of the group
+    def group_boards(group)
+      get("/groups/#{url_encode group}/boards")
+    end
+
+    # Gets a single group issue board.
+    #
+    # @example
+    #   Gitlab.group_board(5, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] id The ID of the issue board.
+    # @return [Gitlab::ObjectifiedHash] Returns information about a group issue board
+    def group_board(group, id)
+      get("/groups/#{url_encode group}/boards/#{id}")
+    end
+
+    # Creates a new group issue board.
+    #
+    # @example
+    #   Gitlab.create_group_board(5, 'Documentcloud')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of the new board.
+    # @return [Gitlab::ObjectifiedHash] Information about created group issue board.
+    def create_group_board(group, name)
+      body = { name: name }
+      post("/groups/#{url_encode group}/boards", body: body)
+    end
+
+    # Updates a group issue board.
+    #
+    # @example
+    #   Gitlab.edit_group_board(5, 1, { name: 'DocumentCloud2' })
+    #   Gitlab.edit_group_board(5, 1, { name: 'DocumentCloud2', assignee_id: 3 })
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] id The ID of the issue board.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :name(optional) The new name of the board.
+    # @option options [Integer] :assignee_id(optional) The assignee the board should be scoped to.
+    # @option options [Integer] :milestone_id(optional) The milestone the board should be scoped to.
+    # @option options [String] :labels(optional) Comma-separated list of label names which the board should be scoped to.
+    # @option options [Integer] :weight(optional) The weight range from 0 to 9, to which the board should be scoped to.
+    # @return [Gitlab::ObjectifiedHash] Information about updated group issue board.
+    def edit_group_board(group, id, options = {})
+      put("/groups/#{url_encode group}/boards/#{id}", body: options)
+    end
+
+    # Deletes a group issue board.
+    #
+    # @example
+    #   Gitlab.delete_group_board(5, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] id The ID of the issue board.
+    # @return [void] This API call returns an empty response body.
+    def delete_group_board(group, id)
+      delete("/groups/#{url_encode group}/boards/#{id}")
+    end
+
+    # Get a list of the boards lists. Does not include open and closed lists
+    #
+    # @example
+    #   Gitlab.group_board_lists(5, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] board_id The ID of the group issue board.
+    # @return [Array<Gitlab::ObjectifiedHash>] List of boards lists of the group
+    def group_board_lists(group, board_id)
+      get("/groups/#{url_encode group}/boards/#{board_id}/lists")
+    end
+
+    # Get a single group issue board list.
+    #
+    # @example
+    #   Gitlab.group_board_list(5, 1, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] board_id The ID of the group issue board.
+    # @param  [Integer] list_id The ID of a boards list.
+    # @return [Gitlab::ObjectifiedHash] Returns information about a single group issue board list
+    def group_board_list(group, board_id, id)
+      get("/groups/#{url_encode group}/boards/#{board_id}/lists/#{id}")
+    end
+
+    # Creates a new group issue board list.
+    #
+    # @example
+    #   Gitlab.create_group_board_list(5, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] board_id The ID of the group issue board.
+    # @param  [Integer] label_id The ID of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about created group issue board list.
+    def create_group_board_list(group, board_id, label_id)
+      body = { label_id: label_id }
+      post("/groups/#{url_encode group}/boards/#{board_id}/lists", body: body)
+    end
+
+    # Updates an existing group issue board list. This call is used to change list position.
+    #
+    # @example
+    #   Gitlab.edit_group_board_list(5, 1, 1, { position: 1 })
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] board_id The ID of the group issue board.
+    # @param  [Integer] list_id The ID of a boards list.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :position(required) The position of the list.
+    # @return [Gitlab::ObjectifiedHash] Information about updated group issue board list.
+    def edit_group_board_list(group, board_id, id, options = {})
+      put("/groups/#{url_encode group}/boards/#{board_id}/lists/#{id}", body: options)
+    end
+
+    # Deletes a group issue board list.
+    #
+    # @example
+    #   Gitlab.delete_group_board_list(5, 1, 1)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] board_id The ID of the group issue board.
+    # @param  [Integer] list_id The ID of a boards list.
+    # @return [void] This API call returns an empty response body.
+    def delete_group_board_list(group, board_id, id)
+      delete("/groups/#{url_encode group}/boards/#{board_id}/lists/#{id}")
+    end
+  end
+end

data/lib/gitlab/client/group_labels.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to group labels.
+  #
+  # @note Requires GitLab 11.8+
+  # @see https://docs.gitlab.com/ee/api/group_labels.html
+  module GroupLabels
+    # Gets a list of group's labels.
+    #
+    # @example
+    #   Gitlab.group_labels('globex')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def group_labels(group, options = {})
+      get("/groups/#{url_encode group}/labels", query: options)
+    end
+
+    # Creates a new group label.
+    #
+    # @example
+    #   Gitlab.create_group_label('globex', 'Backlog', '#DD10AA')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of a label.
+    # @param  [String] color The color of a label.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description The description of the label.
+    # @return [Gitlab::ObjectifiedHash] Information about created label.
+    def create_group_label(group, name, color, options = {})
+      post("/groups/#{url_encode group}/labels", body: options.merge(name: name, color: color))
+    end
+
+    # Updates a group label.
+    #
+    # @example
+    #   Gitlab.edit_group_label('globex', 'Backlog', { new_name: 'Priority' })
+    #   Gitlab.edit_group_label('globex', 'Backlog', { new_name: 'Priority', color: '#DD10AA' })
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of a label.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :new_name The new name of a label.
+    # @option options [String] :color The color of a label.
+    # @option options [String] :description The description of the label.
+    # @return [Gitlab::ObjectifiedHash] Information about updated label.
+    def edit_group_label(group, name, options = {})
+      put("/groups/#{url_encode group}/labels", body: options.merge(name: name))
+    end
+
+    # Deletes a group label.
+    #
+    # @example
+    #   Gitlab.delete_group_label('globex', 'Backlog')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted label.
+    def delete_group_label(group, name)
+      delete("/groups/#{url_encode group}/labels", body: { name: name })
+    end
+
+    # Subscribes the user to a group label to receive notifications
+    #
+    # @example
+    #   Gitlab.subscribe_to_group_label('globex', 'Backlog')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about the label subscribed to.
+    def subscribe_to_group_label(group, name)
+      post("/groups/#{url_encode group}/labels/#{url_encode name}/subscribe")
+    end
+
+    # Unsubscribes the user from a group label to not receive notifications from it
+    #
+    # @example
+    #   Gitlab.unsubscribe_from_group_label('globex', 'Backlog')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about the label unsubscribed from.
+    def unsubscribe_from_group_label(group, name)
+      post("/groups/#{url_encode group}/labels/#{url_encode name}/unsubscribe")
+    end
+  end
+end