class Octokit::Error
Custom error class for rescuing from all GitHub errors
Public Class Methods
error_for_401(headers)
click to toggle source
Returns most appropriate error for 401 HTTP status code @private
# File lib/octokit/error.rb, line 50 def self.error_for_401(headers) 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 60 def self.error_for_403(body) if body =~ /rate limit exceeded/i Octokit::TooManyRequests elsif body =~ /login attempts exceeded/i Octokit::TooManyLoginAttempts elsif body =~ /abuse/i Octokit::AbuseDetected elsif body =~ /repository access blocked/i Octokit::RepositoryUnavailable elsif body =~ /email address must be verified/i Octokit::UnverifiedEmail else Octokit::Forbidden 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]
# File lib/octokit/error.rb, line 10 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 Octokit::NotFound when 405 then Octokit::MethodNotAllowed when 406 then Octokit::NotAcceptable when 409 then Octokit::Conflict when 415 then Octokit::UnsupportedMediaType when 422 then Octokit::UnprocessableEntity 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 36 def initialize(response=nil) @response = response super(build_error_message) end
Public Instance Methods
documentation_url()
click to toggle source
Documentation URL returned by the API for some errors
@return [String]
# File lib/octokit/error.rb, line 44 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 78 def errors if data && data.is_a?(Hash) data[:errors] || [] else [] end end
Private Instance Methods
build_error_message()
click to toggle source
# File lib/octokit/error.rb, line 128 def build_error_message return nil if @response.nil? message = "#{@response[:method].to_s.upcase} " message << redact_url(@response[:url].to_s) + ": " message << "#{@response[:status]} - " message << "#{response_message}" unless response_message.nil? message << "#{response_error}" unless response_error.nil? message << "#{response_error_summary}" 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 88 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 else nil end end
redact_url(url_string)
click to toggle source
# File lib/octokit/error.rb, line 141 def redact_url(url_string) %w[client_secret access_token].each do |token| url_string.gsub!(/#{token}=\S+/, "#{token}=(redacted)") if url_string.include? token end url_string end
response_error()
click to toggle source
# File lib/octokit/error.rb, line 113 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 117 def response_error_summary return nil unless data.is_a?(Hash) && !Array(data[:errors]).empty? summary = "\nError summary:\n" summary << data[:errors].map do |hash| hash.map { |k,v| " #{k}: #{v}" } end.join("\n") summary end
response_message()
click to toggle source
# File lib/octokit/error.rb, line 104 def response_message case data when Hash data[:message] when String data end end