Readme.md in parallel_tests-1.3.9 vs Readme.md in parallel_tests-1.5.0
- old
+ new
@@ -160,16 +160,21 @@
parallel_test test/
parallel_rspec spec/
parallel_cucumber features/
parallel_spinach features/
- - use ENV['TEST_ENV_NUMBER'] inside your tests to select separate db/memcache/etc.
+ - use `ENV['TEST_ENV_NUMBER']` inside your tests to select separate db/memcache/etc.
- Only run selected files & folders:
- parallel_test test/bar test/baz/foo_text.rb
+ `parallel_test test/bar test/baz/foo_text.rb`
+ - Pass test-options and files via `--`:
+
+ `parallel_test -- -t acceptance -f progress -- spec/foo_spec.rb spec/acceptance`
+
Options are:
+<!-- copy output from bundle exec ./bin/parallel_test -h -->
-n [PROCESSES] How many processes to use, default: available CPUs
-p, --pattern [PATTERN] run tests matching this pattern
--group-by [TYPE] group tests by:
found - order of finding files
@@ -180,11 +185,11 @@
default - runtime when runtime log is filled otherwise filesize
-m, --multiply-processes [FLOAT] use given number as a multiplier of processes to run
-s, --single [PATTERN] Run all matching files in the same process
-i, --isolate Do not run any other tests in the group used by --single(-s)
--only-group INT[, INT]
- -e, --exec [COMMAND] execute this code parallel and with ENV['TEST_ENV_NUM']
+ -e, --exec [COMMAND] execute this code parallel and with ENV['TEST_ENV_NUMBER']
-o, --test-options '[OPTIONS]' execute test commands with those options
-t, --type [TYPE] test(default) / rspec / cucumber / spinach
--serialize-stdout Serialize stdout output, nothing will be written until everything is done
--combine-stderr Combine stderr into stdout, useful in conjunction with --serialize-stdout
--non-parallel execute same commands but do not in parallel, needs --exec
@@ -194,11 +199,11 @@
--runtime-log [PATH] Location of previously recorded test runtimes
--verbose Print more output
-v, --version Show Version
-h, --help Show this.
-You can run any kind of code in parallel with -e / --execute
+You can run any kind of code in parallel with -e / --exec
parallel_test -n 5 -e 'ruby -e "puts %[hello from process #{ENV[:TEST_ENV_NUMBER.to_s].inspect}]"'
hello from process "2"
hello from process ""
hello from process "3"
@@ -227,10 +232,11 @@
- [email_spec and/or action_mailer_cache_delivery](https://github.com/grosser/parallel_tests/wiki)
- [Memcached] use different namespaces e.g. `config.cache_store = ..., namespace: "test_#{ENV['TEST_ENV_NUMBER']}"`
- [zeus-parallel_tests](https://github.com/sevos/zeus-parallel_tests)
- [Distributed parallel test (e.g. Travis Support)](https://github.com/grosser/parallel_tests/wiki/Distributed-Parallel-Tests-and-Travis-Support)
- Debug errors that only happen with multiple files using `--verbose` and [cleanser](https://github.com/grosser/cleanser)
+ - Shell alias: `alias prspec='parallel_rspec -m 2 --'`
- Contribute your own gotaches to the [Wiki](https://github.com/grosser/parallel_tests/wiki) or even better open a PR :)
TODO
====
- fix tests vs cucumber >= 1.2 `unknown option --format`
@@ -307,9 +313,10 @@
- [Samer Masry](https://github.com/smasry)
- [Volodymyr Mykhailyk](https:/github.com/volodymyr-mykhailyk)
- [Mike Mueller](https://github.com/mmueller)
- [Aaron Jensen](https://github.com/aaronjensen)
- [Ed Slocomb](https://github.com/edslocomb)
+ - [Cezary Baginski](https://github.com/e2)
[Michael Grosser](http://grosser.it)<br/>
michael@grosser.it<br/>
License: MIT<br/>
[![Build Status](https://travis-ci.org/grosser/parallel_tests.png)](https://travis-ci.org/grosser/parallel_tests)