turbo_tests2 3.1.0 → 3.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d311bffe032ad5025cceb6e487460d7e1c0d1e87cc07134eafb4f41bdc63d515
-  data.tar.gz: 0a07a421cad5fadb52d3c417fd0626f80159e4757d8a393fe3ac4912c343dba5
+  metadata.gz: 3f7e32f7c287251c9f42dc998ba6b717d2977f1f8d741de4f1f0fb774089589b
+  data.tar.gz: fffd71116b9ce2d824896c779feaa53d467fece2e8e649074690c9e98752a035
 SHA512:
-  metadata.gz: f9745db1b03fd8ef015807cab9518079449ffa6d033d898141eec7f815edbd1dcb1a95f9bf7fd361d6e429d8573fa0668ef7b4ca295c2ad116d72bbb63d35c53
-  data.tar.gz: fe28b347bae32babcdfc80fcf1523b43f54c17dd3726eaeae5e6c4101127685a967e80ef4789c13b47bb16e682282ab5318f9a89b6cce0a16984235128143450
+  metadata.gz: 8b35cc849e52d2c7963fdfa1f51a558261cd7fc0ee00b63c04c7d4d8170fa515aaf0a51717e9bf1fb1bf2e6b2c8eaa19a67f2aac1f9bbbe7ffacdc20140ed4da
+  data.tar.gz: d24ee3ba58ec58d7d942d1f9fc5617fa1d12e34efbc8a65dc5a1db52018af5660a287c7f9c08ce207061ba0d71ecc5727506f92b01bbcc80dda112e0251fb547

data/CHANGELOG.md

@@ -30,6 +30,40 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.1.2] - 2026-06-08
+
+- TAG: [v3.1.2][3.1.2t]
+- COVERAGE: 94.62% -- 651/688 lines in 16 files
+- BRANCH COVERAGE: 79.33% -- 119/150 branches in 16 files
+- 37.08% documented
+
+### Fixed
+
+- `turbo_tests2` now generates and reports a global random seed by default,
+  passes it to every worker process, and supports `--order defined` /
+  `--no-random` for ordered runs without a seed.
+- Worker PID cleanup now uses the `parallel_tests` pid file path captured when the subprocess starts, avoiding JRuby failures after the pid-file environment is restored.
+
+## [3.1.1] - 2026-06-02
+
+- TAG: [v3.1.1][3.1.1t]
+- COVERAGE: 94.63% -- 634/670 lines in 16 files
+- BRANCH COVERAGE: 78.17% -- 111/142 branches in 16 files
+- 36.78% documented
+
+### Fixed
+
+- The CLI now honors documented `turbo_tests2:setup` and `turbo_tests2:cleanup`
+  Rake hooks, while still falling back to legacy `turbo_tests:*` hooks.
+- Worker processes now receive the full `parallel_tests` environment metadata, so SimpleCov
+  defers minimum coverage enforcement to the combined final result instead of checking each
+  shard independently.
+
+- Restored Ruby 2.4 compatibility for worker wait-thread cleanup.
+- The coverage workflow now runs `kettle-test` through direct RSpec execution,
+  so hard coverage thresholds are checked against the complete suite result
+  while other gems can still use `turbo_tests2` under `kettle-test`.
+
 ## [3.1.0] - 2026-05-28
 
 - TAG: [v3.1.0][3.1.0t]
@@ -92,7 +126,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.0...HEAD
+[Unreleased]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.2...HEAD
+[3.1.2]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.1...v3.1.2
+[3.1.2t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.1.2
+[3.1.1]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.1.0...v3.1.1
+[3.1.1t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.1.1
 [3.1.0]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.0.0...v3.1.0
 [3.1.0t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.1.0
 [3.0.0]: https://github.com/galtzo-floss/turbo_tests2/compare/7d4064e5b8acc2f53929fccf7be3eb63f8a9f140...v3.0.0

data/CONTRIBUTING.md

@@ -102,13 +102,29 @@ Git hooks and commit message helpers (exe/kettle-commit-msg)
 - GIT_HOOK_FOOTER_SENTINEL: Required when footer append is enabled — a unique first-line sentinel to prevent duplicates
 - GIT_HOOK_FOOTER_APPEND_DEBUG: Extra debug output in the footer template (true/false)
 
+Git diff driver setup
+- Local setup writes repository `.gitattributes` entries and local Git `diff.smorg-*` command config so this checkout uses StructuredMerge semantic diffs.
+- Global setup registers `diff.smorg-*` commands once in the user Git config; use it when you work across several StructuredMerge-enabled repositories.
+- Include-file setup writes `.git/smorg/config` and includes it from local Git config, keeping command registrations out of the repository files.
+- Git hosting forges generally ignore external diff drivers, so pull request views may still show raw textual diffs even when local `git diff` uses semantic drivers.
+
+```console
+K_JEM_TEMPLATING=true bundle exec kettle-jem install
+```
+
+Troubleshooting Git diffs
+- Use `git diff --no-ext-diff` to compare against Git's built-in diff output.
+- Use `git diff --no-textconv` when a textconv projection obscures the raw file bytes you need to inspect.
+- If Git reports a missing `smorg-*` executable, rerun `bundle install` and the setup command above, then check `git config --local --get-regexp '^diff\.smorg-'`.
+- To remove managed local entries, run `K_JEM_TEMPLATING=true bundle exec kettle-jem install --undo`; remove global command registrations with `git config --global --unset-all diff.smorg-ruby.command`.
+
 For a quick starting point, this repository’s `mise.toml` defines the shared defaults, and `.env.local` can override them locally. Copy `.env.local.example` to `.env.local`, use `KEY=value` lines, and either activate `mise` in your shell or run commands through `mise exec -C /path/to/project -- ...`.
 
 ## Appraisals
 
 From time to time the [appraisal2][🚎appraisal2] gemfiles in `gemfiles/` will need to be updated.
 Generated appraisal and CI workflow floors are controlled by `ruby.test_minimum`
-in `.kettle-jem.yml`; this project was templated with `ruby.test_minimum: 2.4`.
+in `.structuredmerge/kettle-jem.yml`; this project was templated with `ruby.test_minimum: 2.4`.
 That value describes the lowest Ruby version expected to run the test/development
 toolchain, and it may be higher than the gemspec runtime floor.
 

data/LICENSE.md

@@ -7,16 +7,16 @@ Choose the option that best fits your use case:
 
 ## Copyright Notice
 
-Copyright (c) 2020-2023 Illia
-Copyright (c) 2020 Ilya Zub
-Copyright (c) 2021 AMHOL
-Copyright (c) 2021 Serge Bedzhyk
-Copyright (c) 2023 Bo Anderson
-Copyright (c) 2023 Dmitiry Zub☀️
-Copyright (c) 2023-2024 Illia
-Copyright (c) 2023 mrudzki
-Copyright (c) 2023-2024 Sebastien Savater
-Copyright (c) 2024 David Rodriguez
-Copyright (c) 2024 Hiroshi SHIBATA
-Copyright (c) 2025 Gareth Jones
-Copyright (c) 2025-2026 Peter H. Boling
+- Copyright (c) 2020-2023 Illia
+- Copyright (c) 2020 Ilya Zub
+- Copyright (c) 2021 AMHOL
+- Copyright (c) 2021 Serge Bedzhyk
+- Copyright (c) 2023 Bo Anderson
+- Copyright (c) 2023 Dmitiry Zub☀️
+- Copyright (c) 2023-2024 Illia
+- Copyright (c) 2023 mrudzki
+- Copyright (c) 2023-2024 Sebastien Savater
+- Copyright (c) 2024 David Rodriguez
+- Copyright (c) 2024 Hiroshi SHIBATA
+- Copyright (c) 2025-2026 Gareth Jones
+- Copyright (c) 2025-2026 Peter H. Boling

data/README.md

@@ -1,17 +1,10 @@
-[![Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-floss-i]][🖼️galtzo-floss] [![ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5][🖼️ruby-lang-i]][🖼️ruby-lang] [![turbo_tests2 Logo by Aboling0, CC BY-SA 4.0][🖼️galtzo-floss-turbo_tests2-i]][🖼️galtzo-floss-turbo_tests2]
-
-[🖼️galtzo-floss-i]: https://logos.galtzo.com/assets/images/galtzo-floss/avatar-192px.svg
-[🖼️galtzo-floss]: https://discord.gg/3qme4XHNKN
-[🖼️ruby-lang-i]: https://logos.galtzo.com/assets/images/ruby-lang/avatar-192px.svg
-[🖼️ruby-lang]: https://www.ruby-lang.org/
-[🖼️galtzo-floss-turbo_tests2-i]: https://logos.galtzo.com/assets/images/galtzo-floss/turbo_tests2/avatar-192px.svg
-[🖼️galtzo-floss-turbo_tests2]: https://github.com/galtzo-floss/turbo_tests2
+<a href="https://github.com/galtzo-floss/turbo_tests2"><img alt="turbo_tests2 Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/turbo_tests2/avatar-128px.svg" width="20%" align="right"/></a>
 
 # 🚀 TurboTests
 
 [![Version][👽versioni]][👽version] [![GitHub tag (latest SemVer)][⛳️tag-img]][⛳️tag] [![License: MIT][📄license-img]][📄license] [![Downloads Rank][👽dl-ranki]][👽dl-rank] [![CodeCov Test Coverage][🏀codecovi]][🏀codecov] [![Coveralls Test Coverage][🏀coveralls-img]][🏀coveralls] [![QLTY Test Coverage][🏀qlty-covi]][🏀qlty-cov] [![QLTY Maintainability][🏀qlty-mnti]][🏀qlty-mnt] [![CI Heads][🚎3-hd-wfi]][🚎3-hd-wf] [![CI Runtime Dependencies @ HEAD][🚎12-crh-wfi]][🚎12-crh-wf] [![CI Current][🚎11-c-wfi]][🚎11-c-wf] [![CI Truffle Ruby][🚎9-t-wfi]][🚎9-t-wf] [![CI JRuby][🚎10-j-wfi]][🚎10-j-wf] [![Deps Locked][🚎13-🔒️-wfi]][🚎13-🔒️-wf] [![Deps Unlocked][🚎14-🔓️-wfi]][🚎14-🔓️-wf] [![CI Test Coverage][🚎2-cov-wfi]][🚎2-cov-wf] [![CI Style][🚎5-st-wfi]][🚎5-st-wf] [![Apache SkyWalking Eyes License Compatibility Check][🚎15-🪪-wfi]][🚎15-🪪-wf]
 
-`if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][🖼️galtzo-floss], as I may have missed the [discord notification][🖼️galtzo-floss].
+`if ci_badges.map(&:color).detect { it != "green"}` ☝️ [let me know][✉️discord-invite], as I may have missed the [discord notification][✉️discord-invite].
 
 ---
 
@@ -26,7 +19,7 @@ I've summarized my thoughts in [this blog post](https://dev.to/galtzo/hostile-ta
 
 </details>
 
-## 🌻 Synopsis
+## 🌻 Synopsis <a href="https://discord.gg/3qme4XHNKN"><img alt="Galtzo FLOSS Logo by Aboling0, CC BY-SA 4.0" src="https://logos.galtzo.com/assets/images/galtzo-floss/avatar-128px.svg" width="8%" align="right"/></a> <a href="https://ruby-toolbox.com"><img alt="ruby-lang Logo, Yukihiro Matsumoto, Ruby Visual Identity Team, CC BY-SA 2.5" src="https://logos.galtzo.com/assets/images/ruby-lang/avatar-128px.svg" width="8%" align="right"/></a>
 
 | Hard Fork Note                                                                                                                                                                                                                                                                                                                                              |
 |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
@@ -98,8 +91,6 @@ not practical for the current toolchain.
 |------------------------------------------------|--------------------------------------------------------|
 | 👟 Check it out! | ✨ [github.com/appraisal-rb/appraisal2][💎appraisal2] ✨ |
 
-
-
 ### Federated DVCS
 
 <details markdown="1">
@@ -190,20 +181,28 @@ Usage: turbo_tests2 [options]
   turbo_tests2 spec/bar spec/baz/xxx_spec.rb
 
 Options:
-    -n [PROCESSES]                   How many processes to use, default: available CPUs
+    -n, -w, --workers [PROCESSES]    How many processes to use, default: available CPUs
     -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
     -v, --verbose                    More output
         --fail-fast=[N]
         --seed SEED                  Seed for rspec
-        --create                     Create test databases
+        --order ORDER                RSpec example order: random (default) or defined
+        --no-random                  Run examples in defined order without passing a seed
+        --create                     Create databases
         --print_failed_group         Prints group that had failures in it
+        --nice                       execute test commands with low priority
 ```
 
-To pass any options supported by paralell_tests, use `--`:
+By default, `turbo_tests2` generates one random RSpec seed, prints it, and passes
+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 `--`:
 
 ```bash
 bundle exec turbo_tests2 -n 4 -- --only-group 1 --pattern spec/system
@@ -217,12 +216,12 @@ bundle exec turbo_tests2 -r fuubar -f Fuubar spec/whatever
 
 ### Rake Hooks
 
-If Rake is present, the CLI will invoke the tasks `turbo_tests:setup` and `turbo_tests:cleanup` before and after running
+If Rake is present, the CLI will invoke the tasks `turbo_tests2:setup` and `turbo_tests2:cleanup` before and after running
 the test suite. These can be used to do work that should only happen once, such as removing files or collating coverage:
 
 ```ruby
 # lib/tasks/turbo_tests.rake
-namespace :turbo_tests do
+namespace :turbo_tests2 do
   task setup: :environment do
     # precompile assets once, to avoid doing it per each process
     Rake::Tasks["assets:precompile"]
@@ -256,8 +255,8 @@ SimpleCov.start("rails") do
   formatter SimpleCov::Formatter::SimpleFormatter
 end
 
-# lib/tasks/turbo_tests.rake
-namespace :turbo_tests do
+# lib/tasks/turbo_tests2.rake
+namespace :turbo_tests2 do
   task setup: :environment do
     # remove any existing coverage files to avoid false reporting
     FileUtils.rm_rf("coverage/turbo_tests")
@@ -439,7 +438,7 @@ See [LICENSE.md][📄license] for the official copyright notice.
 - Copyright (c) 2023-2024 Sebastien Savater
 - Copyright (c) 2024 David Rodriguez
 - Copyright (c) 2024 Hiroshi SHIBATA
-- Copyright (c) 2025 Gareth Jones
+- Copyright (c) 2025-2026 Gareth Jones
 - Copyright (c) 2025-2026 Peter H. Boling
 
 </details>
@@ -463,6 +462,8 @@ To say "thanks!" ☝️ Join the Discord or 👇️ send money.
 
 ### Please give the project a star ⭐ ♥.
 
+Many parts of this project are actively managed by a [kettle-jem](https://github.com/structuredmerge/structuredmerge-ruby/tree/main/gems/kettle-jem) smart template utilizing [StructuredMerge.org](https://structuredmerge.org) merge contracts.
+
 Thanks for RTFM. ☺️
 
 [⛳liberapay-img]: https://img.shields.io/liberapay/goal/pboling.svg?logo=liberapay&color=a51611&style=flat
@@ -651,7 +652,7 @@ 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.641-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.688-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
@@ -677,9 +678,9 @@ Thanks for RTFM. ☺️
 | Field | Value |
 |---|---|
 | Package | turbo_tests2 |
-| Description | 🚀 `turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests` and `grosser/parallel_tests` with incremental summarized output. Source code of `turbo_test2` gem is based on Discourse and Rubygems work in this area (see README file of the source repository). |
+| Description | 🚀 turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests` and `grosser/parallel_tests` with incremental summarized output. Source code of `turbo_test2` gem is based on Discourse and Rubygems work in this area (see README.md). |
 | Homepage | https://github.com/galtzo-floss/turbo_tests2 |
-| Source | https://github.com/galtzo-floss/turbo_tests2/tree/v3.0.0 |
+| Source | https://github.com/galtzo-floss/turbo_tests2/tree/v3.1.1 |
 | License | `MIT` |
 | Funding | https://github.com/sponsors/pboling, https://issuehunt.io/u/pboling, https://ko-fi.com/pboling, https://liberapay.com/pboling/donate, https://opencollective.com/galtzo-floss, https://patreon.com/galtzo, https://polar.sh/pboling, https://thanks.dev/u/gh/pboling, https://tidelift.com/funding/github/rubygems/turbo_tests2, https://www.buymeacoffee.com/pboling |
 <!-- kettle-jem:metadata:end -->

data/SECURITY.md

@@ -4,7 +4,7 @@
 
 | Version  | Supported |
 |----------|-----------|
-| 1.latest | ✅         |
+| 3.1.latest | ✅         |
 
 ## Security contact information
 

data/lib/turbo_tests/cli.rb

@@ -21,6 +21,7 @@ module TurboTests
       verbose = false
       fail_fast = nil
       seed = nil
+      order = nil
       print_failed_group = false
       create = false
       nice = false
@@ -52,11 +53,11 @@ module TurboTests
         opts.on(
           "-f",
           "--format FORMATTER",
-          "Choose a formatter. Available formatters: progress (p), documentation (d). Default: progress",
+          "Choose a formatter. Available formatters: progress (p), documentation (d). Default: progress"
         ) do |name|
           formatters << {
             name: name,
-            outputs: [],
+            outputs: []
           }
         end
 
@@ -68,7 +69,7 @@ module TurboTests
           if formatters.empty?
             formatters << {
               name: "progress",
-              outputs: [],
+              outputs: []
             }
           end
           formatters.last[:outputs] << filename
@@ -89,7 +90,7 @@ module TurboTests
         opts.on("--fail-fast=[N]") do |n|
           n = begin
             Integer(n)
-          rescue StandardError
+          rescue
             nil
           end
           fail_fast = (n.nil? || n < 1) ? 1 : n
@@ -99,6 +100,14 @@ module TurboTests
           seed = s
         end
 
+        opts.on("--order ORDER", "RSpec example order: random (default) or defined") do |value|
+          order = value
+        end
+
+        opts.on("--no-random", "Run examples in defined order without passing a seed") do
+          order = "defined"
+        end
+
         opts.on("--create", "Create databases") do
           create = true
         end
@@ -121,7 +130,7 @@ module TurboTests
       if formatters.empty?
         formatters << {
           name: "progress",
-          outputs: [],
+          outputs: []
         }
       end
 
@@ -131,7 +140,7 @@ module TurboTests
 
       load_rake
 
-      invoke_rake_task("turbo_tests:setup")
+      invoke_rake_hook("setup")
 
       files = @argv.empty? ? ["spec"] : @argv
       parallel_options = {}
@@ -146,12 +155,13 @@ module TurboTests
         fail_fast: fail_fast,
         count: count,
         seed: seed,
+        order: order,
         nice: nice,
         print_failed_group: print_failed_group,
-        parallel_options: parallel_options,
+        parallel_options: parallel_options
       )
 
-      invoke_rake_task("turbo_tests:cleanup")
+      invoke_rake_hook("cleanup")
 
       # From https://github.com/galtzo-floss/turbo_tests2/pull/20/
       exit(exitstatus)
@@ -187,7 +197,7 @@ module TurboTests
       pids = (1..processes).map do |process_id|
         env = {
           "TEST_ENV_NUMBER" => process_id.to_s,
-          "PARALLEL_TEST_GROUPS" => processes.to_s,
+          "PARALLEL_TEST_GROUPS" => processes.to_s
         }
         Process.spawn(env, *args)
       end
@@ -243,7 +253,7 @@ module TurboTests
     def shim_usage(command = nil)
       lines = [
         "Usage: turbo_tests2 shim install [--path PATH]",
-        "       turbo_tests2 shim remove [--path PATH]",
+        "       turbo_tests2 shim remove [--path PATH]"
       ]
       lines << "Unknown shim command: #{command}" if command && !%w[install remove].include?(command)
       lines.join("\n")
@@ -270,5 +280,14 @@ module TurboTests
 
       Rake::Task[name].invoke
     end
+
+    def invoke_rake_hook(name)
+      current_task = "turbo_tests2:#{name}"
+      legacy_task = "turbo_tests:#{name}"
+
+      return invoke_rake_task(current_task) if defined?(Rake) && Rake::Task.task_defined?(current_task)
+
+      invoke_rake_task(legacy_task)
+    end
   end
 end

data/lib/turbo_tests/json_rows_formatter.rb

@@ -23,7 +23,7 @@ module TurboTests
     INTERNAL_BACKTRACE_PATTERNS = [
       %r{/bin/turbo_tests2\b},
       %r{/exe/turbo_tests2\b},
-      %r{/lib/turbo_tests(?:\.rb|/)},
+      %r{/lib/turbo_tests(?:\.rb|/)}
     ].freeze
 
     RSpec::Core::Formatters.register(
@@ -38,7 +38,7 @@ module TurboTests
       :message,
       :seed,
       :deprecation,
-      :dump_profile,
+      :dump_profile
     )
 
     attr_reader :output
@@ -50,76 +50,76 @@ module TurboTests
     def start(notification)
       output_row(
         type: :load_summary,
-        summary: load_summary_to_json(notification),
+        summary: load_summary_to_json(notification)
       )
     end
 
     def example_group_started(notification)
       output_row(
         type: :group_started,
-        group: group_to_json(notification),
+        group: group_to_json(notification)
       )
     end
 
     def example_group_finished(notification)
       output_row(
         type: :group_finished,
-        group: group_to_json(notification),
+        group: group_to_json(notification)
       )
     end
 
     def example_passed(notification)
       output_row(
         type: :example_passed,
-        example: example_to_json(notification.example),
+        example: example_to_json(notification.example)
       )
     end
 
     def example_pending(notification)
       output_row(
         type: :example_pending,
-        example: example_to_json(notification.example),
+        example: example_to_json(notification.example)
       )
     end
 
     def example_failed(notification)
       output_row(
         type: :example_failed,
-        example: example_to_json(notification.example),
+        example: example_to_json(notification.example)
       )
     end
 
     def seed(notification)
       output_row(
         type: :seed,
-        seed: notification.seed,
+        seed: notification.seed
       )
     end
 
     def close(_notification)
       output_row(
-        type: :close,
+        type: :close
       )
     end
 
     def message(notification)
       output_row(
         type: :message,
-        message: notification.message,
+        message: notification.message
       )
     end
 
     def deprecation(notification)
       output_row(
         type: :deprecation,
-        deprecation: deprecation_to_json(notification),
+        deprecation: deprecation_to_json(notification)
       )
     end
 
     def dump_profile(notification)
       output_row(
         type: :profile,
-        profile: profile_to_json(notification),
+        profile: profile_to_json(notification)
       )
     end
 
@@ -129,7 +129,7 @@ module TurboTests
       {
         duration: notification.duration,
         number_of_examples: notification.number_of_examples,
-        examples: notification.examples.map { |example| example_to_json(example) },
+        examples: notification.examples.map { |example| example_to_json(example) }
       }
     end
 
@@ -138,7 +138,7 @@ module TurboTests
         deprecated: notification.deprecated,
         message: notification.message,
         replacement: notification.replacement,
-        call_site: notification.call_site,
+        call_site: notification.call_site
       }
     end
 
@@ -149,7 +149,7 @@ module TurboTests
         class_name: exception.class.name.to_s,
         backtrace: filtered_backtrace(exception.backtrace),
         message: exception.message,
-        cause: exception_to_json(exception.cause),
+        cause: exception_to_json(exception.cause)
       }
     end
 
@@ -166,14 +166,14 @@ module TurboTests
         status: result.status,
         pending_fixed?: result.pending_fixed?,
         exception: exception_to_json(result.exception || result.pending_exception),
-        run_time: result.respond_to?(:run_time) ? result.run_time : nil,
+        run_time: result.respond_to?(:run_time) ? result.run_time : nil
       }
     end
 
     def stack_frame_to_json(frame)
       {
         shared_group_name: frame.shared_group_name,
-        inclusion_location: frame.inclusion_location,
+        inclusion_location: frame.inclusion_location
       }
     end
 
@@ -188,24 +188,24 @@ module TurboTests
             example
               .metadata[:shared_group_inclusion_backtrace]
               .map { |frame| stack_frame_to_json(frame) },
-          extra_failure_lines: example.metadata[:extra_failure_lines],
+          extra_failure_lines: example.metadata[:extra_failure_lines]
         },
-        location_rerun_argument: example.location_rerun_argument,
+        location_rerun_argument: example.location_rerun_argument
       }
     end
 
     def load_summary_to_json(notification)
       {
         count: notification.count,
-        load_time: notification.load_time,
+        load_time: notification.load_time
       }
     end
 
     def group_to_json(notification)
       {
         group: {
-          description: notification.group.description,
-        },
+          description: notification.group.description
+        }
       }
     end
 

data/lib/turbo_tests/reporter.rb

@@ -75,7 +75,7 @@ module TurboTests
       delegate_to_formatters(:seed, RSpec::Core::Notifications::SeedNotification.new(@seed, @seed_used))
       delegate_to_formatters(
         :start,
-        RSpec::Core::Notifications::StartNotification.new(expected_example_count, @load_time),
+        RSpec::Core::Notifications::StartNotification.new(expected_example_count, @load_time)
       )
     end
 
@@ -132,7 +132,7 @@ module TurboTests
         deprecated: deprecation[:deprecated],
         message: deprecation[:message],
         replacement: deprecation[:replacement],
-        call_site: deprecation[:call_site],
+        call_site: deprecation[:call_site]
       )
       delegate_to_formatters(:deprecation, notification)
     end
@@ -143,7 +143,7 @@ module TurboTests
         profile[:duration],
         examples,
         profile[:number_of_examples],
-        {},
+        {}
       )
       delegate_to_formatters(:dump_profile, notification)
     end
@@ -158,14 +158,14 @@ module TurboTests
       delegate_to_formatters(
         :dump_pending,
         RSpec::Core::Notifications::ExamplesNotification.new(
-          self,
-        ),
+          self
+        )
       )
       delegate_to_formatters(
         :dump_failures,
         RSpec::Core::Notifications::ExamplesNotification.new(
-          self,
-        ),
+          self
+        )
       )
       delegate_to_formatters(
         :dump_summary,
@@ -175,15 +175,15 @@ module TurboTests
           @failed_examples,
           @pending_examples,
           @load_time,
-          @errors_outside_of_examples_count,
-        ),
+          @errors_outside_of_examples_count
+        )
       )
       delegate_to_formatters(
         :seed,
         RSpec::Core::Notifications::SeedNotification.new(
           @seed,
-          @seed_used,
-        ),
+          @seed_used
+        )
       )
     ensure
       delegate_to_formatters(:close, RSpec::Core::Notifications::NullNotification)

data/lib/turbo_tests/runner.rb

@@ -2,6 +2,7 @@
 
 require "json"
 require "parallel_tests/rspec/runner"
+require "tempfile"
 
 require_relative "../utils/hash_extension"
 
@@ -33,8 +34,10 @@ module TurboTests
         verbose = opts.fetch(:verbose, false)
         fail_fast = opts.fetch(:fail_fast, nil)
         count = opts.fetch(:count, nil)
+        order = normalize_order(opts.fetch(:order, nil))
         seed = opts.fetch(:seed, nil)
-        seed_used = !seed.nil?
+        seed_used = order != "defined"
+        seed = generate_seed if seed_used && seed.nil?
         print_failed_group = opts.fetch(:print_failed_group, false)
         nice = opts.fetch(:nice, false)
 
@@ -66,10 +69,11 @@ module TurboTests
           count: count,
           seed: seed,
           seed_used: seed_used,
+          order: order,
           print_failed_group: print_failed_group,
           use_runtime_info: use_runtime_info,
           parallel_options: parallel_options,
-          nice: nice,
+          nice: nice
         ).run
       end
 
@@ -87,6 +91,18 @@ module TurboTests
         File.write(path, runtimes.sort.map { |file, runtime| "#{file}:#{runtime}" }.join("\n"))
         path
       end
+
+      def normalize_order(order)
+        order = order.to_s.strip.downcase
+        return "random" if order.empty?
+        return order if %w[random defined].include?(order)
+
+        raise ArgumentError, "Unsupported order #{order.inspect}; use random or defined"
+      end
+
+      def generate_seed
+        (Random.new_seed % 65_535).to_s
+      end
     end
 
     def initialize(**opts)
@@ -100,6 +116,7 @@ module TurboTests
       @count = opts[:count]
       @seed = opts[:seed]
       @seed_used = opts[:seed_used]
+      @order = opts[:order]
       @nice = opts[:nice]
       @use_runtime_info = opts[:use_runtime_info]
 
@@ -125,42 +142,44 @@ module TurboTests
     def run
       @num_processes = [
         ParallelTests.determine_number_of_processes(@count),
-        ParallelTests::RSpec::Runner.tests_with_size(@files, {}).size,
+        ParallelTests::RSpec::Runner.tests_with_size(@files, {}).size
       ].min
 
       tests_in_groups =
         ParallelTests::RSpec::Runner.tests_in_groups(
           @files,
           @num_processes,
-          **@parallel_options,
+          **@parallel_options
         )
       @tests_in_groups = tests_in_groups
 
       subprocess_opts = {
-        record_runtime: @record_runtime,
+        record_runtime: @record_runtime
       }
 
-      @reporter.report(tests_in_groups) do |_reporter|
-        old_signal = Signal.trap(:INT) { handle_interrupt }
+      ParallelTests.with_pid_file do
+        @reporter.report(tests_in_groups) do |_reporter|
+          old_signal = Signal.trap(:INT) { handle_interrupt }
 
-        @wait_threads = tests_in_groups.map.with_index do |tests, process_id|
-          start_regular_subprocess(tests, process_id + 1, **subprocess_opts)
-        end.compact
-        @interrupt_handled = false
+          @wait_threads = tests_in_groups.map.with_index do |tests, process_id|
+            start_regular_subprocess(tests, process_id + 1, **subprocess_opts)
+          end.compact
+          @interrupt_handled = false
 
-        handle_messages
+          handle_messages
 
-        @threads.each(&:join)
+          @threads.each(&:join)
 
-        report_failed_group(tests_in_groups) if @print_failed_group
+          report_failed_group(tests_in_groups) if @print_failed_group
 
-        Signal.trap(:INT, old_signal)
+          Signal.trap(:INT, old_signal)
 
-        if @reporter.failed_examples.empty? && @wait_threads.map(&:value).all?(&:success?)
-          0
-        else
-          # From https://github.com/galtzo-floss/turbo_tests2/pull/20/
-          @wait_threads.map { |thread| thread.value.exitstatus }.max
+          if @reporter.failed_examples.empty? && @wait_threads.map(&:value).all?(&:success?)
+            0
+          else
+            # From https://github.com/galtzo-floss/turbo_tests2/pull/20/
+            @wait_threads.map { |thread| thread.value.exitstatus }.max
+          end
         end
       end
     end
@@ -188,11 +207,15 @@ module TurboTests
 
     def start_regular_subprocess(tests, process_id, **opts)
       start_subprocess(
-        {"TEST_ENV_NUMBER" => process_id.to_s},
+        {
+          "TEST_ENV_NUMBER" => process_id.to_s,
+          "PARALLEL_TEST_GROUPS" => @num_processes.to_s,
+          "PARALLEL_PID_FILE" => parallel_pid_file_path
+        },
         @tags.map { |tag| "--tag=#{tag}" },
         tests,
         process_id,
-        **opts,
+        **opts
       )
     end
 
@@ -200,7 +223,7 @@ module TurboTests
       if tests.empty?
         @messages << {
           type: "exit",
-          process_id: process_id,
+          process_id: process_id
         }
 
         nil
@@ -224,7 +247,7 @@ module TurboTests
               "--format",
               "ParallelTests::RSpec::RuntimeLogger",
               "--out",
-              @runtime_log,
+              @runtime_log
             ]
           else
             []
@@ -232,7 +255,11 @@ module TurboTests
 
         seed_option = if @seed_used
           [
-            "--seed", @seed,
+            "--seed", @seed
+          ]
+        elsif @order
+          [
+            "--order", @order
           ]
         else
           []
@@ -248,20 +275,22 @@ module TurboTests
           "TurboTests::JsonRowsFormatter",
           *record_runtime_options,
           *spec_opts,
-          *tests,
+          *tests
         ]
         command.unshift("nice") if @nice
 
         if @verbose
           command_str = [
             env.map { |k, v| "#{k}=#{v}" }.join(" "),
-            command.join(" "),
+            command.join(" ")
           ].select { |x| x.size > 0 }.join(" ")
 
           warn("Process #{process_id}: #{command_str}")
         end
 
+        pid_file_path = env["PARALLEL_PID_FILE"] || parallel_pid_file_path
         stdin, stdout, stderr, wait_thr = Open3.popen3(env, *command)
+        track_parallel_pid(wait_thr.pid, pid_file_path)
         stdin.close
 
         # rubocop:disable ThreadSafety/NewThread
@@ -290,7 +319,12 @@ module TurboTests
 
         # rubocop:disable ThreadSafety/NewThread
         @threads << Thread.new do
-          @messages << {type: "error"} unless wait_thr.value.success?
+          begin
+            status = wait_thr.value
+            @messages << {type: "error"} unless status.success?
+          ensure
+            untrack_parallel_pid(wait_thr.pid, pid_file_path)
+          end
         end
         # rubocop:enable ThreadSafety/NewThread
 
@@ -298,6 +332,18 @@ module TurboTests
       end
     end
 
+    def parallel_pid_file_path
+      ENV["PARALLEL_PID_FILE"]
+    end
+
+    def track_parallel_pid(pid, pid_file_path = parallel_pid_file_path)
+      ParallelTests::Pids.new(pid_file_path).add(pid) if pid && pid_file_path
+    end
+
+    def untrack_parallel_pid(pid, pid_file_path = parallel_pid_file_path)
+      ParallelTests::Pids.new(pid_file_path).delete(pid) if pid && pid_file_path
+    end
+
     def start_copy_thread(src, dst)
       # rubocop:disable ThreadSafety/NewThread
       Thread.new do
@@ -356,9 +402,7 @@ module TurboTests
           @reporter.deprecation(message[:deprecation])
         when "profile"
           @reporter.profile(message[:profile])
-        when "seed"
-        when "close"
-        when "error"
+        when "seed", "close", "error"
           # Do nothing
           nil
         when "exit"

data/lib/turbo_tests/version.rb

@@ -2,7 +2,7 @@
 
 module TurboTests
   module Version
-    VERSION = "3.1.0"
+    VERSION = "3.1.2"
   end
   VERSION = Version::VERSION # Traditional Constant Location
 end

data/lib/turbo_tests.rb

@@ -39,7 +39,7 @@ module TurboTests
         klass.new(
           obj[:backtrace],
           obj[:message],
-          FakeException.from_obj(obj[:cause]),
+          FakeException.from_obj(obj[:cause])
         )
       end
     end
@@ -52,7 +52,7 @@ module TurboTests
     :pending_fixed?,
     :exception,
     :pending_exception,
-    :run_time,
+    :run_time
   )
   class FakeExecutionResult
     class << self
@@ -64,7 +64,7 @@ module TurboTests
           obj[:pending_fixed?],
           FakeException.from_obj(obj[:exception]),
           FakeException.from_obj(obj[:exception]),
-          obj[:run_time],
+          obj[:run_time]
         )
       end
     end
@@ -76,7 +76,7 @@ module TurboTests
     :description,
     :full_description,
     :metadata,
-    :location_rerun_argument,
+    :location_rerun_argument
   )
   class FakeExample
     class << self
@@ -86,7 +86,7 @@ module TurboTests
         metadata[:shared_group_inclusion_backtrace].map! do |frame|
           RSpec::Core::SharedExampleGroupInclusionStackFrame.new(
             frame[:shared_group_name],
-            frame[:inclusion_location],
+            frame[:inclusion_location]
           )
         end
 
@@ -98,14 +98,14 @@ module TurboTests
           obj[:description],
           obj[:full_description],
           metadata,
-          obj[:location_rerun_argument],
+          obj[:location_rerun_argument]
         )
       end
     end
 
     def notification
       RSpec::Core::Notifications::ExampleNotification.for(
-        self,
+        self
       )
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_tests2
 version: !ruby/object:Gem::Version
-  version: 3.1.0
+  version: 3.1.2
 platform: ruby
 authors:
 - Illia
@@ -92,7 +92,7 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.11
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -102,27 +102,27 @@ dependencies:
         version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.1.9
+        version: 1.1.11
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.1.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.1.1
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -177,20 +177,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 3.1.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 3.1.1
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -200,7 +200,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: 2.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -210,7 +210,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: 2.0.3
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -254,7 +254,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
+        version: 2.0.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -264,11 +264,10 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.0
-description: "\U0001F680 `turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
+        version: 2.0.1
+description: "\U0001F680 turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
   and `grosser/parallel_tests` with incremental summarized output. Source code of
-  `turbo_test2` gem is based on Discourse and Rubygems work in this area (see README
-  file of the source repository)."
+  `turbo_test2` gem is based on Discourse and Rubygems work in this area (see README.md)."
 email:
 - floss@galtzo.com
 executables:
@@ -312,10 +311,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://turbo-tests2.galtzo.com
-  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.1.0
-  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.1.0/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.1.2
+  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.1.2/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/turbo_tests2/issues
-  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.1.0
+  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.1.2
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/galtzo-floss/turbo_tests2/wiki
   news_uri: https://www.railsbling.com/tags/turbo_tests2
@@ -323,7 +322,7 @@ metadata:
   rubygems_mfa_required: 'true'
 rdoc_options:
 - "--title"
-- "turbo_tests2 - \U0001F680 `turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
+- "turbo_tests2 - \U0001F680 turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
   and `grosser/parallel_tests` with incremental summarized output"
 - "--main"
 - README.md
@@ -347,6 +346,6 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.10
 specification_version: 4
-summary: "\U0001F680 `turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
+summary: "\U0001F680 turbo_tests2` is a drop-in replacement for `serpapi/turbo_tests`
   and `grosser/parallel_tests` with incremental summarized output"
 test_files: []