fs-gitlab 4.18.1

data/lib/gitlab/client/notes.rb

@@ -0,0 +1,313 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to notes.
+  # @see https://docs.gitlab.com/ce/api/notes.html
+  module Notes
+    # Gets a list of projects notes.
+    #
+    # @example
+    #   Gitlab.notes(5)
+    #
+    # @param [Integer] project The ID of a project.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def notes(project, options = {})
+      get("/projects/#{url_encode project}/notes", query: options)
+    end
+
+    # Gets a list of notes for a issue.
+    #
+    # @example
+    #   Gitlab.issue_notes(5, 10)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] issue The ID of an issue.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def issue_notes(project, issue, options = {})
+      get("/projects/#{url_encode project}/issues/#{issue}/notes", query: options)
+    end
+
+    # Gets a list of notes for a snippet.
+    #
+    # @example
+    #   Gitlab.snippet_notes(5, 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] snippet The ID of a snippet.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def snippet_notes(project, snippet, options = {})
+      get("/projects/#{url_encode project}/snippets/#{snippet}/notes", query: options)
+    end
+
+    # Gets a list of notes for a merge request.
+    #
+    # @example
+    #   Gitlab.merge_request_notes(5, 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge request.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def merge_request_notes(project, merge_request, options = {})
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", query: options)
+    end
+    alias merge_request_comments merge_request_notes
+
+    # Gets a list of notes for an epic.
+    #
+    # @example
+    #   Gitlab.epic_notes(5, 10)
+    #
+    # @param [Integer] project The ID of a group.
+    # @param [Integer] epic The ID of an epic.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def epic_notes(group, epic, options = {})
+      get("/groups/#{url_encode group}/epics/#{epic}/notes", query: options)
+    end
+
+    # Gets a single wall note.
+    #
+    # @example
+    #   Gitlab.note(5, 15)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def note(project, id)
+      get("/projects/#{url_encode project}/notes/#{id}")
+    end
+
+    # Gets a single issue note.
+    #
+    # @example
+    #   Gitlab.issue_note(5, 10, 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] issue The ID of an issue.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def issue_note(project, issue, id)
+      get("/projects/#{url_encode project}/issues/#{issue}/notes/#{id}")
+    end
+
+    # Gets a single snippet note.
+    #
+    # @example
+    #   Gitlab.snippet_note(5, 11, 3)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] snippet The ID of a snippet.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def snippet_note(project, snippet, id)
+      get("/projects/#{url_encode project}/snippets/#{snippet}/notes/#{id}")
+    end
+
+    # Gets a single merge_request note.
+    #
+    # @example
+    #   Gitlab.merge_request_note(5, 11, 3)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge_request.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def merge_request_note(project, merge_request, id)
+      get("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}")
+    end
+
+    # Creates a new wall note.
+    #
+    # @example
+    #   Gitlab.create_note(5, 'This is a wall note!')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] body The body of a note.
+    # @return [Gitlab::ObjectifiedHash] Information about created note.
+    def create_note(project, body)
+      post("/projects/#{url_encode project}/notes", body: { body: body })
+    end
+
+    # Creates a new issue note.
+    #
+    # @example
+    #   Gitlab.create_issue_note(6, 1, 'Adding a note to my issue.')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] issue The ID of an issue.
+    # @param  [String] body The body of a note.
+    # @return [Gitlab::ObjectifiedHash] Information about created note.
+    def create_issue_note(project, issue, body)
+      post("/projects/#{url_encode project}/issues/#{issue}/notes", body: { body: body })
+    end
+
+    # Creates a new snippet note.
+    #
+    # @example
+    #   Gitlab.create_snippet_note(3, 2, 'Look at this awesome snippet!')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] snippet The ID of a snippet.
+    # @param  [String] body The body of a note.
+    # @return [Gitlab::ObjectifiedHash] Information about created note.
+    def create_snippet_note(project, snippet, body)
+      post("/projects/#{url_encode project}/snippets/#{snippet}/notes", body: { body: body })
+    end
+
+    # Creates a new note for a single merge request.
+    #
+    # @example
+    #   Gitlab.create_merge_request_note(5, 3, 'This MR is ready for review.')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge request.
+    # @param [String] body The content of a note.
+    def create_merge_request_note(project, merge_request, body)
+      post("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes", body: { body: body })
+    end
+    alias create_merge_request_comment create_merge_request_note
+
+    # Creates a new epic note.
+    #
+    # @example
+    #   Gitlab.create_epic_note(6, 1, 'Adding a note to my epic.')
+    #
+    # @param  [Integer, String] group The ID or name of a group.
+    # @param  [Integer] epic The ID of an epic.
+    # @param  [String] body The body of a note.
+    # @return [Gitlab::ObjectifiedHash] Information about created note.
+    def create_epic_note(group, epic, body)
+      post("/groups/#{url_encode group}/epics/#{epic}/notes", body: { body: body })
+    end
+
+    # Deletes a wall note.
+    #
+    # @example
+    #   Gitlab.delete_note(5, 15)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def delete_note(project, id)
+      delete("/projects/#{url_encode project}/notes/#{id}")
+    end
+
+    # Deletes an issue note.
+    #
+    # @example
+    #   Gitlab.delete_issue_note(5, 10, 1)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] issue The ID of an issue.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def delete_issue_note(project, issue, id)
+      delete("/projects/#{url_encode project}/issues/#{issue}/notes/#{id}")
+    end
+
+    # Deletes a snippet note.
+    #
+    # @example
+    #   Gitlab.delete_snippet_note(5, 11, 3)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] snippet The ID of a snippet.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def delete_snippet_note(project, snippet, id)
+      delete("/projects/#{url_encode project}/snippets/#{snippet}/notes/#{id}")
+    end
+
+    # Deletes a merge_request note.
+    #
+    # @example
+    #   Gitlab.delete_merge_request_note(5, 11, 3)
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge_request.
+    # @param [Integer] id The ID of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def delete_merge_request_note(project, merge_request, id)
+      delete("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}")
+    end
+    alias delete_merge_request_comment delete_merge_request_note
+
+    # Modifies a wall note.
+    #
+    # @example
+    #   Gitlab.edit_note(5, 15, 'This is an edited note')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] id The ID of a note.
+    # @param [String] body The content of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def edit_note(project, id, body)
+      put("/projects/#{url_encode project}/notes/#{id}", body: note_content(body))
+    end
+
+    # Modifies an issue note.
+    #
+    # @example
+    #   Gitlab.edit_issue_note(5, 10, 1, 'This is an edited issue note')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] issue The ID of an issue.
+    # @param [Integer] id The ID of a note.
+    # @param [String] body The content of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def edit_issue_note(project, issue, id, body)
+      put("/projects/#{url_encode project}/issues/#{issue}/notes/#{id}", body: note_content(body))
+    end
+
+    # Modifies a snippet note.
+    #
+    # @example
+    #   Gitlab.edit_snippet_note(5, 11, 3, 'This is an edited snippet note')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] snippet The ID of a snippet.
+    # @param [Integer] id The ID of a note.
+    # @param [String] body The content of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def edit_snippet_note(project, snippet, id, body)
+      put("/projects/#{url_encode project}/snippets/#{snippet}/notes/#{id}", body: note_content(body))
+    end
+
+    # Modifies a merge_request note.
+    #
+    # @example
+    #   Gitlab.edit_merge_request_note(5, 11, 3, 'This is an edited merge request note')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [Integer] merge_request The ID of a merge_request.
+    # @param [Integer] id The ID of a note.
+    # @param [String] body The content of a note.
+    # @return [Gitlab::ObjectifiedHash]
+    def edit_merge_request_note(project, merge_request, id, body)
+      put("/projects/#{url_encode project}/merge_requests/#{merge_request}/notes/#{id}", body: note_content(body))
+    end
+    alias edit_merge_request_comment edit_merge_request_note
+
+    private
+
+    # TODO: Remove this method after a couple deprecation cycles.  Replace calls with the code
+    # in the 'else'.
+    def note_content(body)
+      if body.is_a?(Hash)
+        warn 'Passing the note body as a Hash is deprecated.  You should just pass the String.'
+        body
+      else
+        { body: body }
+      end
+    end
+  end
+end

data/lib/gitlab/client/packages.rb

@@ -0,0 +1,95 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to GitLab Packages.
+  # @see https://docs.gitlab.com/ee/api/packages.html
+  module Packages
+    # Gets a list of project packages.
+    #
+    # @example
+    #   Gitlab.project_packages(5)
+    #   Gitlab.project_packages(5, { package_type: 'npm', sort: 'desc' })
+    #
+    # @param   [Integer, String] :project the ID or name of a project.
+    # @param   [Hash] options A customizable set of options.
+    # @options options [String] :order_by The field to use as order. One of created_at (default), name, version, or type.
+    # @options options [String] :sort The direction of the order, either asc (default) for ascending order or desc for descending order.
+    # @options options [String] :package_type Filter the returned packages by type. One of conan, maven, npm, pypi, composer, nuget, helm, terraform_module, or golang.
+    # @options options [String] :package_name Filter the project packages with a fuzzy search by name.
+    # @options options [String] :include_versionless When set to true, versionless packages are included in the response.
+    # @options options [String] :status Filter the returned packages by status. One of default (default), hidden, processing, error, or pending_destruction.
+    # @return  [Array<Gitlab::ObjectifiedHash>]
+    def project_packages(project, options = {})
+      get("/projects/#{url_encode project}/packages", query: options)
+    end
+
+    # Gets a list of project packages.
+    #
+    # @example
+    #   Gitlab.group_packages(5)
+    #   Gitlab.group_packages(5, { package_type: 'npm', sort: 'desc' })
+    #
+    # @param   [Integer, String] project the ID or name of a project.
+    # @param   [Hash] options A customizable set of options.
+    # @options options [String] :exclude_subgroups If the parameter is included as true, packages from projects from subgroups are not listed. Default is false.
+    # @options options [String] :order_by The field to use as order. One of created_at (default), name, version, or type.
+    # @options options [String] :sort The direction of the order, either asc (default) for ascending order or desc for descending order.
+    # @options options [String] :package_type Filter the returned packages by type. One of conan, maven, npm, pypi, composer, nuget, helm, terraform_module, or golang.
+    # @options options [String] :package_name Filter the project packages with a fuzzy search by name.
+    # @options options [String] :include_versionless When set to true, versionless packages are included in the response.
+    # @options options [String] :status Filter the returned packages by status. One of default (default), hidden, processing, error, or pending_destruction.
+    # @return  [Array<Gitlab::ObjectifiedHash>]
+    def group_packages(group, options = {})
+      get("/groups/#{url_encode group}/packages", query: options)
+    end
+
+    # Get a single project package.
+    #
+    # @example
+    #   Gitlab.project_package(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [Gitlab::ObjectifiedHash]
+    def project_package(project, id)
+      get("/projects/#{url_encode project}/packages/#{id}")
+    end
+
+    # Get a list of package files of a single package.
+    #
+    # @example
+    #   Gitlab.project_package_files(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def project_package_files(project, id)
+      get("/projects/#{url_encode project}/packages/#{id}/package_files")
+    end
+
+    # Deletes a project package.
+    #
+    # @example
+    #   Gitlab.delete_project_package(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id ID of a package.
+    # @return [void] This API call returns an empty response body.
+    def delete_project_package(project, id)
+      delete("/projects/#{url_encode project}/packages/#{id}")
+    end
+
+    # Delete a package file.
+    #
+    # @example
+    #   Gitlab.delete_project_file(5, 3, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] package_id ID of a package.
+    # @param  [Integer] file_id ID of a package file.
+    # @return [void] This API call returns an empty response body.
+    def delete_project_package_file(project, package_id, file_id)
+      delete("/projects/#{url_encode project}/packages/#{package_id}/package_files/#{file_id}")
+    end
+  end
+end

data/lib/gitlab/client/pipeline_schedules.rb

@@ -0,0 +1,147 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to pipeline schedules.
+  # @see https://docs.gitlab.com/ce/api/pipeline_schedules.html
+  module PipelineSchedules
+    # Gets a list of project pipeline schedules.
+    #
+    # @example
+    #   Gitlab.pipeline_schedules(5)
+    #   Gitlab.pipeline_schedules(5, { scope: 'active' })
+    #
+    # @param   [Integer, String] project the ID or name of a project.
+    # @param   [Hash] options A customizable set of options.
+    # @options options [String] :scope The scope of pipeline schedules, one of a 'active' or 'inactive'.
+    # @return  [Array<Gitlab::ObjectifiedHash>]
+    def pipeline_schedules(project, options = {})
+      get("/projects/#{url_encode project}/pipeline_schedules", query: options)
+    end
+
+    # Gets a single pipeline schedule.
+    #
+    # @example
+    #   Gitlab.pipeline_schedule(5, 3)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of the pipeline schedule.
+    # @return [Gitlab::ObjectifiedHash]
+    def pipeline_schedule(project, id)
+      get("/projects/#{url_encode project}/pipeline_schedules/#{id}")
+    end
+
+    # Create a pipeline schedule.
+    #
+    # @example
+    #   Gitlab.create_pipeline_schedule(5, { description: 'example' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description The description of pipeline scehdule.
+    # @option options [String] :ref The branch/tag name will be triggered.
+    # @option options [String] :cron The cron (e.g. 0 1 * * *).
+    # @option options [String] :cron_timezone The timezone supproted by ActiveSupport::TimeZone (e.g. Pacific Time (US & Canada)) (default: 'UTC').
+    # @option options [Boolean] :active The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: true).
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def create_pipeline_schedule(project, options = {})
+      post("/projects/#{url_encode project}/pipeline_schedules", body: options)
+    end
+
+    # Updates the pipeline schedule of a project.
+    #
+    # @example
+    #   Gitlab.edit_pipeline_schedule(3, 2, { description: 'example2' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] The pipeline schedule ID.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description The description of pipeline scehdule.
+    # @option options [String] :ref The branch/tag name will be triggered.
+    # @option options [String] :cron The cron (e.g. 0 1 * * *).
+    # @option options [String] :cron_timezone The timezone supproted by ActiveSupport::TimeZone (e.g. Pacific Time (US & Canada)) (default: 'UTC').
+    # @option options [Boolean] :active The activation of pipeline schedule. If false is set, the pipeline schedule will deactivated initially (default: true).
+    # @return [Array<Gitlab::ObjectifiedHash>] The updated pipeline schedule.
+    def edit_pipeline_schedule(project, pipeline_schedule_id, options = {})
+      put("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}", body: options)
+    end
+
+    # Take ownership of a pipeline schedule.
+    #
+    # @example
+    #   Gitlab.pipeline_schedule_take_ownership(5, 1)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The pipeline schedule ID.
+    # @return [Gitlab::ObjectifiedHash] The updated pipeline schedule.
+    def pipeline_schedule_take_ownership(project, pipeline_schedule_id)
+      post("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}/take_ownership")
+    end
+
+    # Run a scheduled pipeline immediately.
+    #
+    # @example
+    #   Gitlab.run_pipeline_schedule(5, 1)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The pipeline schedule ID.
+    # @return [Gitlab::ObjectifiedHash] Pipeline created message.
+    def run_pipeline_schedule(project, pipeline_schedule_id)
+      post("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}/play")
+    end
+
+    # Delete a pipeline schedule.
+    #
+    # @example
+    #   Gitlab.delete_pipeline_schedule(5, 1)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The pipeline schedule ID.
+    # @return [Gitlab::ObjectifiedHash] The deleted pipeline schedule.
+    def delete_pipeline_schedule(project, pipeline_schedule_id)
+      delete("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}")
+    end
+
+    # Create a pipeline schedule variable.
+    #
+    # @example
+    #   Gitlab.create_pipeline_schedule_variable(5, 1, { key: 'foo', value: 'bar' })
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The pipeline schedule ID.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :key The key of a variable; must have no more than 255 characters; only A-Z, a-z, 0-9, and _ are allowed.
+    # @option options [String] :value The value of a variable
+    # @return [Array<Gitlab::ObjectifiedHash>] The created pipeline schedule variable.
+    def create_pipeline_schedule_variable(project, pipeline_schedule_id, options = {})
+      post("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}/variables", body: options)
+    end
+
+    # Updates the variable of a pipeline schedule.
+    #
+    # @example
+    #   Gitlab.edit_pipeline_schedule_variable(3, 2, "foo" { value: 'bar' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] The pipeline schedule ID.
+    # @param  [String] The key of a variable.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :value The value of a variable.
+    # @return [Array<Gitlab::ObjectifiedHash>] The updated pipeline schedule variable.
+    def edit_pipeline_schedule_variable(project, pipeline_schedule_id, key, options = {})
+      put("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}/variables/#{url_encode key}", body: options)
+    end
+
+    # Delete the variable of a pipeline schedule
+    #
+    # @example
+    #   Gitlab.delete_pipeline_schedule_variable(3, 2, "foo")
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] The pipeline schedule ID.
+    # @param  [String] The key of a variable.
+    # @return [Array<Gitlab::ObjectifiedHash>] The deleted pipeline schedule variable.
+    def delete_pipeline_schedule_variable(project, pipeline_schedule_id, key, _options = {})
+      delete("/projects/#{url_encode project}/pipeline_schedules/#{pipeline_schedule_id}/variables/#{url_encode key}")
+    end
+  end
+end

data/lib/gitlab/client/pipeline_triggers.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to pipelines.
+  # @see https://docs.gitlab.com/ce/api/pipeline_triggers.html
+  # @see https://docs.gitlab.com/ce/ci/triggers/README.html
+  module PipelineTriggers
+    # Gets a list of the project's pipeline triggers
+    #
+    # @example
+    #   Gitlab.triggers(5)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>] The list of triggers.
+    def triggers(project)
+      get("/projects/#{url_encode project}/triggers")
+    end
+
+    # Gets details of project's pipeline trigger.
+    #
+    # @example
+    #   Gitlab.trigger(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] trigger_id The trigger ID.
+    # @return [Gitlab::ObjectifiedHash] The trigger.
+    def trigger(project, trigger_id)
+      get("/projects/#{url_encode project}/triggers/#{trigger_id}")
+    end
+
+    # Create a pipeline trigger for a project.
+    #
+    # @example
+    #   Gitlab.create_trigger(5, description: "my description")
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] description The trigger name
+    # @return [Gitlab::ObjectifiedHash] The created trigger.
+    def create_trigger(project, description)
+      post("/projects/#{url_encode project}/triggers", body: { description: description })
+    end
+
+    # Update a project trigger
+    #
+    # @example
+    #   Gitlab.update_trigger(5, 1, description: "my description")
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The trigger ID.
+    # @param [Hash] options A customizable set of options.
+    # @option options [String] :description The trigger name.
+    # @return [Gitlab::ObjectifiedHash] The updated trigger.
+    def update_trigger(project, trigger_id, options = {})
+      put("/projects/#{url_encode project}/triggers/#{trigger_id}", body: options)
+    end
+
+    # Take ownership of a project trigger
+    #
+    # @example
+    #   Gitlab.trigger_take_ownership(5, 1)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] trigger_id The trigger ID.
+    # @return [Gitlab::ObjectifiedHash] The updated trigger.
+    def trigger_take_ownership(project, trigger_id)
+      post("/projects/#{url_encode project}/triggers/#{trigger_id}/take_ownership")
+    end
+
+    # Remove a project's pipeline trigger.
+    #
+    # @example
+    #   Gitlab.remove_trigger(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] trigger_id The trigger ID.
+    # @return [void]    This API call returns an empty response body.
+    def remove_trigger(project, trigger_id)
+      delete("/projects/#{url_encode project}/triggers/#{trigger_id}")
+    end
+    alias delete_trigger remove_trigger
+
+    # Run the given project pipeline trigger.
+    #
+    # @example
+    #   Gitlab.run_trigger(5, '7b9148c158980bbd9bcea92c17522d', 'master')
+    #   Gitlab.run_trigger(5, '7b9148c158980bbd9bcea92c17522d', 'master', { variable1: "value", variable2: "value2" })
+    #
+    # @see https://docs.gitlab.com/ce/ci/triggers/README.html
+    #
+    # @param  [Integer, String] project The ID or name of the project.
+    # @param  [String] token The token of a trigger.
+    # @param  [String] ref Branch or tag name to build.
+    # @param  [Hash] variables A set of build variables to use for the build. (optional)
+    # @return [Gitlab::ObjectifiedHash] The trigger.
+    def run_trigger(project, token, ref, variables = {})
+      post("/projects/#{url_encode project}/trigger/pipeline", unauthenticated: true, body: {
+             token: token,
+             ref: ref,
+             variables: variables
+           })
+    end
+  end
+end