Path: | README |
Last Update: | Thu Jun 07 10:40:49 CDT 2007 |
RSpec is a Behaviour Definition Framework intended for use in Behaviour Driven Development. RSpec plays the same role that a unit testing framework would play in a Test Driven Development environment, but does so using words and structures that better support BDD.
RSpec ships with four modules:
Spec::Matchers provides Expression Matchers for use with Spec::Expectations and Spec::Mocks.
Spec::Expectations supports setting expectations on your objects so you can do things like:
result.should equal(expected_result)
Spec::Mocks supports creating Mock Objects, Stubs, and adding Mock/Stub behaviour to your existing objects.
Spec::Runner provides a very small but powerful DSL for writing executable examples of how your code should work.
The simplest approach is to install the gem:
gem install -r rspec #mac users must sudo
If you prefer to build the gem locally, check out source from svn://rubyforge.org/var/svn/rspec/trunk. Then do the following:
rake gem gem install pkg/rspec-0.x.x.gem (you may have to sudo)
In order to run RSpec‘s full suite of specs (rake pre_commit) you must install the following gems:
Once those are all installed, you should be able to run the suite with the following steps:
Note that RSpec itself - once built - doesn‘t have any dependencies outside the Ruby core and stdlib - with a few exceptions:
See rspec.rubyforge.org for further documentation.