Readme.md in parallel_tests-3.4.0 vs Readme.md in parallel_tests-3.5.0

- old
+ new

@@ -35,10 +35,13 @@ rake parallel:create ### Copy development schema (repeat after migrations) rake parallel:prepare +### Run migrations in additional database(s) (repeat after migrations) + rake parallel:migrate + ### Setup environment from scratch (create db and loads schema, useful for CI) rake parallel:setup ### Run! rake parallel:test # Test::Unit @@ -140,21 +143,23 @@ --format ParallelTests::RSpec::SummaryLogger --out tmp/spec_summary.log RSpec: FailuresLogger ----------------------- -Produce pasteable command-line snippets for each failed example. +Produce pastable command-line snippets for each failed example. For example: -E.g. +```bash +rspec /path/to/my_spec.rb:123 # should do something +``` - rspec /path/to/my_spec.rb:123 # should do something +Add to `.rspec_parallel` or use as CLI flag: -Add the following to your `.rspec_parallel` (or `.rspec`) : - --format progress --format ParallelTests::RSpec::FailuresLogger --out tmp/failing_specs.log +(Not needed to retry failures, for that pass [--only-failures](https://relishapp.com/rspec/rspec-core/docs/command-line/only-failures) to rspec) + Cucumber: FailuresLogger ----------------------- Log failed cucumber scenarios to the specified file. The filename can be passed to cucumber, prefixed with '@' to rerun failures. @@ -206,11 +211,20 @@ -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). Automatically turned on if --isolate-n is set above 0. --isolate-n Number of processes for isolated groups. Default to 1 when --isolate is on. - --only-group INT[, INT] + --specify-groups [SPECS] Use 'specify-groups' if you want to specify multiple specs running in multiple + processes in a specific formation. Commas indicate specs in the same process, + pipes indicate specs in a new process. Cannot use with --single, --isolate, or + --isolate-n. Ex. + Ex. + $ parallel_tests -n 3 . --specify-groups '1_spec.rb,2_spec.rb|3_spec.rb' + Process 1 will contain 1_spec.rb and 2_spec.rb + Process 2 will contain 3_spec.rb + Process 3 will contain all other specs + --only-group INT[,INT] -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 --suffix [PATTERN] override built in test file pattern (should match suffix): '_spec.rb$' - matches rspec files @@ -280,11 +294,11 @@ - [Spring] Add the [spring-commands-parallel-tests](https://github.com/DocSpring/spring-commands-parallel-tests) gem to your `Gemfile` to get `parallel_tests` working with Spring. - `--first-is-1` will make the first environment be `1`, so you can test while running your full suite.<br/> `export PARALLEL_TEST_FIRST_IS_1=true` will provide the same result - [email_spec and/or action_mailer_cache_delivery](https://github.com/grosser/parallel_tests/wiki) - [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) + - [Distributed Parallel Tests on CI systems)](https://github.com/grosser/parallel_tests/wiki/Distributed-Parallel-Tests-on-CI-systems) learn how `parallel_tests` can run on distributed servers such as Travis and GitLab-CI. Also shows you how to use parallel_tests without adding `TEST_ENV_NUMBER`-backends - [Capybara setup](https://github.com/grosser/parallel_tests/wiki) - [Sphinx setup](https://github.com/grosser/parallel_tests/wiki) - [Capistrano setup](https://github.com/grosser/parallel_tests/wiki/Remotely-with-capistrano) let your tests run on a big box instead of your laptop Contribute your own gotchas to the [Wiki](https://github.com/grosser/parallel_tests/wiki) or even better open a PR :) @@ -377,9 +391,10 @@ - [Sandeep Singh](https://github.com/sandeepnagra) - [Calaway](https://github.com/calaway) - [alboyadjian](https://github.com/alboyadjian) - [Nathan Broadbent](https://github.com/ndbroadbent) - [Vikram B Kumar](https://github.com/v-kumar) + - [Joshua Pinter](https://github.com/joshuapinter) [Michael Grosser](http://grosser.it)<br/> michael@grosser.it<br/> License: MIT