module ActionDispatch::Assertions::RoutingAssertions
def assert_generates(expected_path, options, defaults={}, extras = {}, message=nil)
# Asserts that the generated route gives us our custom route
assert_generates "/items/list/1", { :controller => "items", :action => "list", :id => "1" }
# Tests the generation of a route with a parameter
assert_generates "/items/list", :controller => "items", :action => "list"
# Tests that the list action is properly routed
assert_generates "/items", :controller => "items", :action => "index"
# Asserts that the default action is generated for a route with no action
==== Examples
The +defaults+ parameter is unused.
a query string. The +message+ parameter allows you to specify a custom error message for assertion failures.
The +extras+ parameter is used to tell the request the names and values of additional request parameters that would be in
Asserts that the provided options can be used to generate the provided path. This is the inverse of +assert_recognizes+.
def assert_generates(expected_path, options, defaults={}, extras = {}, message=nil) if expected_path =~ %r{://} begin uri = URI.parse(expected_path) expected_path = uri.path.to_s.empty? ? "/" : uri.path rescue URI::InvalidURIError => e raise ActionController::RoutingError, e.message end else expected_path = "/#{expected_path}" unless expected_path.first == '/' end # Load routes.rb if it hasn't been loaded. generated_path, extra_keys = @routes.generate_extras(options, defaults) found_extras = options.reject {|k, v| ! extra_keys.include? k} msg = build_message(message, "found extras <?>, not <?>", found_extras, extras) assert_equal(extras, found_extras, msg) msg = build_message(message, "The generated path <?> did not match <?>", generated_path, expected_path) assert_equal(expected_path, generated_path, msg) end
def assert_recognizes(expected_options, path, extras={}, message=nil)
# Test a custom route
assert_recognizes({:controller => 'items', :action => 'destroy', :id => '1'}, 'items/destroy/1')
# Test an action with a parameter
assert_recognizes({:controller => 'items', :action => 'list'}, 'items/list')
# Test a specific action
assert_recognizes({:controller => 'items', :action => 'index'}, 'items')
# Check the default route (i.e., the index action)
==== Examples
The +message+ parameter allows you to pass in an error message that is displayed upon failure.
assert_recognizes({:controller => 'items', :action => 'list', :id => '1', :view => 'print'}, 'items/list/1', { :view => "print" })
# assert that a path of '/items/list/1?view=print' returns the correct options
extras argument, appending the query string on the path directly will not work. For example:
to assert that values in the query string string will end up in the params hash correctly. To test query strings you must use the
You can also pass in +extras+ with a hash containing URL parameters that would normally be in the query string. This can be used
assert_recognizes({:controller => 'items', :action => 'create'}, {:path => 'items', :method => :post})
# assert that POSTing to /items will call the create action on ItemsController
and a :method containing the required HTTP verb.
requiring a specific HTTP method. The hash should contain a :path with the incoming request path
Pass a hash in the second argument (+path+) to specify the request method. This is useful for routes
match +path+. Basically, it asserts that \Rails recognizes the route given by +expected_options+.
Asserts that the routing of the given +path+ was handled correctly and that the parsed options (given in the +expected_options+ hash)
def assert_recognizes(expected_options, path, extras={}, message=nil) request = recognized_request_for(path) expected_options = expected_options.clone extras.each_key { |key| expected_options.delete key } unless extras.nil? expected_options.stringify_keys! msg = build_message(message, "The recognized options <?> did not match <?>, difference: <?>", request.path_parameters, expected_options, expected_options.diff(request.path_parameters)) assert_equal(expected_options, request.path_parameters, msg) end
def assert_routing(path, options, defaults={}, extras={}, message=nil)
# Tests a route with a HTTP method
assert_routing 'controller/action/9', {:id => "9", :item => "square"}, {:controller => "controller", :action => "action"}, {}, {:item => "square"}
# Tests a route, providing a defaults hash
assert_routing '/store', { :controller => 'store', :action => 'index' }, {}, {}, 'Route for store index not generated properly'
# Assert a basic route (controller + default action), with an error message if it fails
assert_routing '/entries/show/23', :controller => 'entries', :action => 'show', :id => 23
# Test a route generated with a specific controller, action, and parameter (id)
assert_routing '/home', :controller => 'home', :action => 'index'
# Assert a basic route: a controller with the default action (index)
==== Examples
+message+ parameter allows you to specify a custom error message to display upon failure.
The +extras+ hash allows you to specify options that would normally be provided as a query string to the action. The
and +assert_generates+ into one step.
options and then that options generates path. This essentially combines +assert_recognizes+
Asserts that path and options match both ways; in other words, it verifies that path generates
def assert_routing(path, options, defaults={}, extras={}, message=nil) assert_recognizes(options, path, extras, message) controller, default_controller = options[:controller], defaults[:controller] if controller && controller.include?(?/) && default_controller && default_controller.include?(?/) options[:controller] = "/#{controller}" end generate_options = options.dup.delete_if{ |k,v| defaults.key?(k) } assert_generates(path.is_a?(Hash) ? path[:path] : path, generate_options, defaults, extras, message) end
def method_missing(selector, *args, &block)
def method_missing(selector, *args, &block) if defined?(@controller) && @controller && @routes && @routes.named_routes.helpers.include?(selector) @controller.send(selector, *args, &block) else super end end
def recognized_request_for(path)
def recognized_request_for(path) if path.is_a?(Hash) method = path[:method] path = path[:path] else method = :get end # Assume given controller request = ActionController::TestRequest.new if path =~ %r{://} begin uri = URI.parse(path) request.env["rack.url_scheme"] = uri.scheme || "http" request.host = uri.host if uri.host request.port = uri.port if uri.port request.path = uri.path.to_s.empty? ? "/" : uri.path rescue URI::InvalidURIError => e raise ActionController::RoutingError, e.message end else path = "/#{path}" unless path.first == "/" request.path = path end request.request_method = method if method params = @routes.recognize_path(path, { :method => method }) request.path_parameters = params.with_indifferent_access request end
def with_routing
end
end
end
map.generate(:controller => 'content', :id => 10, :action => 'show')
['/content/10/show', {}],
assert_equal(
map.connect ':controller/:action/:id'
set.draw do |map|
with_routing do |set|
will create some routes using map.draw { map.connect ... }:
The new instance is yielded to the passed block. Typically the block
with a new RouteSet instance.
This method temporarily replaces @routes
A helper to make it easier to test different route configurations.
def with_routing old_routes, @routes = @routes, ActionDispatch::Routing::RouteSet.new if defined?(@controller) && @controller old_controller, @controller = @controller, @controller.clone _routes = @routes # Unfortunately, there is currently an abstraction leak between AC::Base # and AV::Base which requires having the URL helpers in both AC and AV. # To do this safely at runtime for tests, we need to bump up the helper serial # to that the old AV subclass isn't cached. # # TODO: Make this unnecessary @controller.singleton_class.send(:include, _routes.url_helpers) @controller.view_context_class = Class.new(@controller.view_context_class) do include _routes.url_helpers end end yield @routes ensure @routes = old_routes if defined?(@controller) && @controller @controller = old_controller end end