fs-gitlab 4.18.1

data/lib/gitlab/client/runners.rb

@@ -0,0 +1,211 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to runners.
+  # @see https://docs.gitlab.com/ce/api/runners.html
+  module Runners
+    # Get a list of specific runners available to the user.
+    # @see https://docs.gitlab.com/ce/api/runners.html#list-owned-runners
+    #
+    # @example
+    #   Gitlab.runners
+    #   Gitlab.runners(type: 'instance_type', status: 'active')
+    #   Gitlab.runners(tag_list: 'tag1,tag2')
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :type(optional) The type of runners to show, one of: instance_type, group_type, project_type
+    # @option options [String] :status(optional) The status of runners to show, one of: active, paused, online, offline
+    # @option options [String] :tag_list(optional) List of the runners tags (separated by comma)
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def runners(options = {})
+      get('/runners', query: options)
+    end
+
+    # Get a list of all runners in the GitLab instance (specific and shared). Access is restricted to users with admin privileges.
+    # @see https://docs.gitlab.com/ce/api/runners.html#list-all-runners
+    #
+    # @example
+    #   Gitlab.all_runners
+    #   Gitlab.all_runners(type: 'instance_type', status: 'active')
+    #   Gitlab.all_runners(tag_list: 'tag1,tag2')
+    #
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :type(optional) The type of runners to show, one of: instance_type, group_type, project_type
+    # @option options [String] :status(optional) The status of runners to show, one of: active, paused, online, offline
+    # @option options [String] :tag_list(optional) List of the runners tags (separated by comma)
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def all_runners(options = {})
+      get('/runners/all', query: options)
+    end
+
+    # Get details of a runner..
+    # @see https://docs.gitlab.com/ce/api/runners.html#get-runners-details
+    #
+    # @example
+    #   Gitlab.runner(42)
+    #
+    # @param  [Integer, String] id The ID of a runner
+    # @return <Gitlab::ObjectifiedHash>
+    def runner(id)
+      get("/runners/#{id}")
+    end
+
+    # Update details of a runner.
+    # @see https://docs.gitlab.com/ce/api/runners.html#update-runners-details
+    #
+    # @example
+    #   Gitlab.update_runner(42, { description: 'Awesome runner' })
+    #   Gitlab.update_runner(42, { active: false })
+    #
+    # @param  [Integer, String] id The ID of a runner
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description(optional) The description of a runner
+    # @option options [Boolean] :active(optional) The state of a runner; can be set to true or false
+    # @option options [String] :tag_list(optional) The list of tags for a runner; put array of tags, that should be finally assigned to a runner(separated by comma)
+    # @option options [Boolean] :run_untagged(optional) Flag indicating the runner can execute untagged jobs
+    # @option options [Boolean] :locked(optional) Flag indicating the runner is locked
+    # @option options [String] :access_level(optional) The access_level of the runner; not_protected or ref_protected
+    # @option options [Integer] :maximum_timeout(optional) Maximum timeout set when this runner will handle the job
+    # @return <Gitlab::ObjectifiedHash>
+    def update_runner(id, options = {})
+      put("/runners/#{id}", body: options)
+    end
+
+    # Remove a runner.
+    # @see https://docs.gitlab.com/ce/api/runners.html#remove-a-runner
+    #
+    # @example
+    #   Gitlab.delete_runner(42)
+    #
+    # @param  [Integer, String] id The ID of a runner
+    # @return [nil] This API call returns an empty response body.
+    def delete_runner(id)
+      delete("/runners/#{id}")
+    end
+
+    # List jobs that are being processed or were processed by specified runner.
+    #
+    # @example
+    #   Gitlab.runner_jobs(1)
+    #   Gitlab.runner_jobs(1, status: 'success')
+    #   Gitlab.runner_jobs(1, sort: 'desc')
+    #
+    # @param  [Integer] id The ID of a runner.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :status(optional) Status of the job; one of: running, success, failed, canceled
+    # @option options [String] :order_by(optional) Order jobs by id.
+    # @option options [String] :sort(optional) Sort jobs in asc or desc order (default: desc)
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def runner_jobs(runner_id, options = {})
+      get("/runners/#{url_encode runner_id}/jobs", query: options)
+    end
+
+    # List all runners (specific and shared) available in the project. Shared runners are listed if at least one shared runner is defined and shared runners usage is enabled in the project's settings.
+    # @see https://docs.gitlab.com/ce/api/runners.html#list-projects-runners
+    #
+    # @example
+    #   Gitlab.project_runners(42)
+    #   Gitlab.project_runners(42, type: 'instance_type', status: 'active')
+    #   Gitlab.project_runners(42, tag_list: 'tag1,tag2')
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :type(optional) The type of runners to show, one of: instance_type, group_type, project_type
+    # @option options [String] :status(optional) The status of runners to show, one of: active, paused, online, offline
+    # @option options [String] :tag_list(optional) List of the runners tags (separated by comma)
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_runners(project_id, options = {})
+      get("/projects/#{url_encode project_id}/runners", query: options)
+    end
+
+    # Enable an available specific runner in the project.
+    # @see https://docs.gitlab.com/ce/api/runners.html#enable-a-runner-in-project
+    #
+    # @example
+    #   Gitlab.project_enable_runner(2, 42)
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @param  [Integer, String] id The ID of a runner.
+    # @return <Gitlab::ObjectifiedHash>
+    def project_enable_runner(project_id, id)
+      body = { runner_id: id }
+      post("/projects/#{url_encode project_id}/runners", body: body)
+    end
+
+    # Disable a specific runner from the project. It works only if the project isn't the only project associated with the specified runner.
+    # @see https://docs.gitlab.com/ce/api/runners.html#disable-a-runner-from-project
+    #
+    # @example
+    #   Gitlab.project_disable_runner(2, 42)
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @param  [Integer, String] runner_id The ID of a runner.
+    # @return <Gitlab::ObjectifiedHash>
+    def project_disable_runner(id, runner_id)
+      delete("/projects/#{url_encode id}/runners/#{runner_id}")
+    end
+
+    # List all runners (specific and shared) available in the group as well its ancestor groups. Shared runners are listed if at least one shared runner is defined.
+    # @see https://docs.gitlab.com/ee/api/runners.html#list-groups-runners
+    #
+    # @example
+    #   Gitlab.group_runners(9)
+    #   Gitlab.group_runners(9, type: 'instance_type', status: 'active')
+    #   Gitlab.group_runners(9, tag_list: 'tag1,tag2')
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :type(optional) The type of runners to show, one of: instance_type, group_type, project_type
+    # @option options [String] :status(optional) The status of runners to show, one of: active, paused, online, offline
+    # @option options [String] :tag_list(optional) List of the runners tags (separated by comma)
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def group_runners(group, options = {})
+      get("/groups/#{url_encode group}/runners", query: options)
+    end
+
+    # Register a new Runner for the instance.
+    #
+    # @example
+    #   Gitlab.register_runner('9142c16ea169eaaea3d752313a434a6e')
+    #   Gitlab.register_runner('9142c16ea169eaaea3d752313a434a6e', description: 'Some Description', active: true, locked: false)
+    #
+    # @param  [String] token(required) Registration token.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description(optional) Runner description.
+    # @option options [Hash] :info(optional) Runner metadata.
+    # @option options [Boolean] :active(optional) Whether the Runner is active.
+    # @option options [Boolean] :locked(optional) Whether the Runner should be locked for current project.
+    # @option options [Boolean] :run_untagged(optional) Whether the Runner should handle untagged jobs.
+    # @option options [Array<String>] :tag_list(optional) List of Runner tags.
+    # @option options [Integer] :maximum_timeout(optional) Maximum timeout set when this Runner will handle the job.
+    # @return <Gitlab::ObjectifiedHash> Response against runner registration
+    def register_runner(token, options = {})
+      body = { token: token }.merge(options)
+      post('/runners', body: body)
+    end
+
+    # Deletes a registed Runner.
+    #
+    # @example
+    #   Gitlab.delete_registered_runner('9142c16ea169eaaea3d752313a434a6e')
+    #
+    # @param  [String] token Runner authentication token.
+    # @return [nil] This API call returns an empty response body.
+    def delete_registered_runner(token)
+      body = { token: token }
+      delete('/runners', body: body)
+    end
+
+    # Validates authentication credentials for a registered Runner.
+    #
+    # @example
+    #   Gitlab.verify_auth_registered_runner('9142c16ea169eaaea3d752313a434a6e')
+    #
+    # @param  [String] token Runner authentication token.
+    # @return [nil] This API call returns an empty response body.
+    def verify_auth_registered_runner(token)
+      body = { token: token }
+      post('/runners/verify', body: body)
+    end
+  end
+end

data/lib/gitlab/client/search.rb

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

data/lib/gitlab/client/services.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Third party services connected to a project.
+  # @see https://docs.gitlab.com/ce/api/services.html
+  module Services
+    # Create/Edit service
+    # Full service params documentation: https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/services.md
+    #
+    # @example
+    #   Gitlab.change_service(42, :redmine, { new_issue_url: 'https://example.com/projects/test_project/issues/new',
+    #                                         project_url: 'https://example.com/projects/test_project/issues',
+    #                                         issues_url: 'https://example.com/issues/:id' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] service A service code name.
+    # @param  [Hash] params A service parameters.
+    # @return [Boolean]
+    def change_service(project, service, params)
+      put("/projects/#{url_encode project}/services/#{correct_service_name(service)}", body: params)
+    end
+
+    # Delete service
+    #
+    # @example
+    #   Gitlab.delete_service(42, :redmine)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] service A service code name.
+    # @return [Boolean]
+    def delete_service(project, service)
+      delete("/projects/#{url_encode project}/services/#{correct_service_name(service)}")
+    end
+
+    # Get service
+    #
+    # @example
+    #   Gitlab.service(42, :redmine)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] service A service code name.
+    # @return [Gitlab::ObjectifiedHash]
+    def service(project, service)
+      get("/projects/#{url_encode project}/services/#{correct_service_name(service)}")
+    end
+
+    private
+
+    def correct_service_name(service)
+      service.to_s.tr('_', '-')
+    end
+  end
+end

data/lib/gitlab/client/sidekiq.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to sidekiq metrics.
+  # @see https://docs.gitlab.com/ce/api/sidekiq_metrics.html
+  module Sidekiq
+    # Get the current Queue Metrics
+    #
+    # @example
+    #   Gitlab.sidekiq_queue_metrics
+    def sidekiq_queue_metrics
+      get('/sidekiq/queue_metrics')
+    end
+
+    # Get the current Process Metrics
+    #
+    # @example
+    #   Gitlab.sidekiq_process_metrics
+    def sidekiq_process_metrics
+      get('/sidekiq/process_metrics')
+    end
+
+    # Get the current Job Statistics
+    #
+    # @example
+    #   Gitlab.sidekiq_job_stats
+    def sidekiq_job_stats
+      get('/sidekiq/job_stats')
+    end
+
+    # Get a compound response of all the previously mentioned metrics
+    #
+    # @example
+    #   Gitlab.sidekiq_compound_metrics
+    def sidekiq_compound_metrics
+      get('/sidekiq/compound_metrics')
+    end
+  end
+end

data/lib/gitlab/client/snippets.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to snippets.
+  # @see https://docs.gitlab.com/ce/api/project_snippets.html
+  module Snippets
+    # Gets a list of project's snippets.
+    #
+    # @example
+    #   Gitlab.snippets(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 [Gitlab::ObjectifiedHash]
+    def snippets(project, options = {})
+      get("/projects/#{url_encode project}/snippets", query: options)
+    end
+
+    # Gets information about a snippet.
+    #
+    # @example
+    #   Gitlab.snippet(2, 14)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a snippet.
+    # @return [Gitlab::ObjectifiedHash]
+    def snippet(project, id)
+      get("/projects/#{url_encode project}/snippets/#{id}")
+    end
+
+    # Creates a new snippet.
+    #
+    # @example
+    #   Gitlab.create_snippet(42, { title: 'REST', file_name: 'api.rb', code: 'some code', visibility: 'public'})
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :title (required) The title of a snippet.
+    # @option options [String] :file_name (required) The name of a snippet file.
+    # @option options [String] :code (required) The content of a snippet.
+    # @option options [String] :lifetime (optional) The expiration date of a snippet.
+    # @option options [String] :visibility (required) The visibility of a snippet
+    # @return [Gitlab::ObjectifiedHash] Information about created snippet.
+    def create_snippet(project, options = {})
+      post("/projects/#{url_encode project}/snippets", body: options)
+    end
+
+    # Updates a snippet.
+    #
+    # @example
+    #   Gitlab.edit_snippet(42, 34, { file_name: 'README.txt' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a snippet.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :title The title of a snippet.
+    # @option options [String] :file_name The name of a snippet file.
+    # @option options [String] :code The content of a snippet.
+    # @option options [String] :lifetime The expiration date of a snippet.
+    # @option options [String] :visibility (optional) The visibility of a snippet
+    # @return [Gitlab::ObjectifiedHash] Information about updated snippet.
+    def edit_snippet(project, id, options = {})
+      put("/projects/#{url_encode project}/snippets/#{id}", body: options)
+    end
+
+    # Deletes a snippet.
+    #
+    # @example
+    #   Gitlab.delete_snippet(2, 14)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a snippet.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted snippet.
+    def delete_snippet(project, id)
+      delete("/projects/#{url_encode project}/snippets/#{id}")
+    end
+
+    # Returns raw project snippet content as plain text.
+    #
+    # @example
+    #   Gitlab.snippet_content(2, 14)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a snippet.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted snippet.
+    def snippet_content(project, id)
+      get("/projects/#{url_encode project}/snippets/#{id}/raw",
+          format: nil,
+          headers: { Accept: 'text/plain' },
+          parser: ::Gitlab::Request::Parser)
+    end
+  end
+end

data/lib/gitlab/client/system_hooks.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to system hooks.
+  # @see https://docs.gitlab.com/ce/api/system_hooks.html
+  module SystemHooks
+    # Gets a list of system hooks.
+    #
+    # @example
+    #   Gitlab.hooks
+    #   Gitlab.system_hooks
+    #
+    # @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 hooks(options = {})
+      get('/hooks', query: options)
+    end
+    alias system_hooks hooks
+
+    # Adds a new system hook.
+    #
+    # @example
+    #   Gitlab.add_hook('http://example.com/hook')
+    #   Gitlab.add_system_hook('https://api.example.net/v1/hook')
+    #
+    # @param  [String] url The hook URL.
+    # @param  [Hash] options Additional options, as allowed by Gitlab API, including but not limited to:
+    # @option options [String] :token A secret token for Gitlab to send in the `X-Gitlab-Token` header for authentication.
+    # @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))
+    end
+    alias add_system_hook add_hook
+
+    # Tests a system hook.
+    #
+    # @example
+    #   Gitlab.hook(3)
+    #   Gitlab.system_hook(12)
+    #
+    # @param  [Integer] id The ID of a system hook.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def hook(id)
+      get("/hooks/#{id}")
+    end
+    alias system_hook hook
+
+    # Deletes a new system hook.
+    #
+    # @example
+    #   Gitlab.delete_hook(3)
+    #   Gitlab.delete_system_hook(12)
+    #
+    # @param  [Integer] id The ID of a system hook.
+    # @return [Gitlab::ObjectifiedHash]
+    def delete_hook(id)
+      delete("/hooks/#{id}")
+    end
+    alias delete_system_hook delete_hook
+  end
+end

data/lib/gitlab/client/tags.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to tags.
+  # @see https://docs.gitlab.com/ce/api/tags.html
+  module Tags
+    # Gets a list of project repository tags.
+    #
+    # @example
+    #   Gitlab.tags(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 tags(project, options = {})
+      get("/projects/#{url_encode project}/repository/tags", query: options)
+    end
+    alias repo_tags tags
+
+    # Creates a new project repository tag.
+    #
+    # @example
+    #   Gitlab.create_tag(42, 'new_tag', 'master')
+    #   Gitlab.create_tag(42, 'v1.0', 'master', 'Release 1.0')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String]  tag_name The name of the new tag.
+    # @param  [String]  ref The ref (commit sha, branch name, or another tag) the tag will point to.
+    # @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, release_description: description })
+    end
+    alias repo_create_tag create_tag
+
+    # Gets information about a repository tag.
+    #
+    # @example
+    #   Gitlab.tag(3, 'api')
+    #   Gitlab.repo_tag(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] tag The name of the tag.
+    # @return [Gitlab::ObjectifiedHash]
+    def tag(project, tag)
+      get("/projects/#{url_encode project}/repository/tags/#{url_encode tag}")
+    end
+    alias repo_tag tag
+
+    # Deletes a repository tag.  Requires Gitlab >= 6.8.x
+    #
+    # @example
+    #   Gitlab.delete_tag(3, 'api')
+    #   Gitlab.repo_delete_tag(5, 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @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/#{url_encode tag}")
+    end
+    alias repo_delete_tag delete_tag
+
+    # Adds release notes to an existing repository tag.  Requires Gitlab >= 8.2.0
+    #
+    # @example
+    #   Gitlab.create_release(3, '1.0.0', 'This is ready for production')
+    #   Gitlab.repo_create_release(5, '1.0.0', 'This is ready for production')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] tag The name of the new tag.
+    # @param  [String] description Release notes with markdown support
+    # @return [Gitlab::ObjectifiedHash]
+    def create_release(project, tag, description)
+      post("/projects/#{url_encode project}/repository/tags/#{url_encode tag}/release", body: { description: description })
+    end
+    alias repo_create_release create_release
+
+    # Updates the release notes of a given release.  Requires Gitlab >= 8.2.0
+    #
+    # @example
+    #   Gitlab.update_release(3, '1.0.0', 'This is even more ready for production')
+    #   Gitlab.repo_update_release(5, '1.0.0', 'This is even more ready for production')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] tag The name of the new tag.
+    # @param  [String] description Release notes with markdown support
+    # @return [Gitlab::ObjectifiedHash]
+    def update_release(project, tag, description)
+      put("/projects/#{url_encode project}/repository/tags/#{url_encode tag}/release", body: { description: description })
+    end
+    alias repo_update_release update_release
+  end
+end