Skip to content
Ruby Cucumber Shell Other
Find file
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


RSpec-2 for Rails-3

Backwards compatibility

None. This is a rewrite of the rspec-rails extension designed to work with rails-3.x and rspec-2.x. It will not work with older versions of either rspec or rails.

Current state

Currently in alpha - some things work, some not so much - see Known Issues, below


gem install rspec-rails --pre

This installs the following gems:

  • rspec
  • rspec-core
  • rspec-expectations
  • rspec-mocks
  • rspec-rails


Add this line to the Gemfile:

gem "rspec-rails", ">= 2.0.0.a7"

This will expose generators, including rspec:install. Now you can run:

script/rails g rspec:install

This adds the spec directory and some skeleton files, including the "rake spec" task.

Note that things are in flux, so some generators generate code that doesn't work all that well yet.

What works (and what doesn't)

Currently supported:

  • each example runs in its own transaction
    • not yet configurable
      • i.e. no way to turn this off
  • model specs in spec/models
  • controller specs in spec/controllers
    • no view isolation yet
  • view specs in spec/views
  • request specs in spec/requests
    • these wrap rails integration tests
  • rails assertions
  • assertion-wrapping matchers
    • redirect_to
    • render_template
      • template must exist (unlike rspec-rails-1.x)
  • webrat matchers
  • generators
    • run "script/rails g" to see the list of available generators

Known issues

  • no helper specs
  • no routing specs
  • only works with ActiveRecord
Something went wrong with that request. Please try again.