### Home Classes Methods

### In Files

- lib/shoulda/action_controller/macros.rb

### Methods

- #should_assign_to
- #should_filter_params
- #should_not_assign_to
- #should_not_set_the_flash
- #should_redirect_to
- #should_render_template
- #should_render_with_layout
- #should_render_without_layout
- #should_respond_with
- #should_respond_with_content_type
- #should_route
- #should_set_session
- #should_set_the_flash_to

### Included Modules

- Shoulda::ActionController::Matchers

### Files

- CONTRIBUTION_GUIDELINES.rdoc
- README.rdoc

### Class/Module Index

Quicksearch

- Shoulda
- Shoulda::ActionController
- Shoulda::ActionController::Macros
- Shoulda::ActionController::Matchers
- Shoulda::ActionMailer
- Shoulda::ActionMailer::Assertions
- Shoulda::ActionMailer::Matchers
- Shoulda::ActiveRecord
- Shoulda::ActiveRecord::Assertions
- Shoulda::ActiveRecord::Helpers
- Shoulda::ActiveRecord::Macros
- Shoulda::ActiveRecord::Matchers
- Shoulda::Assertions
- Shoulda::ClassMethods
- Shoulda::Helpers
- Shoulda::InstanceMethods
- Shoulda::Macros
- ActionController
- Test

No matching classes.

# Shoulda::ActionController::Macros

# Macro test helpers for your controllers

By using the macro helpers you can quickly and easily create concise and easy to read test suites.

This code segment:

    context "on GET to :show for first record" do
      setup do
        get :show, :id => 1
      end

      should_assign_to :user
      should_respond_with :success
      should_render_template :show
      should_not_set_the_flash

      should "do something else really cool" do
        assert_equal 1, assigns(:user).id
      end
    end

Would produce 5 tests for the `show` action

### Public Instance Methods

should_assign_to(*names, &block) click to toggle source

Deprecated: use ActionController::Matchers#assign_to instead.

Macro that creates a test asserting that the controller assigned to each of the named instance variable(s).

Options:

- `:class` - The expected class of the instance variable being checked.

If a block is passed, the assigned variable is expected to be equal to the return value of that block.

Example:

    should_assign_to :user, :posts
    should_assign_to :user, :class => User
    should_assign_to(:user) { @user }

    # File lib/shoulda/action_controller/macros.rb, line 80
    def should_assign_to(*names, &block)
      ::ActiveSupport::Deprecation.warn("use: should assign_to")
      klass = get_options!(names, :class)
      names.each do |name|
        matcher = assign_to(name).with_kind_of(klass)
        matcher = matcher.with(&block) if block
        should matcher
      end
    end

should_filter_params(*keys) click to toggle source

Deprecated: use ActionController::Matchers#filter_param instead.

Macro that creates a test asserting that filter_parameter_logging is set for the specified keys

Example:

    should_filter_params :password, :ssn

    # File lib/shoulda/action_controller/macros.rb, line 57
    def should_filter_params(*keys)
      ::ActiveSupport::Deprecation.warn("use: should filter_param")
      keys.each do |key|
        should filter_param(key)
      end
    end

should_not_assign_to(*names) click to toggle source

Deprecated: use ActionController::Matchers#assign_to instead.

Macro that creates a test asserting that the controller did not assign to any of the named instance variable(s).

Example:

    should_not_assign_to :user, :posts

    # File lib/shoulda/action_controller/macros.rb, line 98
    def should_not_assign_to(*names)
      ::ActiveSupport::Deprecation.warn("use: should_not assign_to")
      names.each do |name|
        should_not assign_to(name)
      end
    end

should_not_set_the_flash() click to toggle source

Deprecated: use ActionController::Matchers#set_the_flash instead.

Macro that creates a test asserting that the flash is empty.

    # File lib/shoulda/action_controller/macros.rb, line 44
    def should_not_set_the_flash
      ::ActiveSupport::Deprecation.warn("use: should_not set_the_flash")
      should_not set_the_flash
    end

should_redirect_to(description, &block) click to toggle source

Deprecated: use ActionController::Matchers#redirect_to instead.

Macro that creates a test asserting that the controller returned a redirect to the given path. The passed description will be used when generating a test name. Expects a block that returns the expected path for the redirect.

Example:

    should_redirect_to("the user's profile") { user_url(@user) }

    # File lib/shoulda/action_controller/macros.rb, line 187
    def should_redirect_to(description, &block)
      ::ActiveSupport::Deprecation.warn("use: should redirect_to")
      should redirect_to(description, &block)
    end

should_render_template(template) click to toggle source

Deprecated: use ActionController::Matchers#render_template instead.

Macro that creates a test asserting that the controller rendered the given template. Example:

    should_render_template :new

    # File lib/shoulda/action_controller/macros.rb, line 152
    def should_render_template(template)
      ::ActiveSupport::Deprecation.warn("use: should render_template")
      should render_template(template)
    end

should_render_with_layout(expected_layout = 'application') click to toggle source

Deprecated: use ActionController::Matchers#render_with_layout instead.

Macro that creates a test asserting that the controller rendered with the given layout. Example:

    should_render_with_layout 'special'

    # File lib/shoulda/action_controller/macros.rb, line 163
    def should_render_with_layout(expected_layout = 'application')
      ::ActiveSupport::Deprecation.warn("use: should render_with_layout")
      should render_with_layout(expected_layout)
    end

should_render_without_layout() click to toggle source

Deprecated: use ActionController::Matchers#render_with_layout instead.

Macro that creates a test asserting that the controller rendered without a layout. Same as @should_render_with_layout false@

    # File lib/shoulda/action_controller/macros.rb, line 172
    def should_render_without_layout
      ::ActiveSupport::Deprecation.warn("use: should_not render_with_layout")
      should_not render_with_layout
    end

should_respond_with(response) click to toggle source

Deprecated: use ActionController::Matchers#respond_with instead.

Macro that creates a test asserting that the controller responded with a ‘response’ status code. Example:

    should_respond_with :success

    # File lib/shoulda/action_controller/macros.rb, line 111
    def should_respond_with(response)
      ::ActiveSupport::Deprecation.warn("use: should respond_with")
      should respond_with(response)
    end

should_respond_with_content_type(content_type) click to toggle source

Deprecated: use ActionController::Matchers#respond_with_content_type instead.

Macro that creates a test asserting that the response content type was ‘content_type’. Example:

    should_respond_with_content_type 'application/rss+xml'
    should_respond_with_content_type :rss
    should_respond_with_content_type /rss/

    # File lib/shoulda/action_controller/macros.rb, line 124
    def should_respond_with_content_type(content_type)
      ::ActiveSupport::Deprecation.warn("use: should respond_with_content_type")
      should respond_with_content_type(content_type)
    end

should_route(method, path, options) click to toggle source

Deprecated: use ActionController::Matchers#route instead.

Macro that creates a routing test. It tries to use the given HTTP `method` on the given `path`, and asserts that it routes to the given `options`.

If you don’t specify a :controller, it will try to guess the controller based on the current test.

`to_param` is called on the `options` given.

Examples:

    should_route :get, "/posts", :controller => :posts, :action => :index
    should_route :get, "/posts/new", :action => :new
    should_route :post, "/posts", :action => :create
    should_route :get, "/posts/1", :action => :show, :id => 1
    should_route :edit, "/posts/1", :action => :show, :id => 1
    should_route :put, "/posts/1", :action => :update, :id => 1
    should_route :delete, "/posts/1", :action => :destroy, :id => 1
    should_route :get, "/users/1/posts/1",
      :action => :show, :id => 1, :user_id => 1

    # File lib/shoulda/action_controller/macros.rb, line 215
    def should_route(method, path, options)
      ::ActiveSupport::Deprecation.warn("use: should route")
      should route(method, path).to(options)
    end

should_set_session(key, &block) click to toggle source

Deprecated: use ActionController::Matchers#set_session instead.

Macro that creates a test asserting that a value returned from the session is correct. Expects the session key as a parameter, and a block that returns the expected value.

Example:

    should_set_session(:user_id) { @user.id }
    should_set_session(:message) { "Free stuff" }

    # File lib/shoulda/action_controller/macros.rb, line 139
    def should_set_session(key, &block)
      ::ActiveSupport::Deprecation.warn("use: should set_session")
      matcher = set_session(key)
      matcher = matcher.to(&block) if block
      should matcher
    end

should_set_the_flash_to(val) click to toggle source

Deprecated: use ActionController::Matchers#set_the_flash instead.

Macro that creates a test asserting that the flash contains the given value. Expects a `String` or `Regexp`.

Example:

    should_set_the_flash_to "Thank you for placing this order."
    should_set_the_flash_to /created/i

    # File lib/shoulda/action_controller/macros.rb, line 36
    def should_set_the_flash_to(val)
      ::ActiveSupport::Deprecation.warn("use: should set_the_flash")
      should set_the_flash.to(val)
    end

[Validate]

Generated with the Darkfish Rdoc Generator 2.