Module ActionController::Assertions::RoutingAssertions
In: vendor/rails/actionpack/lib/action_controller/assertions/routing_assertions.rb

Methods

Public Instance methods

Asserts that the provided options can be used to generate the provided path.

[Source]

    # File vendor/rails/actionpack/lib/action_controller/assertions/routing_assertions.rb, line 37
37:       def assert_generates(expected_path, options, defaults={}, extras = {}, message=nil)
38:         clean_backtrace do 
39:           expected_path = "/#{expected_path}" unless expected_path[0] == ?/
40:           # Load routes.rb if it hasn't been loaded.
41:           ActionController::Routing::Routes.reload if ActionController::Routing::Routes.empty? 
42:       
43:           generated_path, extra_keys = ActionController::Routing::Routes.generate_extras(options, extras)
44:           found_extras = options.reject {|k, v| ! extra_keys.include? k}
45: 
46:           msg = build_message(message, "found extras <?>, not <?>", found_extras, extras)
47:           assert_block(msg) { found_extras == extras }
48:       
49:           msg = build_message(message, "The generated path <?> did not match <?>", generated_path, 
50:               expected_path)
51:           assert_block(msg) { expected_path == generated_path }
52:         end
53:       end

Asserts that the routing of the given path was handled correctly and that the parsed options match.

  assert_recognizes({:controller => 'items', :action => 'index'}, 'items')

Pass a hash in the second argument to specify the request method. This is useful for routes requiring a specific method.

  assert_recognizes({:controller => 'items', :action => 'create'}, {:path => 'items', :method => :post})

[Source]

    # File vendor/rails/actionpack/lib/action_controller/assertions/routing_assertions.rb, line 13
13:       def assert_recognizes(expected_options, path, extras={}, message=nil)
14:         if path.is_a? Hash
15:           request_method = path[:method]
16:           path           = path[:path]
17:         else
18:           request_method = nil
19:         end
20: 
21:         clean_backtrace do 
22:           ActionController::Routing::Routes.reload if ActionController::Routing::Routes.empty? 
23:           request = recognized_request_for(path, request_method)
24:       
25:           expected_options = expected_options.clone
26:           extras.each_key { |key| expected_options.delete key } unless extras.nil?
27:       
28:           expected_options.stringify_keys!
29:           routing_diff = expected_options.diff(request.path_parameters)
30:           msg = build_message(message, "The recognized options <?> did not match <?>, difference: <?>", 
31:               request.path_parameters, expected_options, expected_options.diff(request.path_parameters))
32:           assert_block(msg) { request.path_parameters == expected_options }
33:         end
34:       end

Asserts that path and options match both ways; in other words, the URL generated from options is the same as path, and also that the options recognized from path are the same as options

[Source]

    # File vendor/rails/actionpack/lib/action_controller/assertions/routing_assertions.rb, line 57
57:       def assert_routing(path, options, defaults={}, extras={}, message=nil)
58:         assert_recognizes(options, path, extras, message)
59:         
60:         controller, default_controller = options[:controller], defaults[:controller] 
61:         if controller && controller.include?(?/) && default_controller && default_controller.include?(?/)
62:           options[:controller] = "/#{controller}"
63:         end
64:          
65:         assert_generates(path, options, defaults, extras, message)
66:       end

[Validate]