Prepares and returns a request suitable for dispatching with dispatch_request. If you don’t need to modify the request object before dispatching (e.g. to add cookies), you probably want to use dispatch_to instead.
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request), including :req or :post_body for setting the request body itself. |
req = build_request(:id => 1) req.cookies['app_cookie'] = "testing" dispatch_request(req, MyController, :edit)
Does not use routes.
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 217 def build_request(params = {}, env = {}) params = Merb::Parse.params_to_query_string(params) query_string = env[:query_string] || env['QUERY_STRING'] env[:query_string] = query_string ? "#{query_string}&#{params}" : params post_body = env[:post_body] || env['POST_BODY'] fake_request(env, { :post_body => post_body, :req => env[:req] }) end
Checks to see that a request is routable.
request<Merb::Test::RequestHelper::FakeRequest, Merb::Request> |
The request object to inspect. |
No matching route was found. |
The parameters built based on the matching route. |
:api: plugin @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 395 def check_request_for_route(request) match = ::Merb::Router.match(request) if match[0].nil? && match[1].empty? raise ::Merb::ControllerExceptions::BadRequest, "No routes match the request. Request uri: #{request.uri}" else match[1] end end
An HTTP DELETE request that operates through the router
path<String> |
The path that should go to the router as the request uri. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request). |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 301 def delete(path, params = {}, env = {}, &block) env[:request_method] = "DELETE" mock_request(path, params, env, &block) end
# File lib/merb-core/test/helpers/request_helper.rb, line 76 def describe_input(input) if input.respond_to?(:controller_name) "#{input.controller_name}##{input.action_name}" elsif input.respond_to?(:original_env) describe_request(input) else input end end
# File lib/merb-core/test/helpers/request_helper.rb, line 72 def describe_request(rack) "a #{rack.original_env[:method] || rack.original_env["REQUEST_METHOD"] || "GET"} to '#{rack.url}'" end
The workhorse for the dispatch*to helpers.
request<Merb::Test::RequestHelper::FakeRequest, Merb::Request> |
A request object that has been setup for testing. |
controller_klass<Merb::Controller> |
The class object off the controller to dispatch the action to. |
action<Symbol> |
The action to dispatch the request to. |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
An instance of controller_klass based on the parameters.
Does not use routes.
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 369 def dispatch_request(request, controller_klass, action, &blk) controller = controller_klass.new(request) yield controller if block_given? controller._dispatch(action) Merb.logger.info controller._benchmarks.inspect Merb.logger.flush controller end
Dispatches an action to the given class. This bypasses the router and is suitable for unit testing of controllers.
controller_klass<Controller> |
The controller class object that the action should be dispatched to. |
action<Symbol> |
The action name, as a symbol. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request), including :req or :post_body for setting the request body itself. |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
dispatch_to(MyController, :create, :name => 'Homer' ) do |controller| controller.stub!(:current_user).and_return(@user) end
Does not use routes.
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 121 def dispatch_to(controller_klass, action, params = {}, env = {}, &blk) params = merge_controller_and_action(controller_klass, action, params) dispatch_request(build_request(params, env), controller_klass, action.to_s, &blk) end
Dispatches an action to the given class and using HTTP Basic Authentication This bypasses the router and is suitable for unit testing of controllers.
controller_klass<Controller> |
The controller class object that the action should be dispatched to. |
action<Symbol> |
The action name, as a symbol. |
username<String> |
The username. |
password<String> |
The password. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request), including :req or :post_body for setting the request body itself. |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
dispatch_with_basic_authentication_to(MyController, :create, 'Fred', 'secret', :name => 'Homer' ) do |controller| controller.stub!(:current_user).and_return(@user) end
Does not use routes.
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 179 def dispatch_with_basic_authentication_to(controller_klass, action, username, password, params = {}, env = {}, &blk) env["X_HTTP_AUTHORIZATION"] = "Basic #{Base64.encode64("#{username}:#{password}")}" params = merge_controller_and_action(controller_klass, action, params) dispatch_request(build_request(params, env), controller_klass, action.to_s, &blk) end
env<Hash> |
A hash of environment keys to be merged into the default list. |
opt<Hash> |
A hash of options (see below). |
:post_body<String> |
The post body for the request. |
:req<String> |
The request string. This will only be used if :post_body is left out. |
A Request object that is built based on the parameters. |
If you pass a post body, the content-type will be set to URL-encoded.
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 84 def fake_request(env = {}, opt = {}) if opt[:post_body] req = opt[:post_body] env[:content_type] ||= "application/x-www-form-urlencoded" else req = opt[:req] end FakeRequest.new(env, StringIO.new(req || '')) end
An HTTP GET request that operates through the router.
path<String> |
The path that should go to the router as the request uri. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request). |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 242 def get(path, params = {}, env = {}, &block) env[:request_method] = "GET" mock_request(path, params, env, &block) end
:api: private
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 187 def merge_controller_and_action(controller_klass, action, params) params[:controller] = controller_klass.name.to_const_path params[:action] = action.to_s params end
A generic request that checks the router for the controller and action. This request goes through the Merb::Router and finishes at the controller.
path<String> |
The path that should go to the router as the request uri. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request). |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
request(path, { :name => 'Homer' }, { :request_method => "PUT" }) do |controller| controller.stub!(:current_user).and_return(@user) end
Uses Routes.
:api: plugin @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 330 def mock_request(path, params = {}, env= {}, &block) env[:request_method] ||= "GET" env[:request_uri], env[:query_string] = path.split('?') multipart = env.delete(:test_with_multipart) request = build_request(params, env) opts = check_request_for_route(request) # Check that the request will be routed correctly controller_name = (opts[:namespace] ? opts.delete(:namespace) + '/' : '') + opts.delete(:controller) klass = Object.full_const_get(controller_name.snake_case.to_const_string) action = opts.delete(:action).to_s params.merge!(opts) multipart.nil? ? dispatch_to(klass, action, params, env, &block) : dispatch_multipart_to(klass, action, params, env, &block) end
An HTTP POST request that operates through the router.
path<String> |
The path that should go to the router as the request uri. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request). |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
:api: public @deprecated
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 262 def post(path, params = {}, env = {}, &block) env[:request_method] = "POST" mock_request(path, params, env, &block) end
An HTTP PUT request that operates through the router.
path<String> |
The path that should go to the router as the request uri. |
params<Hash> |
An optional hash that will end up as params in the controller instance. |
env<Hash> |
An optional hash that is passed to the fake request. Any request options should go here (see fake_request). |
&blk |
The controller is yielded to the block provided for actions prior to the action being dispatched. |
:api: public
# File lib/merb-core/test/helpers/mock_request_helper.rb, line 281 def put(path, params = {}, env = {}, &block) env[:request_method] = "PUT" mock_request(path, params, env, &block) end
# File lib/merb-core/test/helpers/request_helper.rb, line 90 def requesting(*args) request(*args) end
Generated with the Darkfish Rdoc Generator 2.