gitlab 4.2.0 → 4.18.0

data/lib/gitlab/client/build_variables.rb

@@ -1,6 +1,9 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to builds.
-  # @see https://docs.gitlab.com/ce/api/build_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
     #
@@ -16,7 +19,7 @@ class Gitlab::Client
     # Gets details of a project's specific build variable.
     #
     # @example
-    #   Gitlab.build(5, "TEST_VARIABLE_1")
+    #   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.
@@ -33,22 +36,24 @@ 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.
     #
     # @example
-    #   Gitlab.create_variable(5, "NEW_VARIABLE", "updated value")
+    #   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)
-      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.
@@ -58,9 +63,73 @@ 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, **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_variable(project, key)
-      delete("/projects/#{url_encode project}/variables/#{key}")
+    def remove_group_variable(group, key)
+      delete("/groups/#{url_encode group}/variables/#{key}")
     end
   end
 end

data/lib/gitlab/client/builds.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to builds.
   # @see https://docs.gitlab.com/ce/api/builds.html
@@ -14,7 +16,7 @@ class Gitlab::Client
     # @option options [Integer] :per_page The number of results per page.
     # @param  [Integer, String] project The ID or name of a project.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def builds(project, options={})
+    def builds(project, options = {})
       get("/projects/#{url_encode project}/builds", query: options)
     end
 
@@ -40,15 +42,15 @@ class Gitlab::Client
     # @return [Gitlab::FileResponse]
     def build_artifacts(project, id)
       get("/projects/#{url_encode project}/builds/#{id}/artifacts",
-           format: nil,
-           headers: { Accept: 'application/octet-stream' },
-           parser: proc { |body, _|
-            if body.encoding == Encoding::ASCII_8BIT # binary response
-              ::Gitlab::FileResponse.new StringIO.new(body, 'rb+')
-            else # error with json response
-              ::Gitlab::Request.parse(body)
-            end
-          })
+          format: nil,
+          headers: { Accept: 'application/octet-stream' },
+          parser: proc { |body, _|
+                    if body.encoding == Encoding::ASCII_8BIT # binary response
+                      ::Gitlab::FileResponse.new StringIO.new(body, 'rb+')
+                    else # error with json response
+                      ::Gitlab::Request.parse(body)
+                    end
+                  })
     end
 
     # Gets a list of builds for specific commit in a project.
@@ -63,7 +65,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>] The list of builds.
-    def commit_builds(project, sha, options={})
+    def commit_builds(project, sha, options = {})
       get("/projects/#{url_encode project}/repository/commits/#{sha}/builds", query: options)
     end
 

data/lib/gitlab/client/commits.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to repository commits.
   # @see https://docs.gitlab.com/ce/api/commits.html
@@ -6,18 +8,18 @@ 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>]
-    def commits(project, options={})
+    def commits(project, options = {})
       get("/projects/#{url_encode project}/repository/commits", query: options)
     end
-    alias_method :repo_commits, :commits
+    alias repo_commits commits
 
     # Gets a specific commit identified by the commit hash or name of a branch or tag.
     #
@@ -31,7 +33,57 @@ class Gitlab::Client
     def commit(project, sha)
       get("/projects/#{url_encode project}/repository/commits/#{sha}")
     end
-    alias_method :repo_commit, :commit
+    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
+    #   Gitlab.cherry_pick_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, 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 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.
     #
@@ -45,7 +97,7 @@ class Gitlab::Client
     def commit_diff(project, sha)
       get("/projects/#{url_encode project}/repository/commits/#{sha}/diff")
     end
-    alias_method :repo_commit_diff, :commit_diff
+    alias repo_commit_diff commit_diff
 
     # Gets a list of comments for a commit.
     #
@@ -57,10 +109,10 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def commit_comments(project, commit, options={})
+    def commit_comments(project, commit, options = {})
       get("/projects/#{url_encode project}/repository/commits/#{commit}/comments", query: options)
     end
-    alias_method :repo_commit_comments, :commit_comments
+    alias repo_commit_comments commit_comments
 
     # Creates a new comment for a commit.
     #
@@ -75,10 +127,10 @@ class Gitlab::Client
     # @option options [Integer] :line The line number.
     # @option options [String] :line_type The line type (new or old).
     # @return [Gitlab::ObjectifiedHash] Information about created comment.
-    def create_commit_comment(project, commit, note, options={})
+    def create_commit_comment(project, commit, note, options = {})
       post("/projects/#{url_encode project}/repository/commits/#{commit}/comments", body: options.merge(note: note))
     end
-    alias_method :repo_create_commit_comment, :create_commit_comment
+    alias repo_create_commit_comment create_commit_comment
 
     # Get the status of a commit
     #
@@ -94,10 +146,10 @@ class Gitlab::Client
     # @option options [String] :stage Filter by stage
     # @option options [String] :name Filter by status name, eg. jenkins
     # @option options [Boolean] :all The flag to return all statuses, not only latest ones
-    def commit_status(project, sha, options={})
+    def commit_status(project, sha, options = {})
       get("/projects/#{url_encode project}/repository/commits/#{sha}/statuses", query: options)
     end
-    alias_method :repo_commit_status, :commit_status
+    alias repo_commit_status commit_status
 
     # Adds or updates a status of a commit.
     #
@@ -113,10 +165,10 @@ class Gitlab::Client
     # @option options [String] :ref The ref (branch or tag) to which the status refers
     # @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))
+    def update_commit_status(project, sha, state, options = {})
+      post("/projects/#{url_encode project}/statuses/#{sha}", body: options.merge(state: state))
     end
-    alias_method :repo_update_commit_status, :update_commit_status
+    alias repo_update_commit_status update_commit_status
 
     # Creates a single commit with one or more changes
     #
@@ -134,13 +186,31 @@ class Gitlab::Client
     # @option options [String] :author_email the email address of the author
     # @option options [String] :author_name the name of the author
     # @return [Gitlab::ObjectifiedHash] hash of commit related data
-    def create_commit(project, branch, message, actions, options={})
+    def create_commit(project, branch, message, actions, options = {})
       payload = {
-          branch: branch,
-          commit_message: message,
-          actions: actions,
+        branch: branch,
+        commit_message: message,
+        actions: actions
       }.merge(options)
       post("/projects/#{url_encode project}/repository/commits", body: payload)
     end
+
+    # Gets a list of merge requests for a commit.
+    #
+    # @see https://docs.gitlab.com/ce/api/commits.html#list-merge-requests-associated-with-a-commit
+    # Introduced in Gitlab 10.7
+    #
+    # @example
+    #   Gitlab.commit_merge_requests(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [String] sha The commit hash.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def commit_merge_requests(project, commit, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{commit}/merge_requests", query: options)
+    end
+    alias repo_commit_merge_requests commit_merge_requests
   end
 end

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", body: options)
+    end
+  end
+end

data/lib/gitlab/client/deployments.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to deployments.
+  # @see https://docs.gitlab.com/ce/api/deployments.html
+  module Deployments
+    # Gets a list of project deployments.
+    #
+    # @example
+    #   Gitlab.deployments(5)
+    #   Gitlab.deployments(5, { per_page: 10, page:  2 })
+    #
+    # @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 deployments(project, options = {})
+      get("/projects/#{url_encode project}/deployments", query: options)
+    end
+
+    # Gets a single deployment.
+    #
+    # @example
+    #   Gitlab.deployment(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an deployment.
+    # @return [Gitlab::ObjectifiedHash]
+    def deployment(project, id)
+      get("/projects/#{url_encode project}/deployments/#{id}")
+    end
+  end
+end

data/lib/gitlab/client/environments.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to environments.
   # @see https://docs.gitlab.com/ce/api/environments.html
@@ -13,7 +15,7 @@ class Gitlab::Client
     # @option options [Integer] :page The page number.
     # @option options [Integer] :per_page The number of results per page.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def environments(project, options={})
+    def environments(project, options = {})
       get("/projects/#{url_encode project}/environments", query: options)
     end
 
@@ -40,7 +42,7 @@ class Gitlab::Client
     # @option options [String] :external_url Optional URL for viewing the deployed project in this environment
     # @return [Gitlab::ObjectifiedHash] The updated environment.
     def create_environment(project, env_name, options = {})
-      body = {name: env_name}.merge(options)
+      body = { name: env_name }.merge(options)
       post("/projects/#{url_encode project}/environments", body: body)
     end
 
@@ -56,7 +58,7 @@ class Gitlab::Client
     # @option options [String] env_name Name for the environment
     # @option options [String] external_url Optional URL for viewing the deployed project in this environment
     # @return [Gitlab::ObjectifiedHash] The updated environment.
-    def edit_environment(project, id, options={})
+    def edit_environment(project, id, options = {})
       put("/projects/#{url_encode project}/environments/#{id}", body: options)
     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/events.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to events.
+  # @see https://docs.gitlab.com/ce/api/events.html
+  module Events
+    # Gets a list of authenticated user's events
+    #
+    # @example
+    #   Gitlab.events()
+    #   Gitlab.events({ action: 'created', target_type: 'issue' })
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :action Only events of specific action type
+    # @option options [String] :target_type Only events of specific target type
+    # @option options [String] :before Only events created before YYYY-MM-DD
+    # @option options [String] :after Only events created after YYYY-MM-DD
+    # @option options [String] :sort Sort by created_at either 'asc' or 'desc'
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def events(options = {})
+      get('/events', query: options)
+    end
+
+    # Gets a list of user contribution events
+    #
+    # @example
+    #   Gitlab.user_events(1)
+    #   Gitlab.user_events(1, { action: created})
+    #
+    # @param  [Integer, String] user The ID or username of user
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :action Only events of specific action type
+    # @option options [String] :target_type Only events of specific target type
+    # @option options [String] :before Only events created before YYYY-MM-DD
+    # @option options [String] :after Only events created after YYYY-MM-DD
+    # @option options [String] :sort Sort by created_at either 'asc' or 'desc'
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def user_events(user, options = {})
+      get("/users/#{url_encode user}/events", query: options)
+    end
+
+    # Gets a list of visible project events
+    #
+    # @example
+    #   Gitlab.project_events(1)
+    #   Gitlab.project_events(1, { action: created })
+    #
+    # @param  [Integer] project The ID of project
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :action Only events of specific action type
+    # @option options [String] :target_type Only events of specific target type
+    # @option options [String] :before Only events created before YYYY-MM-DD
+    # @option options [String] :after Only events created after YYYY-MM-DD
+    # @option options [String] :sort Sort by created_at either 'asc' or 'desc'
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_events(project, options = {})
+      get("/projects/#{url_encode project}/events", query: options)
+    end
+  end
+end