RspecChunked

This gem permits to run rspec tests in parallel by chunking tests into defined groups and balancing by file size. If ordering is not enough, permits to balance manually by moving x percentage of tests files from group A into group B.

Installation

Add this line to your application's Gemfile:
```
group :test do
gem 'rspec_chunked'
end
```
And then execute: bundle install

Add manual balance

# config/rspec_chunked.rb
if defined?(RspecChunked::ChunkedTests)
data = { 1 => { to: 2, percentage: 15 },
         4 => { to: 3, percentage: 10 } }
RspecChunked::ChunkedTests.balance_settings = data
end

Balance tests by moving 15% tests files from group 1 into group 2 and moving 10% tests files from group 4 into group 3

Usage

Basic initialization CI_JOBS=1/3 rake rspec_chunked
Custom initialization CI_JOBS=1/3 CI_CMD="bundle exec rspec ..." rake rspec_chunked
CI_JOBS: Current job number / quantity of groups/jobs to be split
CI_CMD: Custom rspec command

Coverage merge reports (when using simplecov)

This task will merge all coverage reports rake rspec_chunked:merge_reports

Github workflow result

Before:
After:

Github workflow sample:

rspec_tests:
name: Rspec tests
runs-on: ubuntu-latest
strategy:
  fail-fast: false
  matrix:
    ci_job: [ 1, 2, 3, 4 ] # enumerize jobs
env:
  CI_JOBS: 4 # define total jobs (must match with matrix above)

steps:
  - uses: actions/checkout@v2
  - name: Backend tests
    env:
      CI_JOB: ${{ matrix.ci_job }}
    run: docker-compose run test /bin/sh -c "CI_JOBS=$CI_JOBS CI_JOB=$CI_JOB rake rspec_chunked"


## Contributing
Bug reports and pull requests are welcome on GitHub at https://github.com/owen2345/rspec_chunked. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.

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