= Spork Rails {
}[https://travis-ci.org/sporkrb/spork-rails]
This plugin is for running spork in Ruby-on-Rails applications.
== Version compatibility map:
Versions correspond to the latest Rails minor release. Gem is backwards compatible with rails as far as it makes sense to.
- spork-rails 4.0.0: Rails 3.0.0 - 4.0.0
= Usage:
Add to your Gemfile:
gem "spork-rails"
(Since spork-rails depends on spork, it is not necessary to put both spork and spork-rails in your Gemfile)
== INSTALL:
NOTICE: If using spork with rails, use the spork-rails gem.
=== bundler:
Add to your Gemfile:
gem 'spork-rails'
== Usage
From a terminal, change to your project directory.
Then, bootstrap your test helper file. If running rspec,
spork rspec --bootstrap
Cucumber:
spork cucumber --bootstrap
TestUnit:
(Install the spork-testunit gem) spork test_unit --bootstrap
(If you don't specifiy a test framework, spork will find one and pick it.)
Follow the instructions.
Finally, run spork. A spec DRb server will be running!
spork
== Running tests
=== Specs
bundle exec rspec --drb spec
You can remove the requirement to use the --drb argument each time by adding it to your .rspec file.
=== Features (cucumber)
bundle exec cucumber features
(This assumes that you ran the cucumber-rails generator with the --spork option. If not, you'll need to add the --drb option to the appropriate profiles in cucumber.yml)
To run against one a different gemset (see features/gemsets), specifying a name like follows:
GEMSET=rails3.2 bundle exec cucumber features/
== TODO
- Create spork-rails version to work agains Rails 2.x.
- Run tests with
rake
== See also
See https://github.com/sporkrb/spork for more instructions.