turbo_tests2 3.1.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d311bffe032ad5025cceb6e487460d7e1c0d1e87cc07134eafb4f41bdc63d515
-  data.tar.gz: 0a07a421cad5fadb52d3c417fd0626f80159e4757d8a393fe3ac4912c343dba5
+  metadata.gz: 60ede4cd429a0a25151b01cd9f0bcddbafb8002e048e55b4aef4dbb47d5fa5d8
+  data.tar.gz: 7b64b241458249d78ff9b632ecc7679fc5e27620f8f36aea0d1f4170236c9cd9
 SHA512:
-  metadata.gz: f9745db1b03fd8ef015807cab9518079449ffa6d033d898141eec7f815edbd1dcb1a95f9bf7fd361d6e429d8573fa0668ef7b4ca295c2ad116d72bbb63d35c53
-  data.tar.gz: fe28b347bae32babcdfc80fcf1523b43f54c17dd3726eaeae5e6c4101127685a967e80ef4789c13b47bb16e682282ab5318f9a89b6cce0a16984235128143450
+  metadata.gz: a24112e4b8d4280f937aa5b9617cfa6367c4aef082750e819ac76a12681ab596ad8bf2f72c5701833f4efe29e33de89a4eed316422e4b341fb781f2addba3ef5
+  data.tar.gz: 34da19c8fbeee18e9541c488c34c8045f8a9ea5f2628b679339c6cbb0160e492fa7b9b21231ca6ecb30685826c27206788d58c6512a4ffc18e7f34728ca625df

data/CHANGELOG.md

@@ -28,8 +28,30 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Fixed
 
+- 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.
+
 ### Security
 
+## [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 +114,9 @@ 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.1...HEAD
+[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

@@ -18,5 +18,5 @@ 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 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"><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="12%" align="right"/></a> <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="12%" 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">
@@ -217,12 +208,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 +247,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 +430,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 +454,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 +644,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.670-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 +670,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/lib/turbo_tests/cli.rb

@@ -52,11 +52,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 +68,7 @@ module TurboTests
           if formatters.empty?
             formatters << {
               name: "progress",
-              outputs: [],
+              outputs: []
             }
           end
           formatters.last[:outputs] << filename
@@ -89,7 +89,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
@@ -121,7 +121,7 @@ module TurboTests
       if formatters.empty?
         formatters << {
           name: "progress",
-          outputs: [],
+          outputs: []
         }
       end
 
@@ -131,7 +131,7 @@ module TurboTests
 
       load_rake
 
-      invoke_rake_task("turbo_tests:setup")
+      invoke_rake_hook("setup")
 
       files = @argv.empty? ? ["spec"] : @argv
       parallel_options = {}
@@ -148,10 +148,10 @@ module TurboTests
         seed: seed,
         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 +187,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 +243,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 +270,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"
 
@@ -69,7 +70,7 @@ module TurboTests
           print_failed_group: print_failed_group,
           use_runtime_info: use_runtime_info,
           parallel_options: parallel_options,
-          nice: nice,
+          nice: nice
         ).run
       end
 
@@ -125,42 +126,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 +191,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 +207,7 @@ module TurboTests
       if tests.empty?
         @messages << {
           type: "exit",
-          process_id: process_id,
+          process_id: process_id
         }
 
         nil
@@ -224,7 +231,7 @@ module TurboTests
               "--format",
               "ParallelTests::RSpec::RuntimeLogger",
               "--out",
-              @runtime_log,
+              @runtime_log
             ]
           else
             []
@@ -232,7 +239,7 @@ module TurboTests
 
         seed_option = if @seed_used
           [
-            "--seed", @seed,
+            "--seed", @seed
           ]
         else
           []
@@ -248,20 +255,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 +299,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 +312,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 +382,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.1"
   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.1
 platform: ruby
 authors:
 - Illia
@@ -112,7 +112,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.0.7
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -122,7 +122,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.5
+        version: 2.0.7
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -200,7 +200,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.1
+        version: 2.0.2
   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.2
 - !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.1
+  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.1.1/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.1
   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: []