Module | ActionController::Assertions::RoutingAssertions |
In: |
vendor/rails/actionpack/lib/action_controller/assertions/routing_assertions.rb
|
Asserts that the provided options can be used to generate the provided path.
# 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})
# 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
# 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