Contents

# ParallelRSpec

This gem lets you run your RSpec examples in parallel across across your CPUs.  Each worker gets its own database to avoid conflicts.

## Installation

Add this to your application's Gemfile:

```ruby
group :development, :test do
  gem 'parallel_rspec'
end
```

Or if you use Spring:

```ruby
group :development, :test do
  gem 'spring-prspec'
end
```

And then execute:

    $ bundle

This version of ParallelRSpec has been tested with RSpec 3.3.

## Usage

By default, ParallelRSpec will use two workers.  If you would like to use more, set an environment variable:

    $ export WORKERS=4

ParallelRSpec runs each worker with its own copy of the test database to avoid locking and deadlocking problems.  To create these and populate them with your schema, run:

    $ bundle exec db:parallel:create db:parallel:prepare

ParallelRSpec will automatically make the database name for each worker based on the name you used for the `test` environment in `config/database.yml`.  For example, if your normal `test` database is `foo_test`, worker 1 will keep using `foo_test` but worker 2's database will be `foo_test2`.

You're then ready to run specs in parallel:

    $ bundle exec prspec spec/my_spec.rb spec/another_spec.rb

Or if you use Spring:

    $ bundle exec spring prspec spec/my_spec.rb spec/another_spec.rb

You may like to make an alias:

    $ alias prspec='bundle exec spring prspec'
    $ prspec spec/my_spec.rb spec/another_spec.rb

When you change WORKERS, don't forget to restart Spring and re-run the create and populate steps above if necessary.

## Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/willbryant/parallel_rspec.


## License

The gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).

Copyright (c) Powershop New Zealand Ltd, 2015.

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
parallel_rspec-0.4.1	README.md