Module: RSpec::Rails::ControllerExampleGroup

Extended by:
ActiveSupport::Concern
Includes:
ActionController::TestCase::Behavior, AssertionDelegator.new( ActionDispatch::Assertions::RoutingAssertions ), Matchers::RedirectTo, Matchers::RenderTemplate, Matchers::RoutingMatchers, RailsExampleGroup, ViewRendering
Defined in:
lib/rspec/rails/example/controller_example_group.rb

Overview

Container module for controller spec functionality.

Defined Under Namespace

Modules: ClassMethods

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Matchers::RoutingMatchers

#be_routable, #route_to

Methods included from Matchers::RenderTemplate

#have_rendered

Methods included from Matchers::RedirectTo

#redirect_to

Methods included from ViewRendering

#render_views?

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(method, *args, &block) ⇒ Object

If method is a named_route, delegates to the RouteSet associated with this controller.

172
173
174
175
176
177
178
# File 'lib/rspec/rails/example/controller_example_group.rb', line 172
def method_missing(method, *args, &block)
  if route_available?(method)
    controller.send(method, *args, &block)
  else
    super
  end
end

Instance Attribute Details

#controllerObject (readonly)

Returns the controller object instance under test.

128
129
130
# File 'lib/rspec/rails/example/controller_example_group.rb', line 128
def controller
  @controller
end

#routesObject

Returns the Rails routes used for the spec.

132
133
134
# File 'lib/rspec/rails/example/controller_example_group.rb', line 132
def routes
  @routes
end

Instance Method Details

#bypass_rescueObject

Extends the controller with a module that overrides rescue_with_handler to raise the exception passed to it. Use this to specify that an action should raise an exception given appropriate conditions.

Examples:

describe ProfilesController do
  it "raises a 403 when a non-admin user tries to view another user's profile" do
    profile = create_profile
     profile.user
    expect do
      bypass_rescue
      get :show, id: profile.id + 1
    end.to raise_error(/403 Forbidden/)
  end
end
166
167
168
# File 'lib/rspec/rails/example/controller_example_group.rb', line 166
def bypass_rescue
  controller.extend(BypassRescue)
end