require 'mime/types' module API # Project commit statuses API class CommitStatuses < Grape::API resource :projects do before { authenticate! } # Get a commit's statuses # # Parameters: # id (required) - The ID of a project # sha (required) - The commit hash # ref (optional) - The ref # stage (optional) - The stage # name (optional) - The name # all (optional) - Show all statuses, default: false # Examples: # GET /projects/:id/repository/commits/:sha/statuses get ':id/repository/commits/:sha/statuses' do authorize!(:read_commit_status, user_project) not_found!('Commit') unless user_project.commit(params[:sha]) ci_commits = user_project.ci_commits.where(sha: params[:sha]) statuses = ::CommitStatus.where(commit: ci_commits) statuses = statuses.latest unless parse_boolean(params[:all]) statuses = statuses.where(ref: params[:ref]) if params[:ref].present? statuses = statuses.where(stage: params[:stage]) if params[:stage].present? statuses = statuses.where(name: params[:name]) if params[:name].present? present paginate(statuses), with: Entities::CommitStatus end # Post status to commit # # Parameters: # id (required) - The ID of a project # sha (required) - The commit hash # ref (optional) - The ref # state (required) - The state of the status. Can be: pending, running, success, error or failure # target_url (optional) - The target URL to associate with this status # description (optional) - A short description of the status # name or context (optional) - A string label to differentiate this status from the status of other systems. Default: "default" # Examples: # POST /projects/:id/statuses/:sha post ':id/statuses/:sha' do authorize! :create_commit_status, user_project required_attributes! [:state] attrs = attributes_for_keys [:ref, :target_url, :description, :context, :name] commit = @project.commit(params[:sha]) not_found! 'Commit' unless commit # Since the CommitStatus is attached to Ci::Commit (in the future Pipeline) # We need to always have the pipeline object # To have a valid pipeline object that can be attached to specific MR # Other CI service needs to send `ref` # If we don't receive it, we will attach the CommitStatus to # the first found branch on that commit ref = params[:ref] unless ref branches = @project.repository.branch_names_contains(commit.sha) not_found! 'References for commit' if branches.none? ref = branches.first end ci_commit = @project.ensure_ci_commit(commit.sha, ref) name = params[:name] || params[:context] status = GenericCommitStatus.running_or_pending.find_by(commit: ci_commit, name: name, ref: params[:ref]) status ||= GenericCommitStatus.new(project: @project, commit: ci_commit, user: current_user) status.update(attrs) case params[:state].to_s when 'running' status.run when 'success' status.success when 'failed' status.drop when 'canceled' status.cancel else status.status = params[:state].to_s end if status.save present status, with: Entities::CommitStatus else render_validation_error!(status) end end end end end