fs-gitlab 4.18.1

data/lib/gitlab/client/award_emojis.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to Award Emojis.
+  # @see https://docs.gitlab.com/ce/api/award_emoji.html
+  module AwardEmojis
+    # Gets a list of all award emoji for an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.award_emojis(1, 80, 'issue')
+    #   Gitlab.award_emojis(1, 60, 'merge_request')
+    #   Gitlab.award_emojis(1, 40, 'snippet')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def award_emojis(project, awardable_id, awardable_type)
+      get("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/award_emoji")
+    end
+
+    # Gets a list of all award emoji for a single note on an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.note_award_emojis(1, 80, 'issue', 1)
+    #   Gitlab.note_award_emojis(1, 60, 'merge_request', 1)
+    #   Gitlab.note_award_emojis(1, 40, 'snippet', 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] note_id The ID of a note.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def note_award_emojis(project, awardable_id, awardable_type, note_id)
+      get("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/notes/#{note_id}/award_emoji")
+    end
+
+    # Gets a single award emoji for an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.award_emoji(1, 80, 'issue', 4)
+    #   Gitlab.award_emoji(1, 60, 'merge_request', 4)
+    #   Gitlab.award_emoji(1, 40, 'snippet', 4)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] award_id The ID of an award emoji.
+    # @return [Gitlab::ObjectifiedHash]
+    def award_emoji(project, awardable_id, awardable_type, award_id)
+      get("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/award_emoji/#{award_id}")
+    end
+
+    # Gets a single award emoji from a single note on an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.note_award_emoji(1, 80, 'issue', 1, 4)
+    #   Gitlab.note_award_emoji(1, 60, 'merge_request', 1, 4)
+    #   Gitlab.note_award_emoji(1, 40, 'snippet', 1, 4)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] note_id The ID of a note.
+    # @param [Integer] award_id The ID of an award emoji.
+    # @return [Gitlab::ObjectifiedHash]
+    def note_award_emoji(project, awardable_id, awardable_type, note_id, award_id)
+      get("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/notes/#{note_id}/award_emoji/#{award_id}")
+    end
+
+    # Awards a new emoji to an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.create_award_emoji(1, 80, 'issue', 'blowfish')
+    #   Gitlab.create_award_emoji(1, 80, 'merge_request', 'blowfish')
+    #   Gitlab.create_award_emoji(1, 80, 'snippet', 'blowfish')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [String] emoji_name The name of the emoji, without colons.
+    # @return [Gitlab::ObjectifiedHash]
+    def create_award_emoji(project, awardable_id, awardable_type, emoji_name)
+      post("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/award_emoji", body: { name: emoji_name })
+    end
+
+    # Awards a new emoji to a note on an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.create_note_award_emoji(1, 80, 'issue', 1, 'blowfish')
+    #   Gitlab.create_note_award_emoji(1, 80, 'merge_request', 1, 'blowfish')
+    #   Gitlab.create_note_award_emoji(1, 80, 'snippet', 1, 'blowfish')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] note_id The ID of a note.
+    # @param [String] emoji_name The name of the emoji, without colons.
+    # @return [Gitlab::ObjectifiedHash]
+    def create_note_award_emoji(project, awardable_id, awardable_type, note_id, emoji_name)
+      post("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/notes/#{note_id}/award_emoji", body: { name: emoji_name })
+    end
+
+    # Deletes a single award emoji from an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.delete_award_emoji(1, 80, 'issue', 4)
+    #   Gitlab.delete_award_emoji(1, 60, 'merge_request', 4)
+    #   Gitlab.delete_award_emoji(1, 40, 'snippet', 4)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] award_id The ID of an award emoji.
+    # @return [void] This API call returns an empty response body.
+    def delete_award_emoji(project, awardable_id, awardable_type, award_id)
+      delete("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/award_emoji/#{award_id}")
+    end
+
+    # Deletes a single award emoji from a single note on an awardable(issue, merge request or snippet)
+    #
+    # @example
+    #   Gitlab.delete_note_award_emoji(1, 80, 'issue', 1, 4)
+    #   Gitlab.delete_note_award_emoji(1, 60, 'merge_request', 1, 4)
+    #   Gitlab.delete_note_award_emoji(1, 40, 'snippet', 1, 4)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] awardable_id The ID of an awardable(issue, merge request or snippet).
+    # @param [String] awardable_type The type of the awardable(can be 'issue', 'merge_request' or 'snippet')
+    # @param [Integer] note_id The ID of a note.
+    # @param [Integer] award_id The ID of an award emoji.
+    # @return [void] This API call returns an empty response body.
+    def delete_note_award_emoji(project, awardable_id, awardable_type, note_id, award_id)
+      delete("/projects/#{url_encode project}/#{awardable_type}s/#{awardable_id}/notes/#{note_id}/award_emoji/#{award_id}")
+    end
+  end
+end

data/lib/gitlab/client/boards.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to issue boards.
+  # @see https://docs.gitlab.com/ce/api/boards.html
+  module Boards
+    # Gets a list of project's boards.
+    #
+    # @example
+    #   Gitlab.boards(5)
+    #   Gitlab.boards({ per_page: 40 })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @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 boards(project, options = {})
+      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
+    #   Gitlab.board_lists(5, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a board.
+    # @return [Gitlab::ObjectifiedHash]
+    def board_lists(project, id)
+      get("/projects/#{url_encode project}/boards/#{id}/lists")
+    end
+
+    #
+    # Gets a single board list
+    #
+    # @example
+    #   Gitlab.board_list(5, 42, 25)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] board_id The ID of a board.
+    # @param  [Integer] id The ID of a list.
+    # @return [Gitlab::ObjectifiedHash]
+    def board_list(project, board_id, id)
+      get("/projects/#{url_encode project}/boards/#{board_id}/lists/#{id}")
+    end
+
+    # Creates a new board list.
+    # Only for admins and project owners
+    #
+    # @example
+    #   Gitlab.create_board_list(5, 42, 25)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a board.
+    # @param  [Integer] label_id The ID of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about created list.
+    def create_board_list(project, board_id, label_id)
+      post("/projects/#{url_encode project}/boards/#{board_id}/lists", body: { label_id: label_id })
+    end
+
+    # Updates a board list.
+    # Only for admins and project owners
+    #
+    # @example
+    #   Gitlab.edit_board_list(6, 1, 12, 5)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] board_id The ID of a board.
+    # @param  [Integer] id The ID of a list.
+    # @return [Gitlab::ObjectifiedHash] Information about updated board list.
+    def edit_board_list(project, board_id, id, position)
+      put("/projects/#{url_encode project}/boards/#{board_id}/lists/#{id}", body: { position: position })
+    end
+
+    # Deletes  a board list.
+    # Only for admins and project owners
+    #
+    # @example
+    #   Gitlab.delete_board_list(3, 42, 32)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] board_id The ID of a board.
+    # @param  [Integer] id The ID of a list.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted board list.
+    def delete_board_list(project, board_id, id)
+      delete("/projects/#{url_encode project}/boards/#{board_id}/lists/#{id}")
+    end
+  end
+end

data/lib/gitlab/client/branches.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to repositories.
+  # @see https://docs.gitlab.com/ce/api/branches.html
+  module Branches
+    # Gets a list of project repositiory branches.
+    #
+    # @example
+    #   Gitlab.branches(42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @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 branches(project, options = {})
+      get("/projects/#{url_encode project}/repository/branches", query: options)
+    end
+    alias repo_branches branches
+
+    # Gets information about a repository branch.
+    #
+    # @example
+    #   Gitlab.branch(3, 'api')
+    #   Gitlab.repo_branch(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] branch The name of the branch.
+    # @return [Gitlab::ObjectifiedHash]
+    def branch(project, branch)
+      get("/projects/#{url_encode project}/repository/branches/#{url_encode branch}")
+    end
+    alias repo_branch branch
+
+    # Protects a repository branch.
+    #
+    # @example
+    #   Gitlab.protect_branch(3, 'api')
+    #   Gitlab.repo_protect_branch(5, 'master')
+    #   Gitlab.protect_branch(5, 'api', developers_can_push: true)
+    #
+    # To update options, call `protect_branch` again with new options (i.e. `developers_can_push: false`)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] branch The name of the branch.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Boolean] :developers_can_push True to allow developers to push to the branch (default = false)
+    # @option options [Boolean] :developers_can_merge True to allow developers to merge into the branch (default = false)
+    # @return [Gitlab::ObjectifiedHash] Details about the branch
+    def protect_branch(project, branch, options = {})
+      post("/projects/#{url_encode project}/protected_branches", body: { name: branch }.merge(options))
+    end
+    alias repo_protect_branch protect_branch
+
+    # Unprotects a repository branch.
+    #
+    # @example
+    #   Gitlab.unprotect_branch(3, 'api')
+    #   Gitlab.repo_unprotect_branch(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] branch The name of the branch.
+    # @return [Gitlab::ObjectifiedHash] Details about the branch
+    def unprotect_branch(project, branch)
+      delete("/projects/#{url_encode project}/protected_branches/#{url_encode branch}")
+    end
+    alias repo_unprotect_branch unprotect_branch
+
+    # Creates a repository branch.  Requires Gitlab >= 6.8.x
+    #
+    # @example
+    #   Gitlab.create_branch(3, 'api', 'feat/new-api')
+    #   Gitlab.repo_create_branch(5, 'master', 'develop')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] branch The name of the new branch.
+    # @param  [String] ref Create branch from commit sha or existing branch
+    # @return [Gitlab::ObjectifiedHash] Details about the branch
+    def create_branch(project, branch, ref)
+      post("/projects/#{url_encode project}/repository/branches", query: { branch: branch, ref: ref })
+    end
+    alias repo_create_branch create_branch
+
+    # Deletes a repository branch.  Requires Gitlab >= 6.8.x
+    #
+    # @example
+    #   Gitlab.delete_branch(3, 'api')
+    #   Gitlab.repo_delete_branch(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] branch The name of the branch to delete
+    def delete_branch(project, branch)
+      delete("/projects/#{url_encode project}/repository/branches/#{url_encode branch}")
+    end
+    alias repo_delete_branch delete_branch
+
+    # Delete all branches that are merged into the project default branch. Protected branches will not be deleted as part of this operation.
+    #
+    # @example
+    #   Gitlab.delete_merged_branches(3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [nil] This API call returns an empty response body.
+    def delete_merged_branches(project)
+      delete("/projects/#{url_encode project}/repository/merged_branches")
+    end
+    alias repo_delete_merged_branches delete_merged_branches
+
+    # Gets a list of protected branches from a project.
+    #
+    # @example
+    #   Gitlab.protected_branches(42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def protected_branches(project)
+      get("/projects/#{url_encode project}/protected_branches")
+    end
+    alias repo_protected_branches protected_branches
+
+    # Gets a single protected branch or wildcard protected branch
+    #
+    # @example
+    #   Gitlab.protected_branch(3, 'api')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of the branch or wildcard
+    # @return [Gitlab::ObjectifiedHash]
+    def protected_branch(project, branch)
+      get("/projects/#{url_encode project}/protected_branches/#{url_encode branch}")
+    end
+    alias repo_protected_branch protected_branch
+  end
+end

data/lib/gitlab/client/broadcast_messages.rb

@@ -0,0 +1,75 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to broadcast messages (only accessible to administrators).
+  # @see https://docs.gitlab.com/ce/api/broadcast_messages.html
+  module BroadcastMessages
+    # Get all broadcast messages
+    #
+    # @example
+    #   Gitlab.broadcast_messages
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def broadcast_messages
+      get('/broadcast_messages')
+    end
+
+    # Get a specific broadcast message
+    #
+    # @example
+    #   Gitlab.broadcast_message(3)
+    #
+    # @param  [Integer] id The ID of broadcast message
+    # @return [Gitlab::ObjectifiedHash]
+    def broadcast_message(id)
+      get("/broadcast_messages/#{id}")
+    end
+
+    # Create a broadcast message.
+    #
+    # @example
+    #   Gitlab.create_broadcast_message('Mayday')
+    #   Gitlab.create_broadcast_message('Mayday', {starts_at: Time.zone.now, ends_at: Time.zone.now + 30.minutes, color: '#cecece', font: '#FFFFFF'})
+    #
+    # @param  [String] message Message to display
+    # @param  [Hash] options A customizable set of options.
+    # @option options [DateTime] :starts_at(optional) Starting time (defaults to current time)
+    # @option options [DateTime] :ends_at(optional) Ending time (defaults to one hour from current time)
+    # @option options [String] :color(optional) Background color hex code
+    # @option options [String] :font(optional) Foreground color hex code
+    # @return [Gitlab::ObjectifiedHash] Information about created broadcast message.
+    def create_broadcast_message(message, options = {})
+      body = { message: message }.merge(options)
+      post('/broadcast_messages', body: body)
+    end
+
+    # Update a broadcast message
+    #
+    # @example
+    #   Gitlab.edit_broadcast_message(6, { message: 'No Mayday' })
+    #   Gitlab.edit_broadcast_message(6, { font: '#FEFEFE' })
+    #
+    # @param  [Integer] id The ID of a broadcast message
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :message(optional) Message to display
+    # @option options [DateTime] :starts_at(optional) Starting time (defaults to current time)
+    # @option options [DateTime] :ends_at(optional) Ending time (defaults to one hour from current time)
+    # @option options [String] :color(optional) Background color hex code
+    # @option options [String] :font(optional) Foreground color hex code
+    # @return [Gitlab::ObjectifiedHash] Information about updated broadcast message.
+    def edit_broadcast_message(id, options = {})
+      put("/broadcast_messages/#{id}", body: options)
+    end
+
+    # Delete a broadcast message.
+    #
+    # @example
+    #   Gitlab.delete_broadcast_message(3)
+    #
+    # @param  [Integer] id The ID of a broadcast message.
+    # @return [nil] This API call returns an empty response body.
+    def delete_broadcast_message(id)
+      delete("/broadcast_messages/#{id}")
+    end
+  end
+end

data/lib/gitlab/client/build_variables.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to builds.
+  # @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
+    #
+    # @example
+    #   Gitlab.variables(5)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>] The list of variables.
+    def variables(project)
+      get("/projects/#{url_encode project}/variables")
+    end
+
+    # Gets details of a project's specific build variable.
+    #
+    # @example
+    #   Gitlab.variable(5, "TEST_VARIABLE_1")
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] key The key of a variable.
+    # @return [Gitlab::ObjectifiedHash] The variable.
+    def variable(project, key)
+      get("/projects/#{url_encode project}/variables/#{key}")
+    end
+
+    # Create a build variable for a project.
+    #
+    # @example
+    #   Gitlab.create_variable(5, "NEW_VARIABLE", "new value")
+    #
+    # @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, **opts)
+      post("/projects/#{url_encode project}/variables", body: opts.merge(key: key, value: value))
+    end
+
+    # Update a project's build variable.
+    #
+    # @example
+    #   Gitlab.update_variable(5, "NEW_VARIABLE", "updated value")
+    #
+    # @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, **opts)
+      put("/projects/#{url_encode project}/variables/#{key}", body: opts.merge(value: value))
+    end
+
+    # Remove a project's build variable.
+    #
+    # @example
+    #   Gitlab.remove_variable(5, "VARIABLE_1")
+    #
+    # @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, **opts)
+      delete("/projects/#{url_encode project}/variables/#{key}", query: opts)
+    end
+
+    # Gets a list of the group's build variables
+    #
+    # @example
+    #   Gitlab.group_variables(5)
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @return [Array<Gitlab::ObjectifiedHash>] The list of variables.
+    def group_variables(group)
+      get("/groups/#{url_encode group}/variables")
+    end
+
+    # Gets details of a group's specific build variable.
+    #
+    # @example
+    #   Gitlab.group_variable(5, "TEST_VARIABLE_1")
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] key The key of a variable.
+    # @return [Gitlab::ObjectifiedHash] The variable.
+    def group_variable(group, key)
+      get("/groups/#{url_encode group}/variables/#{key}")
+    end
+
+    # Create a build variable for a group.
+    #
+    # @example
+    #   Gitlab.create_group_variable(5, "NEW_VARIABLE", "new value")
+    #
+    # @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, **opts)
+      post("/groups/#{url_encode group}/variables", body: opts.merge(key: key, value: value))
+    end
+
+    # Update a group's build variable.
+    #
+    # @example
+    #   Gitlab.update_group_variable(5, "NEW_VARIABLE", "updated value")
+    #
+    # @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, **opts)
+      put("/groups/#{url_encode group}/variables/#{key}", body: opts.merge(value: value))
+    end
+
+    # Remove a group's build variable.
+    #
+    # @example
+    #   Gitlab.remove_group_variable(5, "VARIABLE_1")
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [String] key The key of a variable.
+    # @return [Gitlab::ObjectifiedHash] The variable.
+    def remove_group_variable(group, key)
+      delete("/groups/#{url_encode group}/variables/#{key}")
+    end
+  end
+end