# README

Path: | README
Last Update: | Sun Jul 20 13:32:46 -0500 2008

## RSpec

RSpec is a Behaviour Driven Development framework with tools to express User Stories with Executable Scenarios and Executable Examples at the code level.

RSpec ships with several modules:

Spec::Story provides a framework for expressing User Stories and Scenarios

Spec::Example provides a framework for expressing Isolated Examples

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.

## Installation

The simplest approach is to install the gem (as root in some environments):

      gem install -r rspec

## Building the RSpec gem

If you prefer to build the gem locally:

      git clone git://github.com/dchelimsky/rspec.git
      cd rspec
      rake gem
      gem install pkg/rspec-0.x.x.gem #as root

[Validate]