class Octokit::Error

Custom error class for rescuing from all GitHub errors

Attributes

context[R]

Public Class Methods

error_for_401(headers) click to toggle source

Returns most appropriate error for 401 HTTP status code @private rubocop:disable Naming/VariableNumber

# File lib/octokit/error.rb, line 65
def self.error_for_401(headers)
  # rubocop:enbale Naming/VariableNumber
  if Octokit::OneTimePasswordRequired.required_header(headers)
    Octokit::OneTimePasswordRequired
  else
    Octokit::Unauthorized
  end
end
error_for_403(body) click to toggle source

Returns most appropriate error for 403 HTTP status code @private

# File lib/octokit/error.rb, line 76
def self.error_for_403(body)
  # rubocop:enable Naming/VariableNumber
  case body
  when /rate limit exceeded/i, /exceeded a secondary rate limit/i
    Octokit::TooManyRequests
  when /login attempts exceeded/i
    Octokit::TooManyLoginAttempts
  when /(returns|for) blobs (up to|between) [0-9-]+ MB/i
    Octokit::TooLargeContent
  when /abuse/i
    Octokit::AbuseDetected
  when /repository access blocked/i
    Octokit::RepositoryUnavailable
  when /email address must be verified/i
    Octokit::UnverifiedEmail
  when /account was suspended/i
    Octokit::AccountSuspended
  when /billing issue/i
    Octokit::BillingIssue
  when /Resource protected by organization SAML enforcement/i
    Octokit::SAMLProtected
  when /suspended your access|This installation has been suspended/i
    Octokit::InstallationSuspended
  else
    Octokit::Forbidden
  end
end
error_for_404(body) click to toggle source

Return most appropriate error for 404 HTTP status code @private rubocop:disable Naming/VariableNumber

# File lib/octokit/error.rb, line 107
def self.error_for_404(body)
  # rubocop:enable Naming/VariableNumber
  if body =~ /Branch not protected/i
    Octokit::BranchNotProtected
  else
    Octokit::NotFound
  end
end
error_for_422(body) click to toggle source

Return most appropriate error for 422 HTTP status code @private rubocop:disable Naming/VariableNumber

# File lib/octokit/error.rb, line 119
def self.error_for_422(body)
  # rubocop:enable Naming/VariableNumber
  if body =~ /PullRequestReviewComment/i && body =~ /(commit_id|end_commit_oid) is not part of the pull request/i
    Octokit::CommitIsNotPartOfPullRequest
  elsif body =~ /Path diff too large/i
    Octokit::PathDiffTooLarge
  else
    Octokit::UnprocessableEntity
  end
end
from_response(response) click to toggle source

Returns the appropriate Octokit::Error subclass based on status and response message

@param [Hash] response HTTP response @return [Octokit::Error] rubocop:disable Metrics/CyclomaticComplexity

# File lib/octokit/error.rb, line 14
def self.from_response(response)
  status  = response[:status].to_i
  body    = response[:body].to_s
  headers = response[:response_headers]

  if klass =  case status
              when 400      then Octokit::BadRequest
              when 401      then error_for_401(headers)
              when 403      then error_for_403(body)
              when 404      then error_for_404(body)
              when 405      then Octokit::MethodNotAllowed
              when 406      then Octokit::NotAcceptable
              when 409      then Octokit::Conflict
              when 410      then Octokit::Deprecated
              when 415      then Octokit::UnsupportedMediaType
              when 422      then error_for_422(body)
              when 451      then Octokit::UnavailableForLegalReasons
              when 400..499 then Octokit::ClientError
              when 500      then Octokit::InternalServerError
              when 501      then Octokit::NotImplemented
              when 502      then Octokit::BadGateway
              when 503      then Octokit::ServiceUnavailable
              when 500..599 then Octokit::ServerError
              end
    klass.new(response)
  end
end
new(response = nil) click to toggle source
Calls superclass method
# File lib/octokit/error.rb, line 49
def initialize(response = nil)
  @response = response
  super(build_error_message)
  build_error_context
end

Public Instance Methods

build_error_context() click to toggle source

rubocop:enable Metrics/CyclomaticComplexity

# File lib/octokit/error.rb, line 43
def build_error_context
  if RATE_LIMITED_ERRORS.include?(self.class)
    @context = Octokit::RateLimit.from_response(@response)
  end
end
documentation_url() click to toggle source

Documentation URL returned by the API for some errors

@return [String]

# File lib/octokit/error.rb, line 58
def documentation_url
  data[:documentation_url] if data.is_a? Hash
end
errors() click to toggle source

Array of validation errors @return [Array<Hash>] Error info

# File lib/octokit/error.rb, line 132
def errors
  if data.is_a?(Hash)
    data[:errors] || []
  else
    []
  end
end
response_body() click to toggle source

Body returned by the GitHub server.

@return [String]

# File lib/octokit/error.rb, line 157
def response_body
  @response[:body]
end
response_headers() click to toggle source

Headers returned by the GitHub server.

@return [Hash]

# File lib/octokit/error.rb, line 150
def response_headers
  @response[:response_headers]
end
response_status() click to toggle source

Status code returned by the GitHub server.

@return [Integer]

# File lib/octokit/error.rb, line 143
def response_status
  @response[:status]
end

Private Instance Methods

build_error_message() click to toggle source
# File lib/octokit/error.rb, line 205
def build_error_message
  return nil if @response.nil?

  message = +"#{@response[:method].to_s.upcase} "
  message << "#{redact_url(@response[:url].to_s.dup)}: "
  message << "#{@response[:status]} - "
  message << response_message.to_s unless response_message.nil?
  message << response_error.to_s unless response_error.nil?
  message << response_error_summary.to_s unless response_error_summary.nil?
  message << " // See: #{documentation_url}" unless documentation_url.nil?
  message
end
data() click to toggle source
# File lib/octokit/error.rb, line 163
def data
  @data ||=
    if (body = @response[:body]) && !body.empty?
      if body.is_a?(String) &&
         @response[:response_headers] &&
         @response[:response_headers][:content_type] =~ /json/

        Sawyer::Agent.serializer.decode(body)
      else
        body
      end
    end
end
redact_url(url_string) click to toggle source
# File lib/octokit/error.rb, line 218
def redact_url(url_string)
  %w[client_secret access_token api_key].each do |token|
    if url_string.include? token
      url_string.gsub!(/#{token}=\S+/, "#{token}=(redacted)")
    end
  end
  url_string
end
response_error() click to toggle source
# File lib/octokit/error.rb, line 186
def response_error
  "Error: #{data[:error]}" if data.is_a?(Hash) && data[:error]
end
response_error_summary() click to toggle source
# File lib/octokit/error.rb, line 190
def response_error_summary
  return nil unless data.is_a?(Hash) && !Array(data[:errors]).empty?

  summary = +"\nError summary:\n"
  summary << data[:errors].map do |error|
    if error.is_a? Hash
      error.map { |k, v| "  #{k}: #{v}" }
    else
      "  #{error}"
    end
  end.join("\n")

  summary
end
response_message() click to toggle source
# File lib/octokit/error.rb, line 177
def response_message
  case data
  when Hash
    data[:message]
  when String
    data
  end
end