Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Ruby

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib
.gitignore
README.markdown
Rakefile
VERSION
example_app_template.rb
rspec-rails.gemspec

README.markdown

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

Install:

gem install rspec-rails --pre

This installs the following gems:

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

Configure:

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.