turbo_tests2 3.1.14 → 3.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b4031f877288b31974b622b8dffb0acffb1361ee96347d695ea69dd9c47a5950
-  data.tar.gz: 8bc186019f3b056c15dc2f68cf42b2062a68f4dc9d1fa34c397446933ac37999
+  metadata.gz: b472277b993feef40505fbd17ec4b7602310b703c965a1a632aa3c21489812c7
+  data.tar.gz: f792e2de4afb78108715d74c488aeb8123ac81c67364a27a1859a194190a100a
 SHA512:
-  metadata.gz: 9a28f75223e3bd926d6cc5ebf4e94bd0de1efa10b82eab792e595cedc73aa1a6bb398e2093058f170c4c7a2d5a76d4b7dc1e8edcc0d01971e4d03d7406d97170
-  data.tar.gz: 4eed7b464c8e3d26419a2822bdeed6c60084c5e25968352af3a053d728f25004b18383b4fed4ab13994f3dfcb28a02e23542560c51c1a1c73fbb3a03ffa90755
+  metadata.gz: 70d7b9f1cc88b356531dfb38281b58f96a0c3f6f6e4c4cfcfff57fafb03fda83a5380d880259f4ae34e040c3292d98c2d0593b779a8157ccd2df34c23e2bfc39
+  data.tar.gz: 6a128634eacabc86bab67908576250ec996b52718417073ef1efad6f5765c9855f4d8c71f1d36282551cd0104721b5fe88ce645c2aae3953a282da462f62bb31

data/CHANGELOG.md

@@ -30,6 +30,100 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.2.1] - 2026-07-25
+
+- TAG: [v3.2.1][3.2.1t]
+- COVERAGE: 96.88% -- 869/897 lines in 10 files
+- BRANCH COVERAGE: 84.44% -- 217/257 branches in 10 files
+- 34.69% documented
+
+### Changed
+
+- The `turbo_tests2` executable now supports `-v` / `--version` and prints a
+  standard startup header on normal runs.
+
+- kettle-jem-template-20260716-001 - Shim gemspec manifests now include
+  `LICENSE.md` instead of nonexistent `LICENSE.txt`.
+- kettle-jem-template-20260716-002 - Generated gemspec manifests now ship fewer
+  repository-only files by default to reduce downstream distro packaging churn.
+- kettle-jem-template-20260720-001 - Generated READMEs can now render
+  template-managed corporate sponsor logos from project or family config.
+- kettle-jem-template-20260720-002 - Generated development Gemfiles now use the
+  released `tree_sitter_language_pack` gem 1.13.3 or newer by default.
+- kettle-jem-template-20260720-003 - Generated StructuredMerge Git diff driver
+  config now uses the installed `smorg-rb` Ruby driver name.
+- kettle-jem-template-20260720-004 - Generated multi-engine workflow files now
+  omit JRuby and TruffleRuby jobs when project config declares MRI-only engines.
+- kettle-jem-template-20260720-005 - Generated README Support & Community rows
+  now include a RubyForum help badge.
+- kettle-jem-template-20260725-001 - Generated JRuby and TruffleRuby workflow
+  files now run when pull request head branches start with `feature/release`,
+  so release CI monitoring does not report intentionally skipped engine
+  workflows as failures.
+
+### Fixed
+
+- Worker commands now drop project `.rspec` presentation formatter and output
+  options after preserving the behavioral options needed by each shard,
+  preventing direct-RSpec formatter output from being replayed alongside the
+  turbo summary.
+- Runtime-based runs now silence the preliminary sizing probe, so
+  `Using recorded test runtime` is printed once by the actual grouping pass.
+
+## [3.2.0] - 2026-07-18
+
+- TAG: [v3.2.0][3.2.0t]
+- COVERAGE: 96.88% -- 869/897 lines in 10 files
+- BRANCH COVERAGE: 84.44% -- 217/257 branches in 10 files
+- 34.69% documented
+
+### Added
+
+- `--count` is now accepted as an alias for `-n`, matching the
+  `parallel_tests` process-count option while keeping the existing
+  `-w` / `--workers` aliases.
+- Documented the supported `parallel_tests` option subset and clarified that
+  unsupported flags are not blindly passed through after `--`.
+- Added `--worker-output MODE` and `TURBO_TESTS2_WORKER_OUTPUT` support for
+  selecting raw worker stdout/stderr handling: `warnings`, `stream`, `buffered`,
+  or `quiet`.
+- `--group-by runtime|filesize|found` is now parsed explicitly and mapped to
+  `parallel_tests` grouping modes, including when supplied after the
+  compatibility `--` separator.
+- `--allowed-missing PERCENT` and `--unknown-runtime SECONDS` are now parsed
+  explicitly and mapped to `parallel_tests` runtime grouping tuning options,
+  including when supplied after the compatibility `--` separator.
+
+### Changed
+
+- Pull request engine workflows now keep JRuby and TruffleRuby coverage
+  available via branch opt-in prefixes: `jruby/*` runs JRuby workflows,
+  `truffleruby/*` runs TruffleRuby workflows, and `engines/*` runs all engine
+  workflows. Other pull request branches continue to run MRI checks without the
+  alternate engine jobs.
+- The delayed documentation formatter spec now lives under fixtures so the
+  normal suite does not pay its fixed load-time delay.
+
+### Fixed
+
+- Successful non-verbose runs now surface warning and deprecation lines emitted
+  as raw worker stdout/stderr without dumping all buffered worker output.
+- `heads.yml` and `dep-heads.yml` now gate JRuby and TruffleRuby PR coverage
+  at the job level, so non-matching PR branches skip those engine jobs before a
+  runner is provisioned.
+- Direct `turbo_tests2` runs now refresh the default
+  `tmp/turbo_rspec_runtime.log` timing log, and `--runtime-log` writes the
+  requested timing log even when the run groups by filesize.
+- `--only-group GROUP_INDEX[,GROUP_INDEX]` is now parsed explicitly and runs
+  only the selected 1-based `parallel_tests` group index(es), using filesize
+  grouping by default for selected-group reruns.
+- `--pattern PATTERN` is now parsed explicitly and mapped to `parallel_tests`
+  file discovery instead of being treated as a spec file when supplied after
+  `--`.
+- `--exclude-pattern PATTERN` is now parsed explicitly and mapped to
+  `parallel_tests` file discovery instead of being treated as a spec file when
+  supplied after `--`.
+
 ## [3.1.14] - 2026-07-17
 
 - TAG: [v3.1.14][3.1.14t]
@@ -302,7 +396,11 @@ Please file a bug if you notice a violation of semantic versioning.
 
 - Initial release
 
-[Unreleased]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.14...HEAD
+[Unreleased]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.1...HEAD
+[3.2.1]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.0...v3.2.1
+[3.2.1t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.2.1
+[3.2.0]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.14...v3.2.0
+[3.2.0t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.2.0
 [3.1.14]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.13...v3.1.14
 [3.1.14t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.1.14
 [3.1.13]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.12...v3.1.13

data/LICENSE.md

@@ -3,7 +3,7 @@
 This project is made available under the following license.
 Choose the option that best fits your use case:
 
-- [MIT](MIT.md)
+- [MIT](https://github.com/galtzo-floss/turbo_tests2/blob/main/MIT.md)
 
 ## Copyright Notice
 

data/README.md

@@ -71,8 +71,8 @@ Finished in 2 minute 25.15 seconds (files took 0 seconds to load)
 | Works with MRI Ruby 4 | [![Ruby current Compat][💎ruby-c-i]][🚎11-c-wf] [![Ruby HEAD Compat][💎ruby-headi]][🚎3-hd-wf]|
 | Works with MRI Ruby 3 | [![Ruby 3.0 Compat][💎ruby-3.0i]][🚎ruby-3.0-wf] [![Ruby 3.1 Compat][💎ruby-3.1i]][🚎ruby-3.1-wf] [![Ruby 3.2 Compat][💎ruby-3.2i]][🚎ruby-3.2-wf] [![Ruby 3.3 Compat][💎ruby-3.3i]][🚎ruby-3.3-wf] [![Ruby 3.4 Compat][💎ruby-3.4i]][🚎ruby-3.4-wf]|
 | Works with MRI Ruby 2 | [![Ruby 2.4 Compat][💎ruby-2.4i]][🚎ruby-2.4-wf] [![Ruby 2.5 Compat][💎ruby-2.5i]][🚎ruby-2.5-wf] [![Ruby 2.6 Compat][💎ruby-2.6i]][🚎ruby-2.6-wf] [![Ruby 2.7 Compat][💎ruby-2.7i]][🚎ruby-2.7-wf]|
-| Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
-| Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on Github.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
+| Support & Community | [![Join Me on Daily.dev's RubyFriends][✉️ruby-friends-img]][✉️ruby-friends] [![Get help from RubyForum][✉️ruby-forum-img]][✉️ruby-forum] [![Live Chat on Discord][✉️discord-invite-img-ftb]][✉️discord-invite] [![Get help from me on Upwork][👨🏼‍🏫expsup-upwork-img]][👨🏼‍🏫expsup-upwork] [![Get help from me on Codementor][👨🏼‍🏫expsup-codementor-img]][👨🏼‍🏫expsup-codementor] |
+| Source | [![Source on GitLab.com][📜src-gl-img]][📜src-gl] [![Source on CodeBerg.org][📜src-cb-img]][📜src-cb] [![Source on GitHub.com][📜src-gh-img]][📜src-gh] [![The best SHA: dQw4w9WgXcQ!][🧮kloc-img]][🧮kloc] |
 | Documentation | [![Current release on RubyDoc.info][📜docs-cr-rd-img]][🚎yard-current] [![YARD on Galtzo.com][📜docs-head-rd-img]][🚎yard-head] [![Maintainer Blog][🚂maint-blog-img]][🚂maint-blog] [![GitLab Wiki][📜gl-wiki-img]][📜gl-wiki] [![GitHub Wiki][📜gh-wiki-img]][📜gh-wiki] |
 | Compliance | [![License: MIT][📄license-img]][📄license] [![Apache license compatibility: Category A][📄license-compat-img]][📄license-compat] [![📄ilo-declaration-img]][📄ilo-declaration] [![Security Policy][🔐security-img]][🔐security] [![Contributor Covenant 2.1][🪇conduct-img]][🪇conduct] [![SemVer 2.0.0][📌semver-img]][📌semver] |
 | Style | [![Enforced Code Style Linter][💎rlts-img]][💎rlts] [![Keep-A-Changelog 1.0.0][📗keep-changelog-img]][📗keep-changelog] [![Gitmoji Commits][📌gitmoji-img]][📌gitmoji] [![Compatibility appraised by: appraisal2][💎appraisal2-img]][💎appraisal2] |
@@ -196,14 +196,23 @@ Usage: turbo_tests2 [options]
   turbo_tests2 spec/bar spec/baz/xxx_spec.rb
 
 Options:
-    -n, -w, --workers [PROCESSES]    How many processes to use, default: available CPUs
+    -n, --count [PROCESSES]          How many processes to use, default: available CPUs
+    -w, --workers [PROCESSES]        Alias for -n, --count
     -r, --require PATH               Require a file.
     -f, --format FORMATTER           Choose a formatter. Available formatters: progress (p), documentation (d). Default: progress
     -t, --tag TAG                    Run examples with the specified tag.
     -o, --out FILE                   Write output to a file instead of $stdout
         --runtime-log FILE           Location of previously recorded test runtimes
         --example-status-log FILE    Use RSpec example status persistence timings for grouping
+        --pattern PATTERN            Run spec files matching this regex pattern
+        --exclude-pattern PATTERN    Exclude spec files matching this regex pattern
+        --only-group GROUP_INDEX[,GROUP_INDEX]
+                                      Run only the selected 1-based parallel_tests group index(es)
+        --group-by MODE              Group files by runtime, filesize, or found order
+        --allowed-missing PERCENT    Allowed percentage of missing runtimes for runtime grouping
+        --unknown-runtime SECONDS    Runtime in seconds to assign files missing runtime history
     -v, --verbose                    More output
+        --worker-output MODE         Raw worker output mode: warnings, stream, buffered, or quiet; env: TURBO_TESTS2_WORKER_OUTPUT
         --fail-fast=[N]
         --seed SEED                  Seed for RSpec
         --order ORDER                RSpec example order: random (default) or defined
@@ -217,12 +226,104 @@ By default, `turbo_tests2` generates one random RSpec seed, prints it, and passe
 that same seed to every worker process. Use `--seed SEED` to replay a run, or
 `--order defined` / `--no-random` when you want ordered examples without a seed.
 
-To pass any options supported by parallel_tests, use `--`:
+`turbo_tests2` supports selected `parallel_tests` options explicitly. It does
+not invoke the `parallel_tests` CLI directly, and it does not blindly pass
+unknown `parallel_tests` flags through after `--`. Options after `--` are parsed
+only when listed as supported below.
+
+To select or exclude files matching a regex:
+
+```bash
+bundle exec turbo_tests2 -n 4 --pattern spec/system
+bundle exec turbo_tests2 -n 4 --exclude-pattern spec/system
+```
+
+The compatibility separator also accepts supported options:
 
 ```bash
-bundle exec turbo_tests2 -n 4 -- --only-group 1 --pattern spec/system
+bundle exec turbo_tests2 -n 4 -- --pattern spec/system
+bundle exec turbo_tests2 -n 4 -- --exclude-pattern spec/system
 ```
 
+To rerun one or more selected 1-based groups from a prior parallel split:
+
+```bash
+bundle exec turbo_tests2 -n 4 --only-group 2
+bundle exec turbo_tests2 -n 4 -- --only-group 1,3
+```
+
+To choose a supported `parallel_tests` grouping mode explicitly:
+
+```bash
+bundle exec turbo_tests2 -n 4 --group-by runtime
+bundle exec turbo_tests2 -n 4 --group-by filesize
+bundle exec turbo_tests2 -n 4 --group-by found
+bundle exec turbo_tests2 -n 4 -- --group-by runtime
+```
+
+`runtime` grouping uses the configured runtime log, which `turbo_tests2`
+continues to record by default. `filesize` and `found` do not use runtime
+history for the initial split, but worker runtime recording still runs so
+future runtime-based runs can use the updated log.
+
+Runtime grouping also supports the explicit `parallel_tests` tuning flags
+`--allowed-missing PERCENT` and `--unknown-runtime SECONDS`:
+
+```bash
+bundle exec turbo_tests2 -n 4 --group-by runtime --allowed-missing 25
+bundle exec turbo_tests2 -n 4 --group-by runtime --unknown-runtime 0.5
+bundle exec turbo_tests2 -n 4 -- --allowed-missing 25 --unknown-runtime 0.5
+```
+
+Selected group runs default to filesize grouping unless `--group-by` is
+provided.
+
+### Supported `parallel_tests` Options
+
+| `parallel_tests` option | Status | `turbo_tests2` equivalent | Notes |
+|-------------------------|--------|---------------------------|-------|
+| `-n`, `--count PROCESSES` | Supported natively | `-n`, `--count`; `-w`, `--workers` aliases | Parsed as a `turbo_tests2` option before any `--` separator. |
+| `-p`, `--pattern PATTERN` | Supported | `--pattern PATTERN` | May be supplied before or after `--`; mapped to `parallel_tests` file discovery. |
+| `--exclude-pattern PATTERN` | Supported | `--exclude-pattern PATTERN` | May be supplied before or after `--`; mapped to `parallel_tests` file discovery. |
+| `--only-group GROUP_INDEX[,GROUP_INDEX]` | Supported | `--only-group GROUP_INDEX[,GROUP_INDEX]` | May be supplied before or after `--`; uses 1-based `parallel_tests` group indexes. |
+| `--group-by runtime` | Supported | `--group-by runtime` | May be supplied before or after `--`; uses runtime-log grouping. |
+| `--group-by filesize` | Supported | `--group-by filesize` | May be supplied before or after `--`; groups by file size. |
+| `--group-by found` | Supported | `--group-by found` | May be supplied before or after `--`; keeps discovered file order. |
+| `--allowed-missing PERCENT` | Supported | `--allowed-missing PERCENT` | May be supplied before or after `--`; validates `0..100`. |
+| `--unknown-runtime SECONDS` | Supported | `--unknown-runtime SECONDS` | May be supplied before or after `--`; validates finite non-negative seconds. |
+| `--runtime-log PATH` | Supported natively | `--runtime-log FILE` | Parsed as a `turbo_tests2` option before any `--` separator. |
+| `--nice` | Supported natively | `--nice` | Parsed as a `turbo_tests2` option before any `--` separator. |
+| `--fail-fast` | Supported natively | `--fail-fast[=N]` | Uses `turbo_tests2` fail-fast handling and RSpec worker arguments. |
+| `--verbose` | Supported natively | `-v`, `--verbose` | Enables `turbo_tests2` verbose output. |
+| `--test-options`, `-o` | Not supported as pass-through | Use `turbo_tests2` RSpec-facing flags | `turbo_tests2` exposes selected RSpec options directly, such as `--seed`, `--order`, `--no-random`, `--tag`, `--format`, and `--out`. |
+| `--group-by default`, `steps`, `scenarios` | Not supported | None | `turbo_tests2` targets RSpec file grouping, not every `parallel_tests` framework mode. |
+| `--single`, `--isolate`, `--isolate-n` | Not supported | None | No first-class mapping yet. |
+| `--specify-groups` | Not supported | None | No first-class mapping yet. |
+| `-m`, `--multiply-processes` | Not supported | None | Use an explicit `-n`/`--count` value. |
+| `-e`, `--exec`, `--exec-args`, `--non-parallel` | Not supported | None | `turbo_tests2` runs RSpec workers, not arbitrary command groups. |
+| `--suffix`, `--type`, `--ignore-tags` | Not supported | None | `turbo_tests2` currently targets RSpec. |
+| `--serialize-stdout`, `--prefix-output-with-test-env-number`, `--combine-stderr`, `--quiet`, `--verbose-command`, `--verbose-process-command`, `--verbose-rerun-command` | Not supported | None | `turbo_tests2` owns worker output collection and formatter reporting. |
+| `--no-symlinks`, `--allow-duplicates`, `--first-is-1`, `--highest-exit-status`, `--failure-exit-code`, `--test-file-limit` | Not supported | None | These need explicit design and tests before they can be accepted. |
+
+### Worker Output Modes
+
+Raw worker stdout/stderr is separate from the parent process formatter output.
+The progress dot parade is reconstructed from JSON formatter events and already
+streams from the parent process as workers report examples. Use
+`--worker-output MODE`, or `TURBO_TESTS2_WORKER_OUTPUT=MODE`, to choose how raw
+worker stdout/stderr is handled. A CLI flag takes precedence over the
+environment variable.
+
+| Mode | Behavior |
+|------|----------|
+| `warnings` | Default. Buffer raw worker output, print warning/deprecation lines after successful runs, and print full buffered raw output on failures. |
+| `stream` | Stream raw worker stdout/stderr immediately without enabling verbose command logging. Buffered output is not replayed at the end. |
+| `buffered` | Buffer raw worker output and print all buffered output after the run completes. |
+| `quiet` | Suppress raw worker output on successful runs. Failed runs still print buffered raw output. |
+
+Known coverage formatter chatter remains collapsed into the concise coverage
+summary.
+
 `turbo_tests2` supports custom formatter such as Fuubar, but you might need to require it:
 
 ```bash
@@ -433,7 +534,7 @@ See [CHANGELOG.md][📌changelog] for a list of releases.
 ## 📄 License
 
 The gem is available as open source under the terms of
-the [MIT](MIT.md) [![License: MIT][📄license-img]][📄license-ref].
+the [MIT](https://github.com/galtzo-floss/turbo_tests2/blob/main/MIT.md) [![License: MIT][📄license-img]][📄license-ref].
 
 ### © Copyright
 
@@ -511,6 +612,8 @@ Thanks for RTFM. ☺️
 [✉️discord-invite-img-ftb]: https://img.shields.io/discord/1373797679469170758?style=for-the-badge&logo=discord
 [✉️ruby-friends-img]: https://img.shields.io/badge/daily.dev-%F0%9F%92%8E_Ruby_Friends-0A0A0A?style=for-the-badge&logo=dailydotdev&logoColor=white
 [✉️ruby-friends]: https://app.daily.dev/squads/rubyfriends
+[✉️ruby-forum-img]: https://img.shields.io/badge/RubyForum-Help-CC342D?style=for-the-badge&logo=ruby&logoColor=white
+[✉️ruby-forum]: https://www.rubyforum.org/c/help/8
 
 [✇bundle-group-pattern]: https://gist.github.com/pboling/4564780
 [⛳️gem-namespace]: https://github.com/galtzo-floss/turbo_tests2
@@ -556,7 +659,7 @@ Thanks for RTFM. ☺️
 [📜src-gl]: https://gitlab.com/galtzo-floss/turbo_tests2
 [📜src-cb-img]: https://img.shields.io/badge/CodeBerg-4893CC?style=for-the-badge&logo=CodeBerg&logoColor=blue
 [📜src-cb]: https://codeberg.org/galtzo-floss/turbo_tests2
-[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=Github&logoColor=green
+[📜src-gh-img]: https://img.shields.io/badge/GitHub-238636?style=for-the-badge&logo=GitHub&logoColor=green
 [📜src-gh]: https://github.com/galtzo-floss/turbo_tests2
 [📜docs-cr-rd-img]: https://img.shields.io/badge/RubyDoc-Current_Release-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
 [📜docs-head-rd-img]: https://img.shields.io/badge/YARD_on_Galtzo.com-HEAD-943CD2?style=for-the-badge&logo=readthedocs&logoColor=white
@@ -666,12 +769,12 @@ Thanks for RTFM. ☺️
 [📌gitmoji]: https://gitmoji.dev
 [📌gitmoji-img]: https://img.shields.io/badge/gitmoji_commits-%20%F0%9F%98%9C%20%F0%9F%98%8D-34495e.svg?style=flat-square
 [🧮kloc]: https://www.youtube.com/watch?v=dQw4w9WgXcQ
-[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.779-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.897-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
 [🔐security]: https://github.com/galtzo-floss/turbo_tests2/blob/main/SECURITY.md
 [🔐security-img]: https://img.shields.io/badge/security-policy-259D6C.svg?style=flat
 [📄copyright-notice-explainer]: https://opensource.stackexchange.com/questions/5778/why-do-licenses-such-as-the-mit-license-specify-a-single-year
 [📄license]: LICENSE.md
-[📄license-ref]: MIT.md
+[📄license-ref]: https://github.com/galtzo-floss/turbo_tests2/blob/main/MIT.md
 [📄license-img]: https://img.shields.io/badge/License-MIT-259D6C.svg
 [📄license-compat]: https://www.apache.org/legal/resolved.html#category-a
 [📄license-compat-img]: https://img.shields.io/badge/Apache_Compatible:_Category_A-%E2%9C%93-259D6C.svg?style=flat&logo=Apache

data/exe/turbo_tests2

@@ -1,7 +1,16 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
+script_basename = File.basename(__FILE__)
+require "turbo_tests/version"
+if ARGV.any? { |arg| arg == "-v" || arg == "--version" }
+  puts TurboTests::Version::VERSION
+  exit(0)
+end
+
 # Alias for `turbo_tests` — turbo_tests2 is a drop-in replacement for turbo_tests.
 require "turbo_tests2"
 
+puts "== #{script_basename} v#{TurboTests::Version::VERSION} =="
+
 TurboTests::CLI.new(ARGV).run

data/lib/turbo_tests/cli.rb

@@ -25,6 +25,9 @@ module TurboTests
       print_failed_group = false
       create = false
       nice = false
+      worker_output = nil
+      parallel_options = {}
+      cli_args, parallel_args = split_parallel_args(@argv)
 
       OptionParser.new do |opts|
         opts.banner = <<~BANNER
@@ -42,7 +45,16 @@ module TurboTests
           Options:
         BANNER
 
-        opts.on("-n [PROCESSES]", "-w [PROCESSES]", "--workers [PROCESSES]", Integer, "How many processes to use, default: available CPUs") do |n|
+        opts.on(
+          "-n [PROCESSES]",
+          "--count [PROCESSES]",
+          Integer,
+          "How many processes to use, default: available CPUs"
+        ) do |n|
+          count = n
+        end
+
+        opts.on("-w [PROCESSES]", "--workers [PROCESSES]", Integer, "Alias for -n, --count") do |n|
           count = n
         end
 
@@ -83,10 +95,41 @@ module TurboTests
           example_status_log = filename
         end
 
+        opts.on("--pattern PATTERN", "Run spec files matching this regex pattern") do |pattern|
+          parallel_options[:pattern] = compile_pattern(pattern)
+        end
+
+        opts.on("--exclude-pattern PATTERN", "Exclude spec files matching this regex pattern") do |pattern|
+          parallel_options[:exclude_pattern] = compile_pattern(pattern)
+        end
+
+        opts.on("--only-group GROUP_INDEX[,GROUP_INDEX]", "Run only the selected 1-based parallel_tests group index(es)") do |groups|
+          parallel_options[:only_group] = parse_only_groups(groups)
+        end
+
+        opts.on("--group-by MODE", "Group files by runtime, filesize, or found order") do |mode|
+          parallel_options[:group_by] = parse_group_by(mode)
+        end
+
+        opts.on("--allowed-missing PERCENT", Integer, "Allowed percentage of missing runtimes for runtime grouping") do |percent|
+          parallel_options[:allowed_missing_percent] = parse_allowed_missing(percent)
+        end
+
+        opts.on("--unknown-runtime SECONDS", Float, "Runtime in seconds to assign files missing runtime history") do |seconds|
+          parallel_options[:unknown_runtime] = parse_unknown_runtime(seconds)
+        end
+
         opts.on("-v", "--verbose", "More output") do
           verbose = true
         end
 
+        opts.on(
+          "--worker-output MODE",
+          "Raw worker output mode: warnings, stream, buffered, or quiet; env: TURBO_TESTS2_WORKER_OUTPUT"
+        ) do |mode|
+          worker_output = mode
+        end
+
         opts.on("--fail-fast=[N]") do |n|
           n = begin
             Integer(n)
@@ -119,7 +162,9 @@ module TurboTests
         opts.on("--nice", "execute test commands with low priority") do
           nice = true
         end
-      end.parse!(@argv)
+      end.parse!(cli_args)
+
+      parse_parallel_args(parallel_args, parallel_options) unless parallel_args.empty?
 
       if create
         return TurboTests::Runner.create(count)
@@ -142,8 +187,7 @@ module TurboTests
 
       invoke_rake_hook("setup")
 
-      files = @argv.empty? ? nil : @argv
-      parallel_options = {}
+      files = cli_args.empty? ? nil : cli_args
 
       exitstatus = TurboTests::Runner.run(
         formatters: formatters,
@@ -158,6 +202,7 @@ module TurboTests
         order: order,
         nice: nice,
         print_failed_group: print_failed_group,
+        worker_output: worker_output,
         parallel_options: parallel_options
       )
 
@@ -177,12 +222,104 @@ module TurboTests
       @argv.first == "fan"
     end
 
+    def split_parallel_args(args)
+      separator_index = args.index("--")
+      return [args, []] unless separator_index
+
+      [
+        args[0...separator_index],
+        args[(separator_index + 1)..-1]
+      ]
+    end
+
+    def parse_parallel_args(args, parallel_options)
+      OptionParser.new do |opts|
+        opts.on("--pattern PATTERN", "Run spec files matching this regex pattern") do |pattern|
+          parallel_options[:pattern] = compile_pattern(pattern)
+        end
+
+        opts.on("--exclude-pattern PATTERN", "Exclude spec files matching this regex pattern") do |pattern|
+          parallel_options[:exclude_pattern] = compile_pattern(pattern)
+        end
+
+        opts.on("--only-group GROUP_INDEX[,GROUP_INDEX]", "Run only the selected 1-based parallel_tests group index(es)") do |groups|
+          parallel_options[:only_group] = parse_only_groups(groups)
+        end
+
+        opts.on("--group-by MODE", "Group files by runtime, filesize, or found order") do |mode|
+          parallel_options[:group_by] = parse_group_by(mode)
+        end
+
+        opts.on("--allowed-missing PERCENT", Integer, "Allowed percentage of missing runtimes for runtime grouping") do |percent|
+          parallel_options[:allowed_missing_percent] = parse_allowed_missing(percent)
+        end
+
+        opts.on("--unknown-runtime SECONDS", Float, "Runtime in seconds to assign files missing runtime history") do |seconds|
+          parallel_options[:unknown_runtime] = parse_unknown_runtime(seconds)
+        end
+      end.parse!(args)
+
+      return if args.empty?
+
+      raise OptionParser::InvalidArgument, "unsupported parallel_tests argument(s): #{args.join(" ")}"
+    end
+
+    def compile_pattern(pattern)
+      /#{pattern}/
+    rescue RegexpError => error
+      raise OptionParser::InvalidArgument, "invalid regex pattern #{pattern.inspect}: #{error.message}"
+    end
+
+    def parse_only_groups(groups)
+      groups.to_s.split(",").map do |group|
+        group = group.strip
+        raise OptionParser::InvalidArgument, "invalid group index #{group.inspect}" unless group.match?(/\A[1-9]\d*\z/)
+
+        group.to_i
+      end
+    end
+
+    def parse_group_by(mode)
+      value = mode.to_s.strip
+      supported_modes = %w[runtime filesize found]
+      unless supported_modes.include?(value)
+        raise OptionParser::InvalidArgument, "invalid group-by mode #{value.inspect}; expected one of: #{supported_modes.join(", ")}"
+      end
+
+      value.to_sym
+    end
+
+    def parse_allowed_missing(percent)
+      unless (0..100).cover?(percent)
+        raise OptionParser::InvalidArgument, "invalid allowed missing percent #{percent.inspect}; expected 0 through 100"
+      end
+
+      percent
+    end
+
+    def parse_unknown_runtime(seconds)
+      unless seconds.finite? && !seconds.negative?
+        raise OptionParser::InvalidArgument, "invalid unknown runtime #{seconds.inspect}; expected a finite non-negative number"
+      end
+
+      seconds
+    end
+
     def handle_fan_command
       args = @argv.drop(1)
       count = nil
       parser = OptionParser.new do |opts|
         opts.banner = "Usage: turbo_tests2 fan [options] COMMAND [ARGS]"
-        opts.on("-n [PROCESSES]", "-w [PROCESSES]", "--workers [PROCESSES]", Integer, "How many processes to use, default: available CPUs") do |n|
+        opts.on(
+          "-n [PROCESSES]",
+          "--count [PROCESSES]",
+          Integer,
+          "How many processes to use, default: available CPUs"
+        ) do |n|
+          count = n
+        end
+
+        opts.on("-w [PROCESSES]", "--workers [PROCESSES]", Integer, "Alias for -n, --count") do |n|
           count = n
         end
       end