gitlab 4.6.0 → 4.7.0

data/lib/gitlab/client/builds.rb

@@ -1,106 +1,108 @@
 # frozen_string_literal: true
 
-# Defines methods related to builds.
-# @see https://docs.gitlab.com/ce/api/builds.html
-module Builds
-  # Gets a list of project builds.
-  #
-  # @example
-  #   Gitlab.builds(5)
-  #   Gitlab.builds(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.
-  # @param  [Integer, String] project The ID or name of a project.
-  # @return [Array<Gitlab::ObjectifiedHash>]
-  def builds(project, options = {})
-    get("/projects/#{url_encode project}/builds", query: options)
-  end
+class Gitlab::Client
+  # Defines methods related to builds.
+  # @see https://docs.gitlab.com/ce/api/builds.html
+  module Builds
+    # Gets a list of project builds.
+    #
+    # @example
+    #   Gitlab.builds(5)
+    #   Gitlab.builds(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.
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def builds(project, options = {})
+      get("/projects/#{url_encode project}/builds", query: options)
+    end
 
-  # Gets a single build.
-  #
-  # @example
-  #   Gitlab.build(5, 36)
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Integer] id The ID of a build.
-  # @return [Gitlab::ObjectifiedHash]
-  def build(project, id)
-    get("/projects/#{url_encode project}/builds/#{id}")
-  end
+    # Gets a single build.
+    #
+    # @example
+    #   Gitlab.build(5, 36)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a build.
+    # @return [Gitlab::ObjectifiedHash]
+    def build(project, id)
+      get("/projects/#{url_encode project}/builds/#{id}")
+    end
 
-  # Gets build artifacts.
-  #
-  # @example
-  #   Gitlab.build_artifacts(1, 8)
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Integer] id The ID of a build.
-  # @return [Gitlab::FileResponse]
-  def build_artifacts(project, id)
-    get("/projects/#{url_encode project}/builds/#{id}/artifacts",
-        format: nil,
-        headers: { Accept: 'application/octet-stream' },
-        parser: proc { |body, _|
-                  if body.encoding == Encoding::ASCII_8BIT # binary response
-                    ::Gitlab::FileResponse.new StringIO.new(body, 'rb+')
-                  else # error with json response
-                    ::Gitlab::Request.parse(body)
-                  end
-                })
-  end
+    # Gets build artifacts.
+    #
+    # @example
+    #   Gitlab.build_artifacts(1, 8)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a build.
+    # @return [Gitlab::FileResponse]
+    def build_artifacts(project, id)
+      get("/projects/#{url_encode project}/builds/#{id}/artifacts",
+          format: nil,
+          headers: { Accept: 'application/octet-stream' },
+          parser: proc { |body, _|
+                    if body.encoding == Encoding::ASCII_8BIT # binary response
+                      ::Gitlab::FileResponse.new StringIO.new(body, 'rb+')
+                    else # error with json response
+                      ::Gitlab::Request.parse(body)
+                    end
+                  })
+    end
 
-  # Gets a list of builds for specific commit in a project.
-  #
-  # @example
-  #   Gitlab.commit_builds(5, 'asdf')
-  #   Gitlab.commit_builds(5, 'asdf', { per_page: 10, page: 2 })
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The SHA checksum of a commit.
-  # @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>] The list of builds.
-  def commit_builds(project, sha, options = {})
-    get("/projects/#{url_encode project}/repository/commits/#{sha}/builds", query: options)
-  end
+    # Gets a list of builds for specific commit in a project.
+    #
+    # @example
+    #   Gitlab.commit_builds(5, 'asdf')
+    #   Gitlab.commit_builds(5, 'asdf', { per_page: 10, page: 2 })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The SHA checksum of a commit.
+    # @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>] The list of builds.
+    def commit_builds(project, sha, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{sha}/builds", query: options)
+    end
 
-  # Cancels a build.
-  #
-  # @example
-  #   Gitlab.build_cancel(5, 1)
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Integer] id The ID of a build.
-  # @return [Gitlab::ObjectifiedHash] The builds changes.
-  def build_cancel(project, id)
-    post("/projects/#{url_encode project}/builds/#{id}/cancel")
-  end
+    # Cancels a build.
+    #
+    # @example
+    #   Gitlab.build_cancel(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a build.
+    # @return [Gitlab::ObjectifiedHash] The builds changes.
+    def build_cancel(project, id)
+      post("/projects/#{url_encode project}/builds/#{id}/cancel")
+    end
 
-  # Retry a build.
-  #
-  # @example
-  #   Gitlab.build_retry(5, 1)
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Integer] id The ID of a build.
-  # @return [Array<Gitlab::ObjectifiedHash>] The builds changes.
-  def build_retry(project, id)
-    post("/projects/#{url_encode project}/builds/#{id}/retry")
-  end
+    # Retry a build.
+    #
+    # @example
+    #   Gitlab.build_retry(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a build.
+    # @return [Array<Gitlab::ObjectifiedHash>] The builds changes.
+    def build_retry(project, id)
+      post("/projects/#{url_encode project}/builds/#{id}/retry")
+    end
 
-  # Erase a single build of a project (remove build artifacts and a build trace)
-  #
-  # @example
-  #   Gitlab.build_erase(5, 1)
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Integer] id The ID of a build.
-  # @return [Gitlab::ObjectifiedHash] The build's changes.
-  def build_erase(project, id)
-    post("/projects/#{url_encode project}/builds/#{id}/erase")
+    # Erase a single build of a project (remove build artifacts and a build trace)
+    #
+    # @example
+    #   Gitlab.build_erase(5, 1)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of a build.
+    # @return [Gitlab::ObjectifiedHash] The build's changes.
+    def build_erase(project, id)
+      post("/projects/#{url_encode project}/builds/#{id}/erase")
+    end
   end
 end

data/lib/gitlab/client/commits.rb

@@ -1,164 +1,179 @@
 # frozen_string_literal: true
 
-# Defines methods related to repository commits.
-# @see https://docs.gitlab.com/ce/api/commits.html
-module Commits
-  # Gets a list of project commits.
-  #
-  # @example
-  #   Gitlab.commits('viking')
-  #   Gitlab.repo_commits('gitlab', { ref_name: 'api' })
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [Hash] options A customizable set of options.
-  # @option options [String] :ref_name The branch or tag name of a project repository.
-  # @option options [Integer] :page The page number.
-  # @option options [Integer] :per_page The number of results per page.
-  # @return [Array<Gitlab::ObjectifiedHash>]
-  def commits(project, options = {})
-    get("/projects/#{url_encode project}/repository/commits", query: options)
-  end
-  alias repo_commits commits
+class Gitlab::Client
+  # Defines methods related to repository commits.
+  # @see https://docs.gitlab.com/ce/api/commits.html
+  module Commits
+    # Gets a list of project commits.
+    #
+    # @example
+    #   Gitlab.commits('viking')
+    #   Gitlab.repo_commits('gitlab', { ref_name: 'api' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :ref_name The branch or tag name of a project repository.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def commits(project, options = {})
+      get("/projects/#{url_encode project}/repository/commits", query: options)
+    end
+    alias repo_commits commits
 
-  # Gets a specific commit identified by the commit hash or name of a branch or tag.
-  #
-  # @example
-  #   Gitlab.commit(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
-  #   Gitlab.repo_commit(3, 'ed899a2f4b50b4370feeea94676502b42383c746')
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The commit hash or name of a repository branch or tag
-  # @return [Gitlab::ObjectifiedHash]
-  def commit(project, sha)
-    get("/projects/#{url_encode project}/repository/commits/#{sha}")
-  end
-  alias repo_commit commit
+    # Gets a specific commit identified by the commit hash or name of a branch or tag.
+    #
+    # @example
+    #   Gitlab.commit(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
+    #   Gitlab.repo_commit(3, 'ed899a2f4b50b4370feeea94676502b42383c746')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash or name of a repository branch or tag
+    # @return [Gitlab::ObjectifiedHash]
+    def commit(project, sha)
+      get("/projects/#{url_encode project}/repository/commits/#{sha}")
+    end
+    alias repo_commit commit
 
-  # Get the diff of a commit in a project.
-  #
-  # @example
-  #   Gitlab.commit_diff(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
-  #   Gitlab.repo_commit_diff(3, 'ed899a2f4b50b4370feeea94676502b42383c746')
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The name of a repository branch or tag or if not given the default branch.
-  # @return [Gitlab::ObjectifiedHash]
-  def commit_diff(project, sha)
-    get("/projects/#{url_encode project}/repository/commits/#{sha}/diff")
-  end
-  alias repo_commit_diff commit_diff
+    # Cherry picks a commit to a given branch.
+    #
+    # @example
+    #   Gitlab.cherry_pick_commit(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'master')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash or name of a repository branch or tag
+    # @param  [String] branch The name of the branch
+    # @return [Gitlab::ObjectifiedHash]
+    def cherry_pick_commit(project, sha, branch)
+      post("/projects/#{url_encode project}/repository/commits/#{sha}/cherry_pick", body: { branch: branch })
+    end
 
-  # Gets a list of comments for a commit.
-  #
-  # @example
-  #   Gitlab.commit_comments(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b')
-  #
-  # @param [Integer] project The ID of a project.
-  # @param [String] sha The commit hash or name of a repository branch or tag.
-  # @option options [Integer] :page The page number.
-  # @option options [Integer] :per_page The number of results per page.
-  # @return [Array<Gitlab::ObjectifiedHash>]
-  def commit_comments(project, commit, options = {})
-    get("/projects/#{url_encode project}/repository/commits/#{commit}/comments", query: options)
-  end
-  alias repo_commit_comments commit_comments
+    # Get the diff of a commit in a project.
+    #
+    # @example
+    #   Gitlab.commit_diff(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
+    #   Gitlab.repo_commit_diff(3, 'ed899a2f4b50b4370feeea94676502b42383c746')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The name of a repository branch or tag or if not given the default branch.
+    # @return [Gitlab::ObjectifiedHash]
+    def commit_diff(project, sha)
+      get("/projects/#{url_encode project}/repository/commits/#{sha}/diff")
+    end
+    alias repo_commit_diff commit_diff
 
-  # Creates a new comment for a commit.
-  #
-  # @example
-  #   Gitlab.create_commit_comment(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b', 'Nice work on this commit!')
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The commit hash or name of a repository branch or tag.
-  # @param  [String] note The text of a comment.
-  # @param  [Hash] options A customizable set of options.
-  # @option options [String] :path The file path.
-  # @option options [Integer] :line The line number.
-  # @option options [String] :line_type The line type (new or old).
-  # @return [Gitlab::ObjectifiedHash] Information about created comment.
-  def create_commit_comment(project, commit, note, options = {})
-    post("/projects/#{url_encode project}/repository/commits/#{commit}/comments", body: options.merge(note: note))
-  end
-  alias repo_create_commit_comment create_commit_comment
+    # Gets a list of comments for a commit.
+    #
+    # @example
+    #   Gitlab.commit_comments(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [String] sha The commit hash or name of a repository branch or tag.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def commit_comments(project, commit, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{commit}/comments", query: options)
+    end
+    alias repo_commit_comments commit_comments
 
-  # Get the status of a commit
-  #
-  # @example
-  #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
-  #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', { name: 'jenkins' })
-  #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', { name: 'jenkins', all: true })
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The commit hash
-  # @param  [Hash] options A customizable set of options.
-  # @option options [String] :ref Filter by ref name, it can be branch or tag
-  # @option options [String] :stage Filter by stage
-  # @option options [String] :name Filter by status name, eg. jenkins
-  # @option options [Boolean] :all The flag to return all statuses, not only latest ones
-  def commit_status(project, sha, options = {})
-    get("/projects/#{url_encode project}/repository/commits/#{sha}/statuses", query: options)
-  end
-  alias repo_commit_status commit_status
+    # Creates a new comment for a commit.
+    #
+    # @example
+    #   Gitlab.create_commit_comment(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b', 'Nice work on this commit!')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash or name of a repository branch or tag.
+    # @param  [String] note The text of a comment.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :path The file path.
+    # @option options [Integer] :line The line number.
+    # @option options [String] :line_type The line type (new or old).
+    # @return [Gitlab::ObjectifiedHash] Information about created comment.
+    def create_commit_comment(project, commit, note, options = {})
+      post("/projects/#{url_encode project}/repository/commits/#{commit}/comments", body: options.merge(note: note))
+    end
+    alias repo_create_commit_comment create_commit_comment
 
-  # Adds or updates a status of a commit.
-  #
-  # @example
-  #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'success')
-  #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'failed', { name: 'jenkins' })
-  #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'canceled', { name: 'jenkins', target_url: 'http://example.com/builds/1' })
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param  [String] sha The commit hash
-  # @param  [String] state of the status. Can be: pending, running, success, failed, canceled
-  # @param  [Hash] options A customizable set of options.
-  # @option options [String] :ref The ref (branch or tag) to which the status refers
-  # @option options [String] :name Filter by status name, eg. jenkins
-  # @option options [String] :target_url The target URL to associate with this status
-  def update_commit_status(project, sha, state, options = {})
-    post("/projects/#{url_encode project}/statuses/#{sha}", query: options.merge(state: state))
-  end
-  alias repo_update_commit_status update_commit_status
+    # Get the status of a commit
+    #
+    # @example
+    #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6')
+    #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', { name: 'jenkins' })
+    #   Gitlab.commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', { name: 'jenkins', all: true })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :ref Filter by ref name, it can be branch or tag
+    # @option options [String] :stage Filter by stage
+    # @option options [String] :name Filter by status name, eg. jenkins
+    # @option options [Boolean] :all The flag to return all statuses, not only latest ones
+    def commit_status(project, sha, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{sha}/statuses", query: options)
+    end
+    alias repo_commit_status commit_status
 
-  # Creates a single commit with one or more changes
-  #
-  # @see https://docs.gitlab.com/ce/api/commits.html#create-a-commit-with-multiple-files-and-actions
-  # Introduced in Gitlab 8.13
-  #
-  # @example
-  # Gitlab.create_commit(2726132, 'master', 'refactors everything', [{action: 'create', file_path: '/foo.txt', content: 'bar'}])
-  # Gitlab.create_commit(2726132, 'master', 'refactors everything', [{action: 'delete', file_path: '/foo.txt'}])
-  #
-  # @param  [Integer, String] project The ID or name of a project.
-  # @param [String] branch the branch name you wish to commit to
-  # @param [String] message the commit message
-  # @param [Array[Hash]] An array of action hashes to commit as a batch. See the next table for what attributes it can take.
-  # @option options [String] :author_email the email address of the author
-  # @option options [String] :author_name the name of the author
-  # @return [Gitlab::ObjectifiedHash] hash of commit related data
-  def create_commit(project, branch, message, actions, options = {})
-    payload = {
-      branch: branch,
-      commit_message: message,
-      actions: actions
-    }.merge(options)
-    post("/projects/#{url_encode project}/repository/commits", body: payload)
-  end
+    # Adds or updates a status of a commit.
+    #
+    # @example
+    #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'success')
+    #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'failed', { name: 'jenkins' })
+    #   Gitlab.update_commit_status(42, '6104942438c14ec7bd21c6cd5bd995272b3faff6', 'canceled', { name: 'jenkins', target_url: 'http://example.com/builds/1' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] sha The commit hash
+    # @param  [String] state of the status. Can be: pending, running, success, failed, canceled
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :ref The ref (branch or tag) to which the status refers
+    # @option options [String] :name Filter by status name, eg. jenkins
+    # @option options [String] :target_url The target URL to associate with this status
+    def update_commit_status(project, sha, state, options = {})
+      post("/projects/#{url_encode project}/statuses/#{sha}", query: options.merge(state: state))
+    end
+    alias repo_update_commit_status update_commit_status
+
+    # Creates a single commit with one or more changes
+    #
+    # @see https://docs.gitlab.com/ce/api/commits.html#create-a-commit-with-multiple-files-and-actions
+    # Introduced in Gitlab 8.13
+    #
+    # @example
+    # Gitlab.create_commit(2726132, 'master', 'refactors everything', [{action: 'create', file_path: '/foo.txt', content: 'bar'}])
+    # Gitlab.create_commit(2726132, 'master', 'refactors everything', [{action: 'delete', file_path: '/foo.txt'}])
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param [String] branch the branch name you wish to commit to
+    # @param [String] message the commit message
+    # @param [Array[Hash]] An array of action hashes to commit as a batch. See the next table for what attributes it can take.
+    # @option options [String] :author_email the email address of the author
+    # @option options [String] :author_name the name of the author
+    # @return [Gitlab::ObjectifiedHash] hash of commit related data
+    def create_commit(project, branch, message, actions, options = {})
+      payload = {
+        branch: branch,
+        commit_message: message,
+        actions: actions
+      }.merge(options)
+      post("/projects/#{url_encode project}/repository/commits", body: payload)
+    end
 
-  # Gets a list of merge requests for a commit.
-  #
-  # @see https://docs.gitlab.com/ce/api/commits.html#list-merge-requests-associated-with-a-commit
-  # Introduced in Gitlab 10.7
-  #
-  # @example
-  #   Gitlab.commit_merge_requests(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b')
-  #
-  # @param [Integer] project The ID of a project.
-  # @param [String] sha The commit hash.
-  # @option options [Integer] :page The page number.
-  # @option options [Integer] :per_page The number of results per page.
-  # @return [Array<Gitlab::ObjectifiedHash>]
-  def commit_merge_requests(project, commit, options = {})
-    get("/projects/#{url_encode project}/repository/commits/#{commit}/merge_requests", query: options)
+    # Gets a list of merge requests for a commit.
+    #
+    # @see https://docs.gitlab.com/ce/api/commits.html#list-merge-requests-associated-with-a-commit
+    # Introduced in Gitlab 10.7
+    #
+    # @example
+    #   Gitlab.commit_merge_requests(5, 'c9f9662a9b1116c838b523ed64c6abdb4aae4b8b')
+    #
+    # @param [Integer] project The ID of a project.
+    # @param [String] sha The commit hash.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def commit_merge_requests(project, commit, options = {})
+      get("/projects/#{url_encode project}/repository/commits/#{commit}/merge_requests", query: options)
+    end
+    alias repo_commit_merge_requests commit_merge_requests
   end
-  alias repo_commit_merge_requests commit_merge_requests
 end