123456789_123456789_123456789_123456789_123456789_

Class: RSpec::Rails::Matchers::HaveHttpStatus::NumericCode Private

Do not use. This class is for internal use only.

Overview

Provides an implementation for RSpec::Rails::Matchers#have_http_status matching against numeric http status codes.

Not intended to be instantiated directly.

Examples:

expect(response).to have_http_status(404)

See Also:

Constant Summary

::RSpec::Rails::Matchers::BaseMatcher - Inherited

UNDEFINED

Class Method Summary

::RSpec::Rails::Matchers::BaseMatcher - Inherited

.matcher_name, .new,
.underscore

Borrowed from ActiveSupport.

Instance Attribute Summary

::RSpec::Rails::Matchers::BaseMatcher - Inherited

#actual,
#diffable?

::RSpec::Rails::Matchers are not diffable by default.

#expected, #expects_call_stack_jump?, #matcher_name, #matcher_name=, #rescued_exception,
#supports_block_expectations?

Most matchers are value matchers (i.e. meant to work with ‘expect(value)`) rather than block matchers (i.e. meant to work with `expect { }`), so this defaults to false.

Instance Method Summary

::RSpec::Rails::Matchers::HaveHttpStatus - Included

#invalid_response_type_message,
#as_test_response

Conversion function to coerce the provided object into an ActionDispatch::TestResponse.

::RSpec::Rails::Matchers::BaseMatcher - Inherited

#actual_formatted,
#description

Generates a description using ::RSpec::Matchers::EnglishPhrasing.

#expected_formatted,
#match_unless_raises

Used to wrap a block of code that will indicate failure by raising one of the named exceptions.

#matches?

Indicates if the match is successful.

#assert_ivars, #present_ivars

::RSpec::Rails::Matchers::BaseMatcher::DefaultFailureMessages - Included

#failure_message

Provides a good generic failure message.

#failure_message_when_negated

Provides a good generic negative failure message.

::RSpec::Rails::Matchers::BaseMatcher::HashFormatting - Included

#improve_hash_formatting

‘{ :a => 5, :b => 2 }.inspect` produces:

::RSpec::Matchers::Composable - Included

#&
#===

Delegates to #matches?.

#and

Creates a compound and expectation.

#description_of

Returns the description of the given object in a way that is aware of composed matchers.

#or

Creates a compound or expectation.

#values_match?

This provides a generic way to fuzzy-match an expected value against an actual value.

#|
#should_enumerate?

We should enumerate arrays as long as they are not recursive.

#surface_descriptions_in

Transforms the given data structure (typically a hash or array) into a new data structure that, when #inspect is called on it, will provide descriptions of any contained matchers rather than the normal #inspect output.

#unreadable_io?,
#with_matchers_cloned

Historically, a single matcher instance was only checked against a single value.

Instance Method Details

#descriptionString

[ GitHub ]

  
# File 'rspec-rails/lib/rspec/rails/matchers/have_http_status.rb', line 98

def description
  "respond with numeric status code #{expected}"
end

#failure_messageString

Returns:

  • (String)

    explaining why the match failed

[ GitHub ]

  
# File 'rspec-rails/lib/rspec/rails/matchers/have_http_status.rb', line 103

def failure_message
  invalid_response_type_message ||
  "expected the response to have status code #{expected.inspect}" \
    " but it was #{actual.inspect}"
end

#failure_message_when_negatedString

Returns:

  • (String)

    explaining why the match failed

[ GitHub ]

  
# File 'rspec-rails/lib/rspec/rails/matchers/have_http_status.rb', line 110

def failure_message_when_negated
  invalid_response_type_message ||
  "expected the response not to have status code " \
  "#{expected.inspect} but it did"
end

#matches?(response) ⇒ Boolean

Parameters:

  • response (Object)

    object providing an http code to match

Returns:

  • (Boolean)

    true if the numeric code matched the response code

[ GitHub ]

  
# File 'rspec-rails/lib/rspec/rails/matchers/have_http_status.rb', line 88

def matches?(response)
  test_response = as_test_response(response)
  @actual = test_response.response_code.to_i
  expected == @actual
rescue TypeError => _ignored
  @invalid_response = response
  false
end