123456789_123456789_123456789_123456789_123456789_

Class: RSpec::Rails::Matchers::RoutingMatchers::RouteToMatcher Private

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

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::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

#&

Alias for Matchers::Composable#and.
#===

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.
#|

Alias for Matchers::Composable#or.
#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

#description

[ GitHub ] 

  


# File 'rspec-rails/lib/rspec/rails/matchers/routing_matchers.rb', line 43



def description
  "route #{@actual.inspect} to #{@expected.inspect}"
end


  








  

    #failure_message  
  

  [ GitHub ]


  

  


# File 'rspec-rails/lib/rspec/rails/matchers/routing_matchers.rb', line 35



def failure_message
  rescued_exception.message
end


  








  

    #failure_message_when_negated  
  

  [ GitHub ]


  

  


# File 'rspec-rails/lib/rspec/rails/matchers/routing_matchers.rb', line 39



def failure_message_when_negated
  "expected #{@actual.inspect} not to route to #{@expected.inspect}"
end


  








  

    #matches?(verb_to_path_map)  ⇒ Boolean 
  



  

    
  





  


  [ GitHub ]


  

  


# File 'rspec-rails/lib/rspec/rails/matchers/routing_matchers.rb', line 21



def matches?(verb_to_path_map)
  @actual = verb_to_path_map
  # assert_recognizes does not consider ActionController::RoutingError an
  # assertion failure, so we have to capture that and Assertion here.
  match_unless_raises ActiveSupport::TestCase::Assertion, ActionController::RoutingError do
    path, query = *verb_to_path_map.values.first.split('?')
    @scope.assert_recognizes(
      @expected,
      { method: verb_to_path_map.keys.first, path: path },
      Rack::Utils.parse_nested_query(query)
    )
  end
end