RSpec extension library for Ruby on Rails
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.




Behaviour Driven Development for Ruby on Rails.

rspec-rails is an RSpec extension that allows you to drive the development of Ruby on Rails applications with RSpec.

This is the repository for rspec-rails-1.x. If you're looking for rspec-rails-2 for rails-3, see


  • Use RSpec to independently specify Rails Models, Views, Controllers and Helpers

  • Integrated fixture loading

  • Special generators for Resources, Models, Views and Controllers that generate RSpec code examples.


For people for whom TDD is a brand new concept, the testing support built into Ruby on Rails is a huge leap forward. The fact that it is built right in is fantastic, and Ruby on Rails apps are generally much easier to maintain than they might have been without such support.

For those of us coming from a history with TDD, and now BDD, the existing support presents some problems related to dependencies across examples. To that end, RSpec on Rails supports 4 types of examples. We’ve also built in first class mocking and stubbing support in order to break dependencies across these different concerns.


See Spec::Rails::Example for information about the different kinds of example groups you can use to spec the different Rails components

See Spec::Rails::Matchers for information about Rails-specific expectations you can set on responses and models, etc.