gitlab 4.2.0 → 4.18.0

data/lib/gitlab/client/system_hooks.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to system hooks.
   # @see https://docs.gitlab.com/ce/api/system_hooks.html
@@ -12,10 +14,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 hooks(options={})
-      get("/hooks", query: options)
+    def hooks(options = {})
+      get('/hooks', query: options)
     end
-    alias_method :system_hooks, :hooks
+    alias system_hooks hooks
 
     # Adds a new system hook.
     #
@@ -29,9 +31,9 @@ class Gitlab::Client
     # @option options [boolean] :enable_ssl_verification `false` will cause Gitlab to ignore invalid/unsigned certificate errors (default is `true`)
     # @return [Gitlab::ObjectifiedHash]
     def add_hook(url, options = {})
-      post("/hooks", body: options.merge(url: url))
+      post('/hooks', body: options.merge(url: url))
     end
-    alias_method :add_system_hook, :add_hook
+    alias add_system_hook add_hook
 
     # Tests a system hook.
     #
@@ -44,7 +46,7 @@ class Gitlab::Client
     def hook(id)
       get("/hooks/#{id}")
     end
-    alias_method :system_hook, :hook
+    alias system_hook hook
 
     # Deletes a new system hook.
     #
@@ -57,6 +59,6 @@ class Gitlab::Client
     def delete_hook(id)
       delete("/hooks/#{id}")
     end
-    alias_method :delete_system_hook, :delete_hook
+    alias delete_system_hook delete_hook
   end
 end

data/lib/gitlab/client/tags.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to tags.
   # @see https://docs.gitlab.com/ce/api/tags.html
@@ -12,10 +14,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 tags(project, options={})
+    def tags(project, options = {})
       get("/projects/#{url_encode project}/repository/tags", query: options)
     end
-    alias_method :repo_tags, :tags
+    alias repo_tags tags
 
     # Creates a new project repository tag.
     #
@@ -29,10 +31,10 @@ class Gitlab::Client
     # @param  [String]  message Optional message for tag, creates annotated tag if specified.
     # @param  [String]  description Optional release notes for tag.
     # @return [Gitlab::ObjectifiedHash]
-    def create_tag(project, tag_name, ref, message='', description=nil)
-      post("/projects/#{url_encode project}/repository/tags", body: { tag_name: tag_name, ref: ref, message: message, description: description })
+    def create_tag(project, tag_name, ref, message = '', description = nil)
+      post("/projects/#{url_encode project}/repository/tags", body: { tag_name: tag_name, ref: ref, message: message, release_description: description })
     end
-    alias_method :repo_create_tag, :create_tag
+    alias repo_create_tag create_tag
 
     # Gets information about a repository tag.
     #
@@ -44,9 +46,9 @@ class Gitlab::Client
     # @param  [String] tag The name of the tag.
     # @return [Gitlab::ObjectifiedHash]
     def tag(project, tag)
-      get("/projects/#{url_encode project}/repository/tags/#{tag}")
+      get("/projects/#{url_encode project}/repository/tags/#{url_encode tag}")
     end
-    alias_method :repo_tag, :tag
+    alias repo_tag tag
 
     # Deletes a repository tag.  Requires Gitlab >= 6.8.x
     #
@@ -58,9 +60,9 @@ class Gitlab::Client
     # @param  [String] tag The name of the tag to delete
     # @return [Gitlab::ObjectifiedHash]
     def delete_tag(project, tag)
-      delete("/projects/#{url_encode project}/repository/tags/#{tag}")
+      delete("/projects/#{url_encode project}/repository/tags/#{url_encode tag}")
     end
-    alias_method :repo_delete_tag, :delete_tag
+    alias repo_delete_tag delete_tag
 
     # Adds release notes to an existing repository tag.  Requires Gitlab >= 8.2.0
     #
@@ -73,9 +75,9 @@ class Gitlab::Client
     # @param  [String] description Release notes with markdown support
     # @return [Gitlab::ObjectifiedHash]
     def create_release(project, tag, description)
-      post("/projects/#{url_encode project}/repository/tags/#{tag}/release", body: { description: description })
+      post("/projects/#{url_encode project}/repository/tags/#{url_encode tag}/release", body: { description: description })
     end
-    alias_method :repo_create_release, :create_release
+    alias repo_create_release create_release
 
     # Updates the release notes of a given release.  Requires Gitlab >= 8.2.0
     #
@@ -88,9 +90,8 @@ class Gitlab::Client
     # @param  [String] description Release notes with markdown support
     # @return [Gitlab::ObjectifiedHash]
     def update_release(project, tag, description)
-      put("/projects/#{url_encode project}/repository/tags/#{tag}/release", body: { description: description })
+      put("/projects/#{url_encode project}/repository/tags/#{url_encode tag}/release", body: { description: description })
     end
-    alias_method :repo_update_release, :update_release
-
+    alias repo_update_release update_release
   end
 end

data/lib/gitlab/client/templates.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to templates.
+  # @see https://docs.gitlab.com/ce/api/templates/dockerfiles.html
+  # @see https://docs.gitlab.com/ce/api/templates/gitignores.html
+  # @see https://docs.gitlab.com/ce/api/templates/gitlab_ci_ymls.html
+  # @see https://docs.gitlab.com/ce/api/templates/licenses.html
+  module Templates
+    # Get all Dockerfile templates.
+    #
+    # @example
+    #   Gitlab.dockerfile_templates
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def dockerfile_templates
+      get('/templates/dockerfiles')
+    end
+
+    # Get a single Dockerfile template.
+    #
+    # @example
+    #   Gitlab.dockerfile_template('Binary')
+    #
+    # @param  [String] key The key of the Dockerfile template
+    # @return [Gitlab::ObjectifiedHash]
+    def dockerfile_template(key)
+      get("/templates/dockerfiles/#{key}")
+    end
+
+    # Get all gitignore templates.
+    #
+    # @example
+    #   Gitlab.gitignore_templates
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def gitignore_templates
+      get('/templates/gitignores')
+    end
+
+    # Get a single gitignore template.
+    #
+    # @example
+    #   Gitlab.gitignore_template('Ruby')
+    #
+    # @param  [String] key The key of the gitignore template
+    # @return [Gitlab::ObjectifiedHash]
+    def gitignore_template(key)
+      get("/templates/gitignores/#{key}")
+    end
+
+    # Get all `gitlab_ci.yml` templates.
+    #
+    # @example
+    #   Gitlab.gitlab_ci_yml_templates
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def gitlab_ci_yml_templates
+      get('/templates/gitlab_ci_ymls')
+    end
+
+    # Get a single `gitlab_ci.yml` template.
+    #
+    # @example
+    #   Gitlab.gitlab_ci_yml_template('Ruby')
+    #
+    # @param  [String] key The key of the gitlab_ci_yml template
+    # @return [Gitlab::ObjectifiedHash]
+    def gitlab_ci_yml_template(key)
+      get("/templates/gitlab_ci_ymls/#{key}")
+    end
+
+    # Get all license templates.
+    #
+    # @example
+    #   Gitlab.license_templates
+    #   Gitlab.license_templates(popular: true)
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Boolean] popular(optional) If passed, returns only popular licenses.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def license_templates(options = {})
+      get('/templates/licenses', query: options)
+    end
+
+    # Get a single license template. You can pass parameters to replace the license placeholder.
+    #
+    # @example
+    #   Gitlab.license_template('Ruby')
+    #
+    # @param  [String] key The key of the license template
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] project(optional) The copyrighted project name.
+    # @option options [String] fullname(optional) The full-name of the copyright holder
+    # @return [Gitlab::ObjectifiedHash]
+    def license_template(key, options = {})
+      get("/templates/licenses/#{key}", query: options)
+    end
+  end
+end

data/lib/gitlab/client/todos.rb

@@ -1,6 +1,8 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to todos
-  # @see https://docs.gitlab.com/ce/api/todos.html 
+  # @see https://docs.gitlab.com/ce/api/todos.html
   module Todos
     # Gets a list of todos.
     #
@@ -16,8 +18,8 @@ class Gitlab::Client
     # @option options [Integer] :state The state of the todo. Can be either `pending` or `done`
     # @option options [Integer] :type The type of a todo. Can be either `Issue` or `MergeRequest`
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def todos(options={})
-      get("/todos", query: options)
+    def todos(options = {})
+      get('/todos', query: options)
     end
 
     # Marks a single pending todo for the current user as done.
@@ -38,7 +40,7 @@ class Gitlab::Client
     #
     # @return [void] This API call returns an empty response body.
     def mark_all_todos_as_done
-      post("/todos/mark_as_done")
+      post('/todos/mark_as_done')
     end
   end
-end
+end

data/lib/gitlab/client/user_snippets.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to user snippets.
+  # @see https://docs.gitlab.com/ce/api/snippets.html
+  module UserSnippets
+    # Get a list of the snippets of the current user.
+    #
+    # @example
+    #   Gitlab.user_snippets
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>] List of snippets of current user
+    def user_snippets
+      get('/snippets')
+    end
+
+    # Get a single snippet.
+    #
+    # @example
+    #   Gitlab.user_snippet(1)
+    #
+    # @param  [Integer] id ID of snippet to retrieve.
+    # @return [Gitlab::ObjectifiedHash] Information about the user snippet
+    def user_snippet(id)
+      get("/snippets/#{id}")
+    end
+
+    # Get raw contents of a single snippet.
+    #
+    # @example
+    #   Gitlab.user_snippet_raw(1)
+    #
+    # @param  [Integer] id ID of snippet to retrieve.
+    # @return [String] User snippet text
+    def user_snippet_raw(id)
+      get("/snippets/#{id}/raw",
+          format: nil,
+          headers: { Accept: 'text/plain' },
+          parser: ::Gitlab::Request::Parser)
+    end
+
+    # Create a new snippet.
+    #
+    # @example
+    #   Gitlab.create_user_snippet({ title: 'REST', file_name: 'api.rb', content: 'some code', description: 'Hello World snippet', visibility: 'public'})
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :title (required) Title of a snippet.
+    # @option options [String] :file_name (required) Name of a snippet file.
+    # @option options [String] :content (required) Content of a snippet.
+    # @option options [String] :description (optional) Description of a snippet.
+    # @option options [String] :visibility (optional) visibility of a snippet.
+    # @return [Gitlab::ObjectifiedHash] Information about created snippet.
+    def create_user_snippet(options = {})
+      post('/snippets', body: options)
+    end
+
+    # Update an existing snippet.
+    #
+    # @example
+    #   Gitlab.edit_user_snippet(34, { file_name: 'README.txt' })
+    #   Gitlab.edit_user_snippet(34, { file_name: 'README.txt', title: 'New title' })
+    #
+    # @param  [Integer] id ID of snippet to update.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :title (optional) Title of a snippet.
+    # @option options [String] :file_name (optional) Name of a snippet file.
+    # @option options [String] :content (optional) Content of a snippet.
+    # @option options [String] :description (optional) Description of a snippet.
+    # @option options [String] :visibility (optional) visibility of a snippet.
+    # @return [Gitlab::ObjectifiedHash] Information about updated snippet.
+    def edit_user_snippet(id, options = {})
+      put("/snippets/#{id}", body: options)
+    end
+
+    # Delete an existing snippet.
+    #
+    # @example
+    #   Gitlab.delete_user_snippet(14)
+    #
+    # @param  [Integer] id ID of snippet to delete.
+    # @return [void] This API call returns an empty response body.
+    def delete_user_snippet(id)
+      delete("/snippets/#{id}")
+    end
+
+    # List all public snippets.
+    #
+    # @example
+    #   Gitlab.public_snippets
+    #   Gitlab.public_snippets(per_page: 2, page: 1)
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :per_page (optional) Number of snippets to return per page.
+    # @option options [String] :page (optional) Page to retrieve.
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>] List of all public snippets
+    def public_snippets(options = {})
+      get('/snippets/public', query: options)
+    end
+
+    # Get user agent details for a snippet.
+    #
+    # @example
+    #   Gitlab.snippet_user_agent_details(1)
+    #
+    # @param  [Integer] id ID of snippet to delete.
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>] Details of the user agent
+    def snippet_user_agent_details(id)
+      get("/snippets/#{id}/user_agent_detail")
+    end
+  end
+end

data/lib/gitlab/client/users.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 class Gitlab::Client
   # Defines methods related to users.
   # @see https://docs.gitlab.com/ce/api/users.html
@@ -12,8 +14,8 @@ 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 users(options={})
-      get("/users", query: options)
+    def users(options = {})
+      get('/users', query: options)
     end
 
     # Gets information about a user.
@@ -25,8 +27,8 @@ class Gitlab::Client
     #
     # @param  [Integer] id The ID of a user.
     # @return [Gitlab::ObjectifiedHash]
-    def user(id=nil)
-      id.to_i.zero? ? get("/user") : get("/users/#{id}")
+    def user(id = nil)
+      id.to_i.zero? ? get('/user') : get("/users/#{id}")
     end
 
     # Creates a new user.
@@ -35,11 +37,11 @@ class Gitlab::Client
     # @example
     #   Gitlab.create_user('joe@foo.org', 'secret', 'joe', { name: 'Joe Smith' })
     #   or
-    #   Gitlab.create_user('joe@foo.org', 'secret')
+    #   Gitlab.create_user('joe@foo.org', 'secret', 'joe')
     #
-    # @param  [String] email The email of a user.
-    # @param  [String] password The password of a user.
-    # @param  [String] username The username of a user.
+    # @param  [String] email(required) The email of a user.
+    # @param  [String] password(required) The password of a user.
+    # @param  [String] username(required) The username of a user.
     # @param  [Hash] options A customizable set of options.
     # @option options [String] :name The name of a user. Defaults to email.
     # @option options [String] :skype The skype of a user.
@@ -48,12 +50,10 @@ class Gitlab::Client
     # @option options [Integer] :projects_limit The limit of projects for a user.
     # @return [Gitlab::ObjectifiedHash] Information about created user.
     def create_user(*args)
-      options = Hash === args.last ? args.pop : {}
-      if args[2]
-        body = { email: args[0], password: args[1], username: args[2] }
-      else
-        body = { email: args[0], password: args[1], name: args[0] }
-      end
+      options = args.last.is_a?(Hash) ? args.pop : {}
+      raise ArgumentError, 'Missing required parameters' unless args[2]
+
+      body = { email: args[0], password: args[1], username: args[2], name: args[0] }
       body.merge!(options)
       post('/users', body: body)
     end
@@ -73,7 +73,7 @@ class Gitlab::Client
     # @option options [String] :twitter The twitter of a user.
     # @option options [Integer] :projects_limit The limit of projects for a user.
     # @return [Gitlab::ObjectifiedHash] Information about created user.
-    def edit_user(user_id, options={})
+    def edit_user(user_id, options = {})
       put("/users/#{user_id}", body: options)
     end
 
@@ -120,7 +120,21 @@ class Gitlab::Client
     # @return [Gitlab::ObjectifiedHash]
     # @note This method doesn't require private_token to be set.
     def session(email, password)
-      post("/session", body: { email: email, password: password }, unauthenticated: true)
+      post('/session', body: { email: email, password: password }, unauthenticated: true)
+    end
+
+    # Gets a list of user activities (for admin access only).
+    #
+    # @example
+    #   Gitlab.activities
+    #
+    # @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.
+    # @option options [String] :from The start date for paginated results.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def activities(options = {})
+      get('/user/activities', query: options)
     end
 
     # Gets a list of user's SSH keys.
@@ -134,10 +148,10 @@ class Gitlab::Client
     # @option options [Integer] :per_page The number of results per page.
     # @option options [Integer] :user_id The ID of the user to retrieve the keys for.
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def ssh_keys(options={})
+    def ssh_keys(options = {})
       user_id = options.delete :user_id
       if user_id.to_i.zero?
-        get("/user/keys", query: options)
+        get('/user/keys', query: options)
       else
         get("/users/#{user_id}/keys", query: options)
       end
@@ -161,9 +175,16 @@ class Gitlab::Client
     #
     # @param  [String] title The title of an SSH key.
     # @param  [String] key The SSH key body.
+    # @param  [Hash] options A customizable set of options.
+    # @option options  [Integer] :user_id id of the user to associate the key with
     # @return [Gitlab::ObjectifiedHash] Information about created SSH key.
-    def create_ssh_key(title, key)
-      post("/user/keys", body: { title: title, key: key })
+    def create_ssh_key(title, key, options = {})
+      user_id = options.delete :user_id
+      if user_id.to_i.zero?
+        post('/user/keys', body: { title: title, key: key })
+      else
+        post("/users/#{user_id}/keys", body: { title: title, key: key })
+      end
     end
 
     # Deletes an SSH key.
@@ -172,9 +193,16 @@ class Gitlab::Client
     #   Gitlab.delete_ssh_key(1)
     #
     # @param  [Integer] id The ID of a user's SSH key.
+    # @param  [Hash] options A customizable set of options.
+    # @option options  [Integer] :user_id id of the user to associate the key with
     # @return [Gitlab::ObjectifiedHash] Information about deleted SSH key.
-    def delete_ssh_key(id)
-      delete("/user/keys/#{id}")
+    def delete_ssh_key(id, options = {})
+      user_id = options.delete :user_id
+      if user_id.to_i.zero?
+        delete("/user/keys/#{id}")
+      else
+        delete("/users/#{user_id}/keys/#{id}")
+      end
     end
 
     # Gets user emails.
@@ -186,8 +214,8 @@ class Gitlab::Client
     #
     # @param  [Integer] user_id The ID of a user.
     # @return [Gitlab::ObjectifiedHash]
-    def emails(user_id=nil)
-      url = user_id.to_i.zero? ? "/user/emails" : "/users/#{user_id}/emails"
+    def emails(user_id = nil)
+      url = user_id.to_i.zero? ? '/user/emails' : "/users/#{user_id}/emails"
       get(url)
     end
 
@@ -211,10 +239,15 @@ class Gitlab::Client
     #
     # @param  [String] email Email address
     # @param  [Integer] user_id The ID of a user.
+    # @param  [Boolean] skip_confirmation     Skip confirmation and assume e-mail is verified
     # @return [Gitlab::ObjectifiedHash]
-    def add_email(email, user_id=nil)
-      url = user_id.to_i.zero? ? "/user/emails" : "/users/#{user_id}/emails"
-      post(url, body: {email: email})
+    def add_email(email, user_id = nil, skip_confirmation = nil)
+      url = user_id.to_i.zero? ? '/user/emails' : "/users/#{user_id}/emails"
+      if skip_confirmation.nil?
+        post(url, body: { email: email })
+      else
+        post(url, body: { email: email, skip_confirmation: skip_confirmation })
+      end
     end
 
     # Delete email
@@ -227,7 +260,7 @@ class Gitlab::Client
     # @param  [Integer] id Email address ID
     # @param  [Integer] user_id The ID of a user.
     # @return [Boolean]
-    def delete_email(id, user_id=nil)
+    def delete_email(id, user_id = nil)
       url = user_id.to_i.zero? ? "/user/emails/#{id}" : "/users/#{user_id}/emails/#{id}"
       delete(url)
     end
@@ -242,9 +275,112 @@ class Gitlab::Client
     # @option options [String] :per_page Number of user to return per page
     # @option options [String] :page The page to retrieve
     # @return [Array<Gitlab::ObjectifiedHash>]
-    def user_search(search, options={})
+    def user_search(search, options = {})
       options[:search] = search
-      get("/users", query: options)
+      get('/users', query: options)
+    end
+
+    # Gets user custom_attributes.
+    #
+    # @example
+    #   Gitlab.user_custom_attributes(2)
+    #
+    # @param  [Integer] user_id The ID of a user.
+    # @return [Gitlab::ObjectifiedHash]
+    def user_custom_attributes(user_id)
+      get("/users/#{user_id}/custom_attributes")
+    end
+
+    # Gets single user custom_attribute.
+    #
+    # @example
+    #   Gitlab.user_custom_attribute(key, 2)
+    #
+    # @param  [String] key The custom_attributes key
+    # @param  [Integer] user_id The ID of a user.
+    # @return [Gitlab::ObjectifiedHash]
+    def user_custom_attribute(key, user_id)
+      get("/users/#{user_id}/custom_attributes/#{key}")
+    end
+
+    # Creates a new custom_attribute
+    #
+    # @example
+    #   Gitlab.add_custom_attribute('some_new_key', 'some_new_value', 2)
+    #
+    # @param  [String] key The custom_attributes key
+    # @param  [String] value The custom_attributes value
+    # @param  [Integer] user_id The ID of a user.
+    # @return [Gitlab::ObjectifiedHash]
+    def add_user_custom_attribute(key, value, user_id)
+      url = "/users/#{user_id}/custom_attributes/#{key}"
+      put(url, body: { value: value })
+    end
+
+    # Delete custom_attribute
+    # Will delete a custom_attribute
+    #
+    # @example
+    #   Gitlab.delete_user_custom_attribute('somekey', 2)
+    #
+    # @param  [String] key The custom_attribute key to delete
+    # @param  [Integer] user_id The ID of a user.
+    # @return [Boolean]
+    def delete_user_custom_attribute(key, user_id)
+      delete("/users/#{user_id}/custom_attributes/#{key}")
+    end
+
+    # Get all impersonation tokens for a user
+    #
+    # @example
+    #   Gitlab.user_impersonation_tokens(1)
+    #
+    # @param  [Integer] user_id The ID of the user.
+    # @param  [String] state Filter impersonation tokens by state {}
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def user_impersonation_tokens(user_id)
+      get("/users/#{user_id}/impersonation_tokens")
+    end
+
+    # Get impersonation token information
+    #
+    # @example
+    #   Gitlab.user_impersonation_token(1, 1)
+    #
+    # @param  [Integer] user_id The ID of the user.
+    # @param  [Integer] impersonation_token_id ID of the impersonation token.
+    # @return [Gitlab::ObjectifiedHash]
+    def user_impersonation_token(user_id, impersonation_token_id)
+      get("/users/#{user_id}/impersonation_tokens/#{impersonation_token_id}")
+    end
+
+    # Create impersonation token
+    #
+    # @example
+    #   Gitlab.create_user_impersonation_token(2, "token", ["api", "read_user"])
+    #   Gitlab.create_user_impersonation_token(2, "token", ["api", "read_user"], "1970-01-01")
+    #
+    # @param  [Integer] user_id The ID of the user.
+    # @param  [String] name Name for impersonation token.
+    # @param  [Array<String>] scopes Array of scopes for the impersonation token
+    # @param  [String] expires_at Date for impersonation token expiration in ISO format.
+    # @return [Gitlab::ObjectifiedHash]
+    def create_user_impersonation_token(user_id, name, scopes, expires_at = nil)
+      body = { name: name, scopes: scopes }
+      body[:expires_at] = expires_at if expires_at
+      post("/users/#{user_id}/impersonation_tokens", body: body)
+    end
+
+    # Revoke an impersonation token
+    #
+    # @example
+    #   Gitlab.revoke_user_impersonation_token(1, 1)
+    #
+    # @param  [Integer] user_id The ID of the user.
+    # @param  [Integer] impersonation_token_id ID of the impersonation token.
+    # @return [Gitlab::ObjectifiedHash]
+    def revoke_user_impersonation_token(user_id, impersonation_token_id)
+      delete("/users/#{user_id}/impersonation_tokens/#{impersonation_token_id}")
     end
   end
 end

data/lib/gitlab/client/versions.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to version
+  # @see https://docs.gitlab.com/ce/api/version.html
+  module Versions
+    # Returns server version.
+    # @see https://docs.gitlab.com/ce/api/version.html
+    #
+    # @example
+    #   Gitlab.version
+    #
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def version
+      get('/version')
+    end
+  end
+end