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
======

    time ./bin/parallel_split_test spec/xx_spec.rb
    .

    Finished in 5 seconds
    1 example, 0 failures
    ..

    Finished in 1 seconds
    2 examples, 0 failures

    real  0m11.015s
    user  0m0.908s
    sys  0m0.080s


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

TODO
====
 - re-print summary of all test results
 - 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.1.5	Readme.md