gitlab 4.9.0 → 4.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6829c32454f11e11d6b7b3b15dbebaeda3b439ac5b21b6a47bf52526dc742237
-  data.tar.gz: bfb53a22f9838c806ae52cac72fa65abde209c6dd09baea4308587e24a0d9aa3
+  metadata.gz: 1ffd49c727596fb28465bceabb3674b310772840169be0b80cacfbd2a415e266
+  data.tar.gz: 0f1ca4531f96bf17b640880089db77284336b69832fa5bbab31d35d60c128e4f
 SHA512:
-  metadata.gz: 8084547f4db3b39bbd1fb477d8a8e79dea2c73f6490551d0dfd77e685628ac57aabd8e02dca188898b7a1c04dd0083bfde9682767beb993fe86cd28522b268af
-  data.tar.gz: 2a7cd1d37840894dcb1e5653b565993beba6109f11961f2ddf3930739244151887cf40e28bcddad2e0394ff25610fadabd19ad63d3fbc8755112c548267bdbff
+  metadata.gz: f758f2a0b714d8ef390cb65ebe39d7fbc48f4e3230b252e79ee82ec4e5f0e352e4499fdf6df0f913f4799ccb3db4caaecfd5ed9a37463a330b4593d147de0494
+  data.tar.gz: 879cc8c1b0432435c3868dde4ad0f943875c8b719021f7c8b5965a775db8b3172ab0b239daa643b1e7f8575519ba5cf60963f7c2c2c858ec93e592e687bb89c3

data/README.md

@@ -11,7 +11,7 @@
 [gitlab-live](https://github.com/NARKOZ/gitlab-live)
 
 Gitlab is a Ruby wrapper and CLI for the [GitLab API](https://docs.gitlab.com/ce/api/README.html).  
-As of version `4.0.0` this gem only supports Ruby 2.0+ and GitLab API v4.
+As of version `4.0.0` this gem only supports GitLab API v4.
 
 ## Installation
 

data/lib/gitlab/client.rb

@@ -7,6 +7,7 @@ module Gitlab
 
     # Please keep in alphabetical order
     include AccessRequests
+    include Avatar
     include AwardEmojis
     include Boards
     include Branches
@@ -18,6 +19,8 @@ module Gitlab
     include Environments
     include Events
     include Features
+    include GroupBoards
+    include GroupLabels
     include GroupMilestones
     include Groups
     include Issues
@@ -43,6 +46,7 @@ module Gitlab
     include RepositorySubmodules
     include ResourceLabelEvents
     include Runners
+    include Search
     include Services
     include Sidekiq
     include Snippets

data/lib/gitlab/client/avatar.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to avatar.
+  # @see https://docs.gitlab.com/ce/api/avatar.html
+  module Avatar
+    # Get a single avatar URL for a user with the given email address.
+    #
+    # @example
+    #   Gitlab.avatar(email: 'admin@example.com')
+    #   Gitlab.avatar(email: 'admin@example.com', size: 32)
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :email(required) Public email address of the user.
+    # @option options [Integer] :size(optional) Single pixel dimension (since images are squares). Only used for avatar lookups at Gravatar or at the configured Libravatar server.
+    # @return <Gitlab::ObjectifiedHash>
+    def avatar(options = {})
+      get('/avatar', query: options)
+    end
+  end
+end

data/lib/gitlab/client/boards.rb

@@ -19,6 +19,62 @@ class Gitlab::Client
       get("/projects/#{url_encode project}/boards", query: options)
     end
 
+    # Get a single board.
+    #
+    # @example
+    #   Gitlab.board(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a board.
+    # @return [Gitlab::ObjectifiedHash] Returns information about the board
+    def board(project, id)
+      get("/projects/#{url_encode project}/boards/#{id}")
+    end
+
+    # Creates a new board.
+    #
+    # @example
+    #   Gitlab.create_board(5, 'newboard')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of the new board.
+    # @return [Gitlab::ObjectifiedHash] Information about created board.
+    def create_board(project, name)
+      body = { name: name }
+      post("/projects/#{url_encode project}/boards", body: body)
+    end
+
+    # Updates a board.
+    #
+    # @example
+    #   Gitlab.edit_board(5, 1, name: 'new_name')
+    #   Gitlab.edit_board(5, 1, name: 'new_name', assignee_id: 1, milestone_id: 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a 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 board.
+    def edit_board(project, id, options = {})
+      put("/projects/#{url_encode project}/boards/#{id}", body: options)
+    end
+
+    # Deletes a board.
+    #
+    # @example
+    #   Gitlab.delete_board(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a board.
+    # @return [void] This API call returns an empty response body.
+    def delete_board(project, id)
+      delete("/projects/#{url_encode project}/boards/#{id}")
+    end
+
     # Gets a board lists
     #
     # @example

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

data/lib/gitlab/client/groups.rb

@@ -191,5 +191,17 @@ class Gitlab::Client
     def edit_group(id, options = {})
       put("/groups/#{url_encode id}", body: options)
     end
+
+    # Gets a list of issues of a group.
+    #
+    # @example
+    #   Gitlab.group_issues(5)
+    #
+    # @param  [Integer, String] group_id The ID or name of a group.
+    # @param  [Hash] options A customizable set of options.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def group_issues(group, options = {})
+      get("/groups/#{group}/issues", query: options)
+    end
   end
 end

data/lib/gitlab/client/labels.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 class Gitlab::Client
-  # Defines methods related to labels.
+  # Defines methods related to project labels.
   # @see https://docs.gitlab.com/ce/api/labels.html
   module Labels
     # Gets a list of project's labels.

data/lib/gitlab/client/merge_requests.rb

@@ -55,6 +55,18 @@ class Gitlab::Client
       get("/projects/#{url_encode project}/merge_requests/#{id}/pipelines")
     end
 
+    # Get a list of merge request participants.
+    #
+    # @example
+    #   Gitlab.merge_request_participants(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a merge request.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_participants(project, id)
+      get("/projects/#{url_encode project}/merge_requests/#{id}/participants")
+    end
+
     # Creates a merge request.
     #
     # @example

data/lib/gitlab/client/search.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to global searches, searching in projects and searching in groups.
+  # @see https://docs.gitlab.com/ce/api/search.html
+  module Search
+    # Search globally across the GitLab instance.
+    #
+    # @example
+    #   Gitlab.search_globally('projects', 'gitlab')
+    #   Gitlab.search_globally('issues', 'gitlab')
+    #   Gitlab.search_globally('merge_requests', 'gitlab')
+    #   Gitlab.search_globally('milestones', 'gitlab')
+    #   Gitlab.search_globally('snippet_titles', 'gitlab')
+    #   Gitlab.search_globally('snippet_blobs', 'gitlab')
+    #
+    # @param  [String] scope The scope to search in. Currently these scopes are supported: projects, issues, merge_requests, milestones, snippet_titles, snippet_blobs.
+    # @param  [String] search The search query.
+    # @return [Array<Gitlab::ObjectifiedHash>] Returns a list of responses depending on the requested scope.
+    def search_globally(scope, search)
+      options = { scope: scope, search: search }
+      get('/search', query: options)
+    end
+
+    # Search within the specified group.
+    #
+    # @example
+    #   Gitlab.search_in_group(1, 'projects', 'gitlab')
+    #   Gitlab.search_in_group(1, 'issues', 'gitlab')
+    #   Gitlab.search_in_group(1, 'merge_requests', 'gitlab')
+    #   Gitlab.search_in_group(1, 'milestones', 'gitlab')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] scope The scope to search in. Currently these scopes are supported: projects, issues, merge_requests, milestones.
+    # @param  [String] search The search query.
+    # @return [Array<Gitlab::ObjectifiedHash>] Returns a list of responses depending on the requested scope.
+    def search_in_group(group, scope, search)
+      options = { scope: scope, search: search }
+      get("/groups/#{url_encode group}/search", query: options)
+    end
+
+    # Search within the specified project.
+    #
+    # @example
+    #   Gitlab.search_in_project(1, 'issues', 'gitlab')
+    #   Gitlab.search_in_project(1, 'merge_requests', 'gitlab')
+    #   Gitlab.search_in_project(1, 'milestones', 'gitlab')
+    #   Gitlab.search_in_project(1, 'notes', 'gitlab')
+    #   Gitlab.search_in_project(1, 'wiki_blobs', 'gitlab')
+    #   Gitlab.search_in_project(1, 'commits', 'gitlab')
+    #   Gitlab.search_in_project(1, 'blobs', 'gitlab')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] scope The scope to search in. Currently these scopes are supported: issues, merge_requests, milestones, notes, wiki_blobs, commits, blobs.
+    # @param  [String] search The search query.
+    # @return [Array<Gitlab::ObjectifiedHash>] Returns a list of responses depending on the requested scope.
+    def search_in_project(project, scope, search)
+      options = { scope: scope, search: search }
+      get("/projects/#{url_encode project}/search", query: options)
+    end
+  end
+end

data/lib/gitlab/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gitlab
-  VERSION = '4.9.0'
+  VERSION = '4.10.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gitlab
 version: !ruby/object:Gem::Version
-  version: 4.9.0
+  version: 4.10.0
 platform: ruby
 authors:
 - Nihad Abbasov
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2019-02-04 00:00:00.000000000 Z
+date: 2019-02-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httparty
@@ -140,6 +140,7 @@ files:
 - lib/gitlab/cli_helpers.rb
 - lib/gitlab/client.rb
 - lib/gitlab/client/access_requests.rb
+- lib/gitlab/client/avatar.rb
 - lib/gitlab/client/award_emojis.rb
 - lib/gitlab/client/boards.rb
 - lib/gitlab/client/branches.rb
@@ -151,6 +152,8 @@ files:
 - lib/gitlab/client/environments.rb
 - lib/gitlab/client/events.rb
 - lib/gitlab/client/features.rb
+- lib/gitlab/client/group_boards.rb
+- lib/gitlab/client/group_labels.rb
 - lib/gitlab/client/group_milestones.rb
 - lib/gitlab/client/groups.rb
 - lib/gitlab/client/issues.rb
@@ -176,6 +179,7 @@ files:
 - lib/gitlab/client/repository_submodules.rb
 - lib/gitlab/client/resource_label_events.rb
 - lib/gitlab/client/runners.rb
+- lib/gitlab/client/search.rb
 - lib/gitlab/client/services.rb
 - lib/gitlab/client/sidekiq.rb
 - lib/gitlab/client/snippets.rb