Skip to content

Latest commit

 

History

History
71 lines (50 loc) · 1.54 KB

README.markdown

File metadata and controls

71 lines (50 loc) · 1.54 KB
Raw

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.a9"

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
  • mailer specs in spec/mailers
  • observer specs in spec/models
  • 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