gitlab-faraday 5.1.0

data/lib/gitlab/client/issues.rb

@@ -0,0 +1,242 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to issues.
+  # @see https://docs.gitlab.com/ce/api/issues.html
+  module Issues
+    # Gets a list of user's issues.
+    # Will return a list of project's issues if project ID passed.
+    #
+    # @example
+    #   Gitlab.issues
+    #   Gitlab.issues(5)
+    #   Gitlab.issues({ per_page: 40 })
+    #
+    # @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 issues(project = nil, options = {})
+      if project.to_s.empty? && project.to_i.zero?
+        get('/issues', query: options)
+      else
+        get("/projects/#{url_encode project}/issues", query: options)
+      end
+    end
+
+    # Gets a single issue.
+    #
+    # @example
+    #   Gitlab.issue(5, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash]
+    def issue(project, id)
+      get("/projects/#{url_encode project}/issues/#{id}")
+    end
+
+    # Creates a new issue.
+    #
+    # @example
+    #   Gitlab.create_issue(5, 'New issue')
+    #   Gitlab.create_issue(5, 'New issue', { description: 'This is a new issue', assignee_id: 42 })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] title The title of an issue.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description The description of an issue.
+    # @option options [Integer] :assignee_id The ID of a user to assign issue.
+    # @option options [Integer] :milestone_id The ID of a milestone to assign issue.
+    # @option options [String] :labels Comma-separated label names for an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about created issue.
+    def create_issue(project, title, options = {})
+      body = { title: title }.merge(options)
+      post("/projects/#{url_encode project}/issues", body: body)
+    end
+
+    # Updates an issue.
+    #
+    # @example
+    #   Gitlab.edit_issue(6, 1, { title: 'Updated title' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :title The title of an issue.
+    # @option options [String] :description The description of an issue.
+    # @option options [Integer] :assignee_id The ID of a user to assign issue.
+    # @option options [Integer] :milestone_id The ID of a milestone to assign issue.
+    # @option options [String] :labels Comma-separated label names for an issue.
+    # @option options [String] :state_event The state event of an issue ('close' or 'reopen').
+    # @return [Gitlab::ObjectifiedHash] Information about updated issue.
+    def edit_issue(project, id, options = {})
+      put("/projects/#{url_encode project}/issues/#{id}", body: options)
+    end
+
+    # Closes an issue.
+    #
+    # @example
+    #   Gitlab.close_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about closed issue.
+    def close_issue(project, id)
+      put("/projects/#{url_encode project}/issues/#{id}", body: { state_event: 'close' })
+    end
+
+    # Reopens an issue.
+    #
+    # @example
+    #   Gitlab.reopen_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about reopened issue.
+    def reopen_issue(project, id)
+      put("/projects/#{url_encode project}/issues/#{id}", body: { state_event: 'reopen' })
+    end
+
+    # Subscribe to an issue.
+    #
+    # @example
+    #   Gitlab.subscribe_to_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about subscribed issue.
+    def subscribe_to_issue(project, id)
+      post("/projects/#{url_encode project}/issues/#{id}/subscribe")
+    end
+
+    # Unsubscribe from an issue.
+    #
+    # @example
+    #   Gitlab.unsubscribe_from_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about unsubscribed issue.
+    def unsubscribe_from_issue(project, id)
+      post("/projects/#{url_encode project}/issues/#{id}/unsubscribe")
+    end
+
+    # Deletes  an issue.
+    # Only for admins and project owners
+    #
+    # @example
+    #   Gitlab.delete_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted issue.
+    def delete_issue(project, id)
+      delete("/projects/#{url_encode project}/issues/#{id}")
+    end
+
+    # Move an issue.
+    #
+    # @example
+    #   Gitlab.move_issue(3, 42, { to_project_id: '4' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @option options [String] :to_project_id The ID of the new project.
+    # @return [Gitlab::ObjectifiedHash] Information about moved issue.
+    def move_issue(project, id, options = {})
+      post("/projects/#{url_encode project}/issues/#{id}/move", body: options)
+    end
+
+    # Sets an estimated time of work for an issue.
+    #
+    # @example
+    #   Gitlab.estimate_time_of_issue(3, 42, '3h30m')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @param  [String] duration The duration in human format. e.g: 3h30m
+    def estimate_time_of_issue(project, id, duration)
+      post("/projects/#{url_encode project}/issues/#{id}/time_estimate", body: { duration: url_encode(duration) })
+    end
+
+    # Resets the estimated time for an issue to 0 seconds.
+    #
+    # @example
+    #   Gitlab.reset_time_estimate_of_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    def reset_time_estimate_of_issue(project, id)
+      post("/projects/#{url_encode project}/issues/#{id}/reset_time_estimate")
+    end
+
+    # Adds spent time for an issue
+    #
+    # @example
+    #   Gitlab.estimate_time_of_issue(3, 42, '3h30m')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    # @param  [String] duration The time spent in human format. e.g: 3h30m
+    def add_time_spent_on_issue(project, id, duration)
+      post("/projects/#{url_encode project}/issues/#{id}/add_spent_time", body: { duration: duration })
+    end
+
+    # Resets the total spent time for this issue to 0 seconds.
+    #
+    # @example
+    #   Gitlab.reset_time_spent_on_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    def reset_time_spent_on_issue(project, id)
+      post("/projects/#{url_encode project}/issues/#{id}/reset_spent_time")
+    end
+
+    # Get time tracking stats for an issue
+    #
+    # @example
+    #   @gitlab.time_stats_for_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    def time_stats_for_issue(project, id)
+      get("/projects/#{url_encode project}/issues/#{id}/time_stats")
+    end
+
+    # Get participants on issue
+    #
+    # @example
+    #   @gitlab.participants_on_issue(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    def participants_on_issue(project, id)
+      get("/projects/#{url_encode project}/issues/#{id}/participants")
+    end
+
+    # List merge requests that will close issue on merge
+    #
+    # @example
+    #   Gitlab.merge_requests_closing_issue_on_merge(3, 42)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [Integer] id The ID of an issue.
+    def merge_requests_closing_issue_on_merge(project, id)
+      get("/projects/#{url_encode project}/issues/#{id}/closed_by")
+    end
+
+    # List related merge requests
+    #
+    # @example
+    #   Gitlab.related_merge_requests(3, 42)
+    #
+    # @param [Integer, String] project The ID or name of a project.
+    # @param [Integer] id The ID of an issue.
+    def related_merge_requests(project, id)
+      get("/projects/#{url_encode project}/issues/#{id}/related_merge_requests")
+    end
+  end
+end

data/lib/gitlab/client/jobs.rb

@@ -0,0 +1,250 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to projects.
+  # @see https://docs.gitlab.com/ee/api/jobs.html
+  module Jobs
+    # Gets a list of Jobs for a Project
+    #
+    # @example
+    #   Gitlab.jobs(1)
+    #   Gitlab.jobs("project")
+    #   Gitlab.jobs("project", {scope: ["manual", "success"], per_page: 100 })
+    #
+    # @param  [Integer, String] id The ID or name of a project.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Array] :scope The scope of jobs to show, one or array of: created, pending, running, failed, success, canceled, skipped, manual; showing all jobs if none provided.
+    # @option options [Integer] :page The page number.
+    # @option options [Integer] :per_page The number of results per page.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def jobs(project_id, options = {})
+      get("/projects/#{url_encode project_id}/jobs", query: options)
+    end
+
+    # Gets a list of Jobs from a pipeline
+    #
+    # @example
+    #   Gitlab.pipeline_jobs(1, 2)
+    #   Gitlab.pipeline_jobs("project", 2)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the pipeline
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Array] :scope The scope of jobs to show, one or array of: created, pending, running, failed, success, canceled, skipped, manual; showing all jobs if none provided.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def pipeline_jobs(project_id, pipeline_id, options = {})
+      get("/projects/#{url_encode project_id}/pipelines/#{pipeline_id}/jobs", query: options)
+    end
+
+    # Gets a list of Bridge Jobs from a pipeline
+    #
+    # @example
+    #   Gitlab.pipeline_bridges(1, 2)
+    #   Gitlab.pipeline_bridges("project", 2)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the pipeline
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Array] :scope The scope of bridge jobs to show, one or array of: created, pending, running, failed, success, canceled, skipped, manual; showing all bridge jobs if none provided.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def pipeline_bridges(project_id, pipeline_id, options = {})
+      get("/projects/#{url_encode project_id}/pipelines/#{pipeline_id}/bridges", query: options)
+    end
+
+    # Gets a single job
+    #
+    # @example
+    #   Gitlab.job(1, 2)
+    #   Gitlab.job("project", 2)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    def job(project_id, job_id)
+      get("/projects/#{url_encode project_id}/jobs/#{job_id}")
+    end
+
+    # Gets artifacts from a job
+    #
+    # @example
+    #   Gitlab.job_artifacts(1, 2)
+    #   Gitlab.job_artifacts("project", 2)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_artifacts(project_id, job_id)
+      get("/projects/#{url_encode project_id}/jobs/#{job_id}/artifacts",
+          format: nil,
+          headers: { Accept: 'text/plain' },
+          parser: ::Gitlab::Request::Parser)
+    end
+
+    # Download Job Artifact
+    #
+    # @example
+    #   Gitlab.job_artifacts_download(1, "master", "release")
+    #   Gitlab.job_artifacts_download("project", "master", "release")
+    #
+    # @param  [Integer, String] project_id The ID or name of a project.
+    # @param  [String]  ref Ref Name
+    # @param  [String]  job jobname
+    # @return [Gitlab::FileResponse]
+    def job_artifacts_download(project_id, ref_name, job_name)
+      get("/projects/#{url_encode project_id}/jobs/artifacts/#{ref_name}/download",
+          query: { job: job_name },
+          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
+
+    # Download a single artifact file by job ID
+    #
+    # @example
+    #   Gitlab.download_job_artifact_file(1, 5, "some/release/file.pdf")
+    #
+    # @param  [Integer, String] project_id(required) The ID or name of a project.
+    # @param  [String]  job_id(required) The unique job identifier.
+    # @param  [String]  artifact_path(required) Path to a file inside the artifacts archive.
+    # @return [Gitlab::FileResponse]
+    def download_job_artifact_file(project_id, job_id, artifact_path)
+      get("/projects/#{url_encode project_id}/jobs/#{job_id}/artifacts/#{artifact_path}",
+          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
+
+    # Download a single artifact file from specific tag or branch
+    #
+    # @example
+    #   Gitlab.download_branch_artifact_file(1, "master", "some/release/file.pdf", 'pdf')
+    #
+    # @param  [Integer, String] project_id(required) The ID or name of a project.
+    # @param  [String]  ref_name(required) Branch or tag name in repository. HEAD or SHA references are not supported.
+    # @param  [String]  artifact_path(required) Path to a file inside the artifacts archive.
+    # @param  [String]  job(required) The name of the job.
+    # @return [Gitlab::FileResponse]
+    def download_branch_artifact_file(project_id, ref_name, artifact_path, job)
+      get("/projects/#{url_encode project_id}/jobs/artifacts/#{ref_name}/raw/#{artifact_path}",
+          query: { job: job },
+          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
+    alias download_tag_artifact_file download_branch_artifact_file
+
+    # Get Job Trace
+    #
+    # @example
+    #   Gitlab.job_trace(1,1)
+    #   Gitlab.job_trace("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_trace(project_id, job_id)
+      get("/projects/#{url_encode project_id}/jobs/#{job_id}/trace",
+          format: nil,
+          headers: { Accept: 'text/plain' },
+          parser: ::Gitlab::Request::Parser)
+    end
+
+    # Cancel a job
+    #
+    # @example
+    #   Gitlab.job_cancel(1,1)
+    #   Gitlab.job_cancel("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_cancel(project_id, job_id)
+      post("/projects/#{url_encode project_id}/jobs/#{job_id}/cancel")
+    end
+
+    # Retry a job
+    #
+    # @example
+    #   Gitlab.job_retry(1,1)
+    #   Gitlab.job_retry("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_retry(project_id, job_id)
+      post("/projects/#{url_encode project_id}/jobs/#{job_id}/retry")
+    end
+
+    # Erase Job
+    #
+    # @example
+    #   Gitlab.job_erase(1,1)
+    #   Gitlab.job_erase("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_erase(project_id, job_id)
+      post("/projects/#{url_encode project_id}/jobs/#{job_id}/erase")
+    end
+
+    # Play a Job
+    # Triggers a manual action to start a job.
+    #
+    # @example
+    #   Gitlab.job_play(1,1)
+    #   Gitlab.job_play("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_play(project_id, job_id)
+      post("/projects/#{url_encode project_id}/jobs/#{job_id}/play")
+    end
+
+    # Keep Artifacts
+    # Prevents artifacts from being deleted when expiration is set.
+    #
+    # @example
+    #   Gitlab.job_artifacts_keep(1,1)
+    #   Gitlab.job_artifacts_keep("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_artifacts_keep(project_id, job_id)
+      post("/projects/#{url_encode project_id}/jobs/#{job_id}/artifacts/keep")
+    end
+
+    # Delete Artifacts
+    # Deletes the artifacts associated with a job.
+    #
+    # @example
+    #   Gitlab.job_artifacts_delete(1,1)
+    #   Gitlab.job_artifacts_delete("project", 1)
+    #
+    # @param  [Integer, String] The ID or name of a project.
+    # @param  [Integer]  the id of the job
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def job_artifacts_delete(project_id, job_id)
+      delete("/projects/#{url_encode project_id}/jobs/#{job_id}/artifacts")
+    end
+  end
+end

data/lib/gitlab/client/keys.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to keys.
+  # @see https://docs.gitlab.com/ce/api/keys.html
+  module Keys
+    # Gets information about a key.
+    #
+    # @example
+    #   Gitlab.key(1)
+    #
+    # @param  [Integer] id The ID of a key.
+    # @return [Gitlab::ObjectifiedHash]
+    def key(id)
+      get("/keys/#{id}")
+    end
+
+    # Gets information about a key by key fingerprint.
+    #
+    # @example
+    #   Gitlab.key_by_fingerprint("9f:70:33:b3:50:4d:9a:a3:ef:ea:13:9b:87:0f:7f:7e")
+    #
+    # @param  [String] fingerprint The Fingerprint of a key.
+    # @return [Gitlab::ObjectifiedHash]
+    def key_by_fingerprint(fingerprint)
+      get('/keys', query: { fingerprint: fingerprint })
+    end
+  end
+end

data/lib/gitlab/client/labels.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to project labels.
+  # @see https://docs.gitlab.com/ce/api/labels.html
+  module Labels
+    # Gets a list of project's labels.
+    #
+    # @example
+    #   Gitlab.labels(5)
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @return [Array<Gitlab::ObjectifiedHash>]
+    def labels(project, options = {})
+      get("/projects/#{url_encode project}/labels", query: options)
+    end
+
+    # Creates a new label.
+    #
+    # @example
+    #   Gitlab.create_label(42, "Backlog", '#DD10AA')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of a label.
+    # @param  [String] color The color of a label.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :description The description of the label.
+    # @option options [String] :priority The priority of the label. Must be greater or equal than zero or null to remove the priority.
+    # @return [Gitlab::ObjectifiedHash] Information about created label.
+    def create_label(project, name, color, options = {})
+      post("/projects/#{url_encode project}/labels", body: options.merge(name: name, color: color))
+    end
+
+    # Updates a label.
+    #
+    # @example
+    #   Gitlab.edit_label(42, "Backlog", { new_name: 'TODO' })
+    #   Gitlab.edit_label(42, "Backlog", { new_name: 'TODO', color: '#DD10AA' })
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of a label.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [String] :new_name The new name of a label.
+    # @option options [String] :color The color of a label.
+    # @option options [String] :description The description of the label.
+    # @option options [String] :priority The priority of the label. Must be greater or equal than zero or null to remove the priority.
+    # @return [Gitlab::ObjectifiedHash] Information about updated label.
+    def edit_label(project, name, options = {})
+      put("/projects/#{url_encode project}/labels", body: options.merge(name: name))
+    end
+
+    # Deletes a label.
+    #
+    # @example
+    #   Gitlab.delete_label(2, 'Backlog')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about deleted label.
+    def delete_label(project, name)
+      delete("/projects/#{url_encode project}/labels/#{name}")
+    end
+
+    # Subscribes the user to a label to receive notifications
+    #
+    # @example
+    #   Gitlab.subscribe_to_label(2, 'Backlog')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about the label subscribed to.
+    def subscribe_to_label(project, name)
+      post("/projects/#{url_encode project}/labels/#{url_encode name}/subscribe")
+    end
+
+    # Unsubscribes the user from a label to not receive notifications from it
+    #
+    # @example
+    #   Gitlab.unsubscribe_from_label(2, 'Backlog')
+    #
+    # @param  [Integer, String] project The ID or name of a project.
+    # @param  [String] name The name of a label.
+    # @return [Gitlab::ObjectifiedHash] Information about the label unsubscribed from.
+    def unsubscribe_from_label(project, name)
+      post("/projects/#{url_encode project}/labels/#{url_encode name}/unsubscribe")
+    end
+  end
+end

data/lib/gitlab/client/lint.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to lint/validations.
+  # @see https://docs.gitlab.com/ce/api/lint.html
+  module Lint
+    # Checks if your .gitlab-ci.yml file is valid.
+    #
+    # @example
+    #   Gitlab.validate_gitlab_ci_yml("{ \"image\": \"ruby:2.6\", \"services\": [\"postgres\"], \"before_script\": [\"bundle install\", \"bundle exec rake db:create\"], \"variables\": {\"DB_NAME\": \"postgres\"}, \"types\": [\"test\", \"deploy\", \"notify\"], \"rspec\": { \"script\": \"rake spec\", \"tags\": [\"ruby\", \"postgres\"], \"only\": [\"branches\"]}}")
+    #
+    # @param  [String] content the .gitlab-ci.yaml content.
+    # @return <Gitlab::ObjectifiedHash> Returns information about validity of the yml.
+    def validate_gitlab_ci_yml(content)
+      body = { content: content }
+      post('/lint', body: body)
+    end
+  end
+end

data/lib/gitlab/client/markdown.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+class Gitlab::Client
+  # Defines methods related to markdown.
+  # @see https://docs.gitlab.com/ce/api/markdown.html
+  module Markdown
+    # Render an arbitrary Markdown document
+    #
+    # @example
+    #   Gitlab.markdown('Hello world! :tada:')
+    #   Gitlab.markdown('Hello world! :tada:', gfm: true, project: 'group_example/project_example')
+    #
+    # @param  [String] text The markdown text to render.
+    # @param  [Hash] options A customizable set of options.
+    # @option options [Boolean] :gfm(optional) Render text using GitLab Flavored Markdown. Default is false.
+    # @option options [String] :project(optional) Use project as a context when creating references using GitLab Flavored Markdown. Authentication is required if a project is not public.
+    # @return <Gitlab::ObjectifiedHash> Returns the rendered markdown as response
+    def markdown(text, options = {})
+      body = { text: text }.merge(options)
+      post('/markdown', body: body)
+    end
+  end
+end