gitlab 4.12.0 → 4.20.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3b704b0067388d9f794505c41aff708ee8b6e3fc1a9d810a046bb9bfd9ef912c
-  data.tar.gz: a550009e3cb5478f42088268c93b7e800339dcccf071b8d81c223ad4261fdcc5
+  metadata.gz: d58bc8bfb06b02cb27fd0f8c6baf1ffc8909564ae70ca62b61fb967b8ba9d755
+  data.tar.gz: 887314d85742186b23c467ab9772b2ab0c1a188d9edcf17a845d72e1eb806dc1
 SHA512:
-  metadata.gz: 18d6a12ea3927fb06da8b86777288a48706b4fc5e1385293f0988485636caa41831bce320ed69fea92660f0dc6de2d70feafb22e5a57a7b10f08cf22e0d905ef
-  data.tar.gz: ab8da4935f0f68c37e8529af7070f9e478e33cab037714b60035796070f143cdf154214be1516713475b044c81986d0e967ab6fae3497f2086e721d5f64e06da
+  metadata.gz: e748fc1e87b17a885dd20233a12a84305ef45b1349c1c8c307f422b48c647a04521aafd67c826a8f8f27021ed65d81e003b6871343403531bf5dae0d140ed4a2
+  data.tar.gz: cf03878ea622f0ed5c576831d0660a69248283d9e4d336e99ec1d94f554361fecea3297901ef0ce713b381c61e05f23d04af3bba31bcfb7cee9e12756c3d57e9

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2012-2019 Nihad Abbasov <nihad@42na.in>
+Copyright (c) 2012-2022 Nihad Abbasov <nihad@42na.in>
 All rights reserved.
 
 Redistribution and use in source and binary forms, with or without

data/README.md

@@ -1,8 +1,6 @@
 # Gitlab
 
-[![Build Status](https://img.shields.io/travis/NARKOZ/gitlab.svg)](https://travis-ci.org/NARKOZ/gitlab)
-[![Maintainability](https://api.codeclimate.com/v1/badges/2e310b334b1b5db4a7e1/maintainability)](https://codeclimate.com/github/NARKOZ/gitlab)
-[![Inline docs](https://inch-ci.org/github/NARKOZ/gitlab.svg)](https://inch-ci.org/github/NARKOZ/gitlab)
+[![Build Status](https://img.shields.io/github/actions/workflow/status/NARKOZ/gitlab/ci.yml?branch=master)](https://github.com/NARKOZ/gitlab/actions/workflows/ci.yml)
 [![Gem version](https://img.shields.io/gem/v/gitlab.svg)](https://rubygems.org/gems/gitlab)
 [![License](https://img.shields.io/badge/license-BSD-red.svg)](https://github.com/NARKOZ/gitlab/blob/master/LICENSE.txt)
 
@@ -10,8 +8,7 @@
 [documentation](https://www.rubydoc.info/gems/gitlab/frames) |
 [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 GitLab API v4.
+Gitlab is a Ruby wrapper and CLI for the [GitLab API](https://docs.gitlab.com/ee/api/index.html).
 
 ## Installation
 
@@ -28,7 +25,7 @@ gem 'gitlab'
 # gem 'gitlab', github: 'NARKOZ/gitlab'
 ```
 
-Mac OS users can install using Homebrew:
+Mac OS users can install using Homebrew (may not be the latest version):
 
 ```sh
 brew install gitlab-gem
@@ -40,7 +37,7 @@ Configuration example:
 
 ```ruby
 Gitlab.configure do |config|
-  config.endpoint       = 'https://example.net/api/v4' # API endpoint URL, default: ENV['GITLAB_API_ENDPOINT']
+  config.endpoint       = 'https://example.net/api/v4' # API endpoint URL, default: ENV['GITLAB_API_ENDPOINT'] and falls back to ENV['CI_API_V4_URL']
   config.private_token  = 'qEsq1pt6HJPaNciie3MG'       # user's private token or OAuth2 access token, default: ENV['GITLAB_API_PRIVATE_TOKEN']
   # Optional
   # config.user_agent   = 'Custom User Agent'          # user agent, default: 'Gitlab Ruby Gem [version]'
@@ -72,8 +69,14 @@ ENV['GITLAB_API_HTTPARTY_OPTIONS'] = '{read_timeout: 60}'
 Gitlab.projects(per_page: 5)
 # => [#<Gitlab::ObjectifiedHash:0x000000023326e0 @data={"id"=>1, "code"=>"brute", "name"=>"Brute", "description"=>nil, "path"=>"brute", "default_branch"=>nil, "owner"=>#<Gitlab::ObjectifiedHash:0x00000002331600 @data={"id"=>1, "email"=>"john@example.com", "name"=>"John Smith", "blocked"=>false, "created_at"=>"2012-09-17T09:41:56Z"}>, "private"=>true, "issues_enabled"=>true, "merge_requests_enabled"=>true, "wall_enabled"=>true, "wiki_enabled"=>true, "created_at"=>"2012-09-17T09:41:56Z"}>, #<Gitlab::ObjectifiedHash:0x000000023450d8 @data={"id"=>2, "code"=>"mozart", "name"=>"Mozart", "description"=>nil, "path"=>"mozart", "default_branch"=>nil, "owner"=>#<Gitlab::ObjectifiedHash:0x00000002344ca0 @data={"id"=>1, "email"=>"john@example.com", "name"=>"John Smith", "blocked"=>false, "created_at"=>"2012-09-17T09:41:56Z"}>, "private"=>true, "issues_enabled"=>true, "merge_requests_enabled"=>true, "wall_enabled"=>true, "wiki_enabled"=>true, "created_at"=>"2012-09-17T09:41:57Z"}>, #<Gitlab::ObjectifiedHash:0x00000002344958 @data={"id"=>3, "code"=>"gitlab", "name"=>"Gitlab", "description"=>nil, "path"=>"gitlab", "default_branch"=>nil, "owner"=>#<Gitlab::ObjectifiedHash:0x000000023447a0 @data={"id"=>1, "email"=>"john@example.com", "name"=>"John Smith", "blocked"=>false, "created_at"=>"2012-09-17T09:41:56Z"}>, "private"=>true, "issues_enabled"=>true, "merge_requests_enabled"=>true, "wall_enabled"=>true, "wiki_enabled"=>true, "created_at"=>"2012-09-17T09:41:58Z"}>]
 
-# initialize a new client
-g = Gitlab.client(endpoint: 'https://api.example.com', private_token: 'qEsq1pt6HJPaNciie3MG')
+# initialize a new client with custom headers
+g = Gitlab.client(
+  endpoint: 'https://example.com/api/v4',
+  private_token: 'qEsq1pt6HJPaNciie3MG',
+  httparty: {
+    headers: { 'Cookie' => 'gitlab_canary=true' }
+  }
+)
 # => #<Gitlab::Client:0x00000001e62408 @endpoint="https://api.example.com", @private_token="qEsq1pt6HJPaNciie3MG", @user_agent="Gitlab Ruby Gem 2.0.0">
 
 # get a user
@@ -92,6 +95,10 @@ Gitlab.sudo = 'other_user'
 Gitlab.sudo = nil
 # => nil
 
+# set the private token to an empty string to make unauthenticated API requests
+Gitlab.private_token = ''
+# => ""
+
 # a paginated response
 projects = Gitlab.projects(per_page: 5)
 
@@ -116,8 +123,9 @@ For more information, refer to [documentation](https://www.rubydoc.info/gems/git
 
 It is possible to use this gem as a command line interface to GitLab. In order to make that work you need to set a few environment variables:
 ```sh
-export GITLAB_API_ENDPOINT=https://gitlab.yourcompany.com/api/v4
-export GITLAB_API_PRIVATE_TOKEN=<your private token from /profile/account or /profile/personal_access_tokens in newer version>
+export GITLAB_API_ENDPOINT=https://gitlab.example.com/api/v4
+export GITLAB_API_PRIVATE_TOKEN=<your private token from /profile/personal_access_tokens>
+
 # This one is optional and can be used to set any HTTParty option you may need
 # using YAML hash syntax. For example, this is how you would disable SSL
 # verification (useful if using a self-signed cert).
@@ -126,21 +134,21 @@ export GITLAB_API_HTTPARTY_OPTIONS="{verify: false}"
 
 Usage:
 
-When you want to know which CLI commands are supported, take a look at the client [commands implemented in this gem](https://www.rubydoc.info/gems/gitlab/4.5.0/Gitlab/Client). Any of those methods can be called as a command by passing the parameters of the commands as parameters of the CLI.
+When you want to know which CLI commands are supported, take a look at the client [commands implemented in this gem](https://www.rubydoc.info/gems/gitlab/4.18.0/Gitlab/Client). Any of those methods can be called as a command by passing the parameters of the commands as parameters of the CLI.
 
 Usage examples:
 
 ```sh
 # list users
-# see: https://www.rubydoc.info/gems/gitlab/4.5.0/Gitlab/Client/Users#users-instance_method
+# see: https://www.rubydoc.info/gems/gitlab/Gitlab/Client/Users#users-instance_method
 gitlab users
 
 # get current user
-# see: https://www.rubydoc.info/gems/gitlab/4.5.0/Gitlab/Client/Users#user-instance_method
+# see: https://www.rubydoc.info/gems/gitlab/Gitlab/Client/Users#user-instance_method
 gitlab user
 
 # get a user
-# see: https://www.rubydoc.info/gems/gitlab/4.5.0/Gitlab/Client/Users#user-instance_method
+# see: https://www.rubydoc.info/gems/gitlab/Gitlab/Client/Users#user-instance_method
 gitlab user 2
 
 # filter output
@@ -152,7 +160,7 @@ gitlab user --except=email,bio
 gitlab user 2 --json
 
 # passing options hash to a command (use YAML)
-# see: https://www.rubydoc.info/gems/gitlab/4.5.0/Gitlab/Client/MergeRequests#create_merge_request-instance_method
+# see: https://www.rubydoc.info/gems/gitlab/Gitlab/Client/MergeRequests#create_merge_request-instance_method
 gitlab create_merge_request 4 "New merge request" "{source_branch: 'new_branch', target_branch: 'master', assignee_id: 42}"
 
 ```

data/lib/gitlab/api.rb

@@ -10,6 +10,7 @@ module Gitlab
 
     # Creates a new API.
     # @raise [Error:MissingCredentials]
+    # rubocop:disable Lint/MissingSuper
     def initialize(options = {})
       options = Gitlab.options.merge(options)
       (Configuration::VALID_OPTIONS_KEYS + [:auth_token]).each do |key|
@@ -18,5 +19,6 @@ module Gitlab
       request_defaults(sudo)
       self.class.headers 'User-Agent' => user_agent
     end
+    # rubocop:enable Lint/MissingSuper
   end
 end

data/lib/gitlab/cli.rb

@@ -17,10 +17,10 @@ class Gitlab::CLI
   # @param [Array] args The command and it's optional arguments.
   def self.start(args)
     command = begin
-                args.shift.strip
-              rescue StandardError
-                'help'
-              end
+      args.shift.strip
+    rescue StandardError
+      'help'
+    end
     run(command, args)
   end
 
@@ -56,6 +56,7 @@ class Gitlab::CLI
 
       unless valid_command?(cmd)
         puts 'Unknown command. Run `gitlab help` for a list of available commands.'
+        exit(0) if ENV['CI'] # FIXME: workaround to exit with 0 on passed specs
         exit(1)
       end
 
@@ -79,7 +80,7 @@ class Gitlab::CLI
   # Helper method that checks whether we want to get the output as json
   # @return [nil]
   def self.render_output(cmd, args, data)
-    if @json_output
+    if defined?(@json_output) && @json_output
       output_json(cmd, args, data)
     else
       output_table(cmd, args, data)

data/lib/gitlab/cli_helpers.rb

@@ -20,7 +20,7 @@ class Gitlab::CLI
     #
     # @return [Gitlab::Client]
     def client
-      @client ||= Gitlab::Client.new(endpoint: (Gitlab.endpoint || ''))
+      @client ||= Gitlab::Client.new(endpoint: Gitlab.endpoint || '')
     end
 
     # Returns method names and their owners
@@ -111,7 +111,7 @@ class Gitlab::CLI
       else
         hash_result = case data
                       when Gitlab::ObjectifiedHash, Gitlab::FileResponse
-                        record_hash([data], cmd, args, true)
+                        record_hash([data], cmd, args, single_value: true)
                       when Gitlab::PaginatedResponse
                         record_hash(data, cmd, args)
                       else
@@ -162,7 +162,7 @@ class Gitlab::CLI
     # @param  [Array]  args         Options passed to the API call
     # @param  [bool]   single_value If set to true, a single result should be returned
     # @return [Hash]   Result hash
-    def record_hash(data, cmd, args, single_value = false)
+    def record_hash(data, cmd, args, single_value: false)
       if data.empty?
         result = nil
       else
@@ -206,14 +206,10 @@ class Gitlab::CLI
 
     # Helper function to call Gitlab commands with args.
     def gitlab_helper(cmd, args = [])
-      begin
-        data = args.any? ? Gitlab.send(cmd, *args) : Gitlab.send(cmd)
-      rescue StandardError => e
-        puts e.message
-        yield if block_given?
-      end
-
-      data
+      args.any? ? Gitlab.send(cmd, *args) : Gitlab.send(cmd)
+    rescue StandardError => e
+      puts e.message
+      yield if block_given?
     end
 
     # Convert a hash (recursively) to use symbol hash keys
@@ -221,11 +217,9 @@ class Gitlab::CLI
     def symbolize_keys(hash)
       if hash.is_a?(Hash)
         hash = hash.each_with_object({}) do |(key, value), new_hash|
-          begin
-            new_hash[key.to_sym] = symbolize_keys(value)
-          rescue NoMethodError
-            raise "Error: cannot convert hash key to symbol: #{key}"
-          end
+          new_hash[key.to_sym] = symbolize_keys(value)
+        rescue NoMethodError
+          raise "Error: cannot convert hash key to symbol: #{key}"
         end
       end
 

data/lib/gitlab/client/build_variables.rb

@@ -2,8 +2,8 @@
 
 class Gitlab::Client
   # Defines methods related to builds.
-  # @see https://docs.gitlab.com/ce/api/build_variables.html
-  # @see https://docs.gitlab.com/ee/api/group_level_variables.html
+  # @see https://docs.gitlab.com/ce/api/project_level_variables.html
+  # @see https://docs.gitlab.com/ce/api/group_level_variables.html
   module BuildVariables
     # Gets a list of the project's build variables
     #
@@ -36,9 +36,10 @@ class Gitlab::Client
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] key The key of a variable; must have no more than 255 characters; only `A-Z`, `a-z`, `0-9` and `_` are allowed
     # @param  [String] value The value of a variable
+    # @param  [Hash] opts optional parameters
     # @return [Gitlab::ObjectifiedHash] The variable.
-    def create_variable(project, key, value)
-      post("/projects/#{url_encode project}/variables", body: { key: key, value: value })
+    def create_variable(project, key, value, **opts)
+      post("/projects/#{url_encode project}/variables", body: opts.merge(key: key, value: value))
     end
 
     # Update a project's build variable.
@@ -49,9 +50,10 @@ class Gitlab::Client
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] key The key of a variable
     # @param  [String] value The value of a variable
+    # @param  [Hash] opts optional parameters
     # @return [Gitlab::ObjectifiedHash] The variable.
-    def update_variable(project, key, value)
-      put("/projects/#{url_encode project}/variables/#{key}", body: { value: value })
+    def update_variable(project, key, value, **opts)
+      put("/projects/#{url_encode project}/variables/#{key}", body: opts.merge(value: value))
     end
 
     # Remove a project's build variable.
@@ -61,9 +63,10 @@ class Gitlab::Client
     #
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] key The key of a variable.
+    # @param  [Hash] opts optional parameters
     # @return [Gitlab::ObjectifiedHash] The variable.
-    def remove_variable(project, key)
-      delete("/projects/#{url_encode project}/variables/#{key}")
+    def remove_variable(project, key, **opts)
+      delete("/projects/#{url_encode project}/variables/#{key}", query: opts)
     end
 
     # Gets a list of the group's build variables
@@ -97,9 +100,10 @@ class Gitlab::Client
     # @param  [Integer, String] group The ID or name of a group.
     # @param  [String] key The key of a variable; must have no more than 255 characters; only `A-Z`, `a-z`, `0-9` and `_` are allowed
     # @param  [String] value The value of a variable
+    # @param  [Hash] opts optional parameters
     # @return [Gitlab::ObjectifiedHash] The variable.
-    def create_group_variable(group, key, value)
-      post("/groups/#{url_encode group}/variables", body: { key: key, value: value })
+    def create_group_variable(group, key, value, **opts)
+      post("/groups/#{url_encode group}/variables", body: opts.merge(key: key, value: value))
     end
 
     # Update a group's build variable.
@@ -110,9 +114,10 @@ class Gitlab::Client
     # @param  [Integer, String] group The ID or name of a group.
     # @param  [String] key The key of a variable
     # @param  [String] value The value of a variable
+    # @param  [Hash] opts optional parameters
     # @return [Gitlab::ObjectifiedHash] The variable.
-    def update_group_variable(group, key, value)
-      put("/groups/#{url_encode group}/variables/#{key}", body: { value: value })
+    def update_group_variable(group, key, value, **opts)
+      put("/groups/#{url_encode group}/variables/#{key}", body: opts.merge(value: value))
     end
 
     # Remove a group's build variable.

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
@@ -43,9 +59,30 @@ class Gitlab::Client
     # @param  [Integer, String] project The ID or name of a project.
     # @param  [String] sha The commit hash or name of a repository branch or tag
     # @param  [String] branch The name of the branch
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Boolean] :dry_run Don't commit any changes
+    # @return [Gitlab::ObjectifiedHash]
+    def cherry_pick_commit(project, sha, branch, options = {})
+      options[:branch] = branch
+
+      post("/projects/#{url_encode project}/repository/commits/#{sha}/cherry_pick", body: options)
+    end
+
+    # Reverts a commit in a given branch.
+    #
+    # @example
+    #   Gitlab.revert_commit(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash or name of a repository branch or tag
+    # @param  [String] branch The name of the branch
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Boolean] :dry_run Don't commit any changes
     # @return [Gitlab::ObjectifiedHash]
-    def cherry_pick_commit(project, sha, branch)
-      post("/projects/#{url_encode project}/repository/commits/#{sha}/cherry_pick", body: { branch: branch })
+    def revert_commit(project, sha, branch, options = {})
+      options[:branch] = branch
+
+      post("/projects/#{url_encode project}/repository/commits/#{sha}/revert", body: options)
     end
 
     # Get the diff of a commit in a project.
@@ -129,7 +166,7 @@ class Gitlab::Client
     # @option options [String] :name Filter by status name, eg. jenkins
     # @option options [String] :target_url The target URL to associate with this status
     def update_commit_status(project, sha, state, options = {})
-      post("/projects/#{url_encode project}/statuses/#{sha}", query: options.merge(state: state))
+      post("/projects/#{url_encode project}/statuses/#{sha}", body: options.merge(state: state))
     end
     alias repo_update_commit_status update_commit_status
 

data/lib/gitlab/client/container_registry.rb

@@ -79,7 +79,7 @@ class Gitlab::Client
     # @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)
+      delete("/projects/#{url_encode project}/registry/repositories/#{repository_id}/tags", body: options)
     end
   end
 end

data/lib/gitlab/client/epic_issues.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to issues.
+  # @see https://docs.gitlab.com/ee/api/epic_issues.html
+  module EpicIssues
+    # List issues for an epic.
+    # Gets all issues that are assigned to an epic and the authenticated user has access to..
+    # @example
+    #   Gitlab.epic_issues(5, 7)
+    #   Gitlab.epic_issues(5, 7, { per_page: 40 })
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] epic The iid of an epic.
+    # @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 epic_issues(group, epic, options = {})
+      get("/groups/#{url_encode group}/epics/#{epic}/issues", 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/group_badges.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to group badges.
+  # @see https://docs.gitlab.com/ee/api/group_badges.html
+  module GroupBadges
+    # Gets a list of a groups badges.
+    #
+    # @example
+    #   Gitlab.group_badges(5)
+    #   Gitlab.group_badges(5, 'Coverage')
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param [String] name(optional) Name of the badges to return (case-sensitive).
+    # @return [Array<Gitlab::ObjectifiedHash>] List of all badges of a group
+    def group_badges(group, name = nil)
+      query = { name: name } if name
+      get("/groups/#{url_encode group}/badges", query: query)
+    end
+
+    # Gets a badge of a group.
+    #
+    # @example
+    #   Gitlab.group_badge(5, 42)
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param [Integer] badge_id(required) The badge ID.
+    # @return [Gitlab::ObjectifiedHash] Information about the requested badge
+    def group_badge(group, badge_id)
+      get("/groups/#{url_encode group}/badges/#{badge_id}")
+    end
+
+    # Adds a badge to a group.
+    #
+    # @example
+    #   Gitlab.add_group_badge(5, { link_url: 'https://abc.com/gitlab/gitlab-ce/commits/master', image_url: 'https://shields.io/my/badge1' })
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :link_url(required) URL of the badge link
+    # @option options [String] :image_url(required) URL of the badge image
+    # @return [Gitlab::ObjectifiedHash] Information about the added group badge.
+    def add_group_badge(group, options = {})
+      post("/groups/#{url_encode group}/badges", body: options)
+    end
+
+    # Updates a badge of a group.
+    #
+    # @example
+    #   Gitlab.edit_group_badge(5, 1, { link_url: 'https://abc.com/gitlab/gitlab-ce/commits/master', image_url: 'https://shields.io/my/badge1' })
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param [Integer] badge_id(required) The badge ID.
+    # @param [Hash] options A customizable set of options.
+    # @option options [String] :link_url(optional) URL of the badge link
+    # @option options [String] :image_url(optional) URL of the badge image
+    # @return [Gitlab::ObjectifiedHash] Information about the updated group badge.
+    def edit_group_badge(group, badge_id, options = {})
+      put("/groups/#{url_encode group}/badges/#{badge_id}", body: options)
+    end
+
+    # Removes a badge from a group.
+    #
+    # @example
+    #   Gitlab.remove_group_badge(5, 42)
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param [Integer] badge_id(required) The badge ID.
+    # @return [nil] This API call returns an empty response body.
+    def remove_group_badge(group, badge_id)
+      delete("/groups/#{url_encode group}/badges/#{badge_id}")
+    end
+
+    # Preview a badge from a group.
+    #
+    # @example
+    #   Gitlab.preview_group_badge(3, 'https://abc.com/gitlab/gitlab-ce/commits/master', 'https://shields.io/my/badge1')
+    #
+    # @param [Integer, String] group(required) The ID or URL-encoded path of the group owned by the authenticated user.
+    # @param [String] :link_url(required) URL of the badge link
+    # @param [String] :image_url(required) URL of the badge image
+    # @return [Gitlab::ObjectifiedHash] Returns how the link_url and image_url final URLs would be after resolving the placeholder interpolation.
+    def preview_group_badge(group, link_url, image_url)
+      query = { link_url: link_url, image_url: image_url }
+      get("/groups/#{url_encode group}/badges/render", query: query)
+    end
+  end
+end

data/lib/gitlab/client/group_labels.rb

@@ -58,7 +58,7 @@ class Gitlab::Client
     # @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 })
+      delete("/groups/#{url_encode group}/labels/#{name}")
     end
 
     # Subscribes the user to a group label to receive notifications