gitlab 4.5.0 → 4.6.0

data/lib/gitlab/client/pipeline_schedules.rb

@@ -1,133 +1,133 @@
-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
+# frozen_string_literal: true
 
-    # 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
+# 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
 
-    # 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", 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
 
-    # 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}", query: options)
-    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", query: 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
+  # 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}", query: options)
+  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
+  # 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
 
-    # 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", query: options)
-    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", query: 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}", query: 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}", query: 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
+  # 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

data/lib/gitlab/client/pipeline_triggers.rb

@@ -1,101 +1,101 @@
-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
+# frozen_string_literal: true
 
-    # 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
+# 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
 
-    # 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
+  # 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
 
-    # 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
+  # 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
 
-    # 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
+  # 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
 
-    # 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_method :delete_trigger, :remove_trigger
+  # 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
+  # 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

data/lib/gitlab/client/pipelines.rb

@@ -1,68 +1,68 @@
-class Gitlab::Client
-  # Defines methods related to pipelines.
-  # @see https://docs.gitlab.com/ce/api/pipelines.html
-  module Pipelines
-    # Gets a list of project pipelines.
-    #
-    # @example
-    #   Gitlab.pipelines(5)
-    #   Gitlab.pipelines(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 pipelines(project, options={})
-      get("/projects/#{url_encode project}/pipelines", query: options)
-    end
+# frozen_string_literal: true
 
-    # Gets a single pipeline.
-    #
-    # @example
-    #   Gitlab.pipeline(5, 36)
-    #
-    # @param  [Integer, String] project The ID or name of a project.
-    # @param  [Integer] id The ID of a pipeline.
-    # @return [Gitlab::ObjectifiedHash]
-    def pipeline(project, id)
-      get("/projects/#{url_encode project}/pipelines/#{id}")
-    end
+# Defines methods related to pipelines.
+# @see https://docs.gitlab.com/ce/api/pipelines.html
+module Pipelines
+  # Gets a list of project pipelines.
+  #
+  # @example
+  #   Gitlab.pipelines(5)
+  #   Gitlab.pipelines(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 pipelines(project, options = {})
+    get("/projects/#{url_encode project}/pipelines", query: options)
+  end
 
-    # Create a pipeline.
-    #
-    # @example
-    #   Gitlab.create_pipeline(5, 'master')
-    #
-    # @param  [Integer, String] project The ID or name of a project.
-    # @param  [String] ref Reference to commit.
-    # @return [Gitlab::ObjectifiedHash] The pipelines changes.
-    def create_pipeline(project, ref)
-      post("/projects/#{url_encode project}/pipeline?ref=#{ref}")
-    end
+  # Gets a single pipeline.
+  #
+  # @example
+  #   Gitlab.pipeline(5, 36)
+  #
+  # @param  [Integer, String] project The ID or name of a project.
+  # @param  [Integer] id The ID of a pipeline.
+  # @return [Gitlab::ObjectifiedHash]
+  def pipeline(project, id)
+    get("/projects/#{url_encode project}/pipelines/#{id}")
+  end
 
-    # Cancels a pipeline.
-    #
-    # @example
-    #   Gitlab.cancel_pipeline(5, 1)
-    #
-    # @param  [Integer, String] project The ID or name of a project.
-    # @param  [Integer] id The ID of a pipeline.
-    # @return [Gitlab::ObjectifiedHash] The pipelines changes.
-    def cancel_pipeline(project, id)
-      post("/projects/#{url_encode project}/pipelines/#{id}/cancel")
-    end
+  # Create a pipeline.
+  #
+  # @example
+  #   Gitlab.create_pipeline(5, 'master')
+  #
+  # @param  [Integer, String] project The ID or name of a project.
+  # @param  [String] ref Reference to commit.
+  # @return [Gitlab::ObjectifiedHash] The pipelines changes.
+  def create_pipeline(project, ref)
+    post("/projects/#{url_encode project}/pipeline?ref=#{ref}")
+  end
+
+  # Cancels a pipeline.
+  #
+  # @example
+  #   Gitlab.cancel_pipeline(5, 1)
+  #
+  # @param  [Integer, String] project The ID or name of a project.
+  # @param  [Integer] id The ID of a pipeline.
+  # @return [Gitlab::ObjectifiedHash] The pipelines changes.
+  def cancel_pipeline(project, id)
+    post("/projects/#{url_encode project}/pipelines/#{id}/cancel")
+  end
 
-    # Retry a pipeline.
-    #
-    # @example
-    #   Gitlab.retry_pipeline(5, 1)
-    #
-    # @param  [Integer, String] project The ID or name of a project.
-    # @param  [Integer] id The ID of a pipeline.
-    # @return [Array<Gitlab::ObjectifiedHash>] The pipelines changes.
-    def retry_pipeline(project, id)
-      post("/projects/#{url_encode project}/pipelines/#{id}/retry")
-    end
+  # Retry a pipeline.
+  #
+  # @example
+  #   Gitlab.retry_pipeline(5, 1)
+  #
+  # @param  [Integer, String] project The ID or name of a project.
+  # @param  [Integer] id The ID of a pipeline.
+  # @return [Array<Gitlab::ObjectifiedHash>] The pipelines changes.
+  def retry_pipeline(project, id)
+    post("/projects/#{url_encode project}/pipelines/#{id}/retry")
   end
 end