Created: 2014-05-18 18:42
Updated: 2017-06-12 04:57

Run rspec tests in Parallel.

This gem will add some extra methods to rspec allowing for execution of examples in parallel by passing in an additional option of --parallel-test followed by the number of parallel threads to use. The main concept and differentiator from other gems that allow for parallel execution of rspec tests (such as parallel_tests and prspec) is that this gem ensures that all suite, context and all before and after blocks are run only once while the before and after each blocks are run for each example. Additionally, all output formatters will report to a single output file instead of multiple files so there will be no need for consolidating results at the end of testing

Supported RSpec Versions

Build Gem

gem build rspec-parallel.gemspec


gem install rspec-parallel-[version].gem

or get from

gem install rspec-parallel


rspec --parallel-test 4          # run from the default 'spec' directory using 4 threads


moved to wiki at Examples

Known Issues

  • this gem must overwrite the rspec-core executable in order to allow for processing of the additional arguments. this can cause issues if using with the bundler gem as it may not be able to handle the overwrite and the arguments will then not be recognised



inspired by rspec-core pull request 1527
Jason Holt Smith

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more