Contents

Split a big test file into multiple chunks and run them in parallel

Install
=======
    sudo gem install parallel_split_test
Or

    rails plugin install git://github.com/grosser/parallel_split_test.git

Usage
=====

### 1: prepare your databases
To use 1 database per test-process, add this to your `config/database.yml`<br/>

    test:
      database: yourproject_test<%= ENV['TEST_ENV_NUMBER'] %>


 - `TEST_ENV_NUMBER` is '' for the first process and 2 for the 2nd, it reuses your normal test database
 - Optionally install [parallel_tests](https://github.com/grosser/parallel_tests) to get database helper tasks like `rake parallel:prepare`


### 2: find a slow/big test file

    # spec/xxx_spec.rb
    require "spec_helper"

    describe "X" do
      it {sleep 5}
      it {sleep 5}
      it {sleep 5}
    end

### 3: run
    parallel_split_test spec/xxx_spec.rb [regular rspec options]

Output
======

    parallel_split_test spec/xx_spec.rb

    Running examples in 2 processes
    .

    Finished in 5 seconds
    1 example, 0 failures
    ..

    Finished in 1 seconds
    2 examples, 0 failures

    Summary:
    1 example, 0 failures
    2 examples, 0 failures
    Took 10.06 seconds with 2 processes


TIPS
====
 - set number of processes to use with `PARALLEL_SPLIT_TEST_PROCESSES` environment variable

TODO
====
 - Cucumber support
 - Test::Unit support

Author
======
[Michael Grosser](http://grosser.it)<br/>
[e-mail]<br/>
License: MIT<br/>
[![Build Status](https://secure.travis-ci.org/grosser/parallel_split_test.png)](http://travis-ci.org/grosser/parallel_split_test)

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
parallel_split_test-0.2.0	Readme.md