= Guard::RSpec

RSpec guard allows to automatically & intelligently launch specs when files are modified.

- Compatible with RSpec 1.3.x & RSpec 2.0.x
- Tested on Ruby 1.8.6, 1.8.7 & 1.9.2.

== Install

Please be sure to have {guard}[http://github.com/guard/guard] installed before continue.

Install the gem:

    gem install guard-rspec

Add it to your Gemfile (inside test group):

    gem 'guard-rspec'

Add guard definition to your Guardfile by running this command:

    guard init rspec

== Usage

Please read {guard usage doc}[http://github.com/guard/guard#readme]

== Guardfile

RSpec guard can be really be adapated to all kind of projects.
Please read {guard doc}[http://github.com/guard/guard#readme] for more info about Guardfile DSL.

=== Standard ruby gems

    guard 'rspec' do
      watch('^spec/(.*)_spec.rb')
      watch('^lib/(.*)\.rb')                              { |m| "spec/lib/#{m[1]}_spec.rb" }
      watch('^spec/spec_helper.rb')                       { "spec" }
    end

=== Rails app

    guard 'rspec' do
      watch('^spec/(.*)_spec.rb')
      watch('^app/(.*)\.rb')                              { |m| "spec/#{m[1]}_spec.rb" }
      watch('^lib/(.*)\.rb')                              { |m| "spec/lib/#{m[1]}_spec.rb" }
      watch('^spec/spec_helper.rb')                       { "spec" }
      watch('^config/routes.rb')                          { "spec/routing" }
      watch('^app/controllers/application_controller.rb') { "spec/controllers" }
      watch('^spec/factories.rb')                         { "spec/models" }
    end

== Options

RSpec guard should automatically detect RSpec version (via spec_helper syntax or Bundler) but you can force version with:

    guard 'rspec', :version => 2 do
      ...
    end
    
Other available options:

    :color => false
    :drb => true
    :bundler => false # don't use "bundle exec"
    :rvm => ['1.8.7', '1.9.2'] # directly run your specs on multiple ruby

== Development

- Source hosted at {GitHub}[http://github.com/guard/guard-rspec]
- Report issues/Questions/Feature requests on {GitHub Issues}[http://github.com/guard/guard-rspec/issues]

Pull requests are very welcome! Make sure your patches are well tested. Please create a topic branch for every separate change
you make.

=== Testing

Please run "rake spec:prepare_fixtures" once before launching specs.

== Authors

{Thibaud Guillaume-Gentil}[http://github.com/thibaudgg]