turbo_tests2 3.2.6 → 3.2.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 845d3f1bfca237a4f69e92344534dac2dc046098ab5e37eee5b7f37546503b27
-  data.tar.gz: 60a90bd453462fd4cfc42e0c6f7764e8a8caf6226275663de1d9f331342bbb5b
+  metadata.gz: ca871e5dbe65758df84b2abc6d7e7260cd3be66f463262083e51f3dd9b914b8f
+  data.tar.gz: 40920adda29dd8f5dc77dd1ca41dd2349b18838bc8a661ddddc6f277a8ec3b2e
 SHA512:
-  metadata.gz: 5497b5766dfa59eded82f999068c3a2c0ffe63b5e43a4256586e3b16b1396637faea9b617cc10e0fb4dc6e1bf964e421b19efbe973bbd0d0fe793d2d03e32f43
-  data.tar.gz: 157315d9cfdb740907c91f326419313bb8c94cac58580430e6c8c6c6f61318861bce2ad10c021661be4a23b35bee54dd244e1045c8068122095795aa440e271d
+  metadata.gz: 76c25c3e606364c6014377d57c74c270916dee892864d45113483c460ee919dae5da892245268d02e94e3c41d30fd35d787ff97434ec6ffdc109a8d604df73a2
+  data.tar.gz: bf173174ef544f7266cbc8488ba9b67cbb3f95c9aa438da45af1991e71f98f53851933bb55ad4840327ba35887058ca4786ca57a41f1a5034e1b21508878e4e8

data/CHANGELOG.md

@@ -30,6 +30,57 @@ Please file a bug if you notice a violation of semantic versioning.
 
 ### Security
 
+## [3.2.8] - 2026-09-11
+
+- TAG: [v3.2.8][3.2.8t]
+- COVERAGE: 96.75% -- 892/922 lines in 10 files
+- BRANCH COVERAGE: 84.98% -- 232/273 branches in 10 files
+- 36.73% documented
+
+### Added
+
+- Support TURBO_TESTS2_MAX_PROCESSES as an orchestration process ceiling.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 8 project files:
+  - dependencies (8)
+
+- [kc] kettle-jem/template: updated 5 project files:
+  - code and tests (1)
+  - dependencies (3)
+  - other (1)
+
+## [3.2.7] - 2026-08-29
+
+- TAG: [v3.2.7][3.2.7t]
+- COVERAGE: 96.83% -- 885/914 lines in 10 files
+- BRANCH COVERAGE: 85.50% -- 230/269 branches in 10 files
+- 36.73% documented
+
+### Added
+
+- Added `--no-rake-hooks` to run without loading a discoverable Rakefile or
+  invoking the `turbo_tests2:setup` and `turbo_tests2:cleanup` hooks.
+
+### Changed
+
+- [kc] kettle-jem/prepare: updated 40 project files:
+  - configuration (1)
+  - dependencies (35)
+  - other (4)
+- [kc] kettle-jem/template: updated 6 project files:
+  - code and tests (1)
+  - dependencies (2)
+  - other (2)
+  - workflows (1)
+
+### Fixed
+
+- Running `turbo_tests2` no longer requires a Rakefile merely because the
+  `rake` gem is installed; Rake hooks are skipped when no Rakefile is
+  discoverable.
+
 ## [3.2.6] - 2026-08-13
 
 - TAG: [v3.2.6][3.2.6t]
@@ -535,7 +586,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.2.6...HEAD
+[Unreleased]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.8...HEAD
+[3.2.8]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.7...v3.2.8
+[3.2.8t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.2.8
+[3.2.7]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.6...v3.2.7
+[3.2.7t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.2.7
 [3.2.6]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.5...v3.2.6
 [3.2.6t]: https://github.com/galtzo-floss/turbo_tests2/releases/tag/v3.2.6
 [3.2.5]: https://github.com/galtzo-floss/turbo_tests2/compare/v3.2.4...v3.2.5

data/LICENSE.md

@@ -7,15 +7,15 @@ Choose the option that best fits your use case:
 
 ## Copyright Notice
 
-- Copyright (c) 2020-2023 Illia
+- Copyright (c) 2020-2024 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 Hiroshi SHIBATA
 - Copyright (c) 2025-2026 Gareth Jones
 - Copyright (c) 2025-2026 Peter H. Boling
+- Copyright (c) 2026 Jeff Widman

data/README.md

@@ -120,7 +120,9 @@ The _amazing_ test matrix is powered by the kettle-dev stack.
 
 </details>
 
-### Enterprise Support [![Tidelift](https://tidelift.com/badges/package/rubygems/turbo_tests2)](https://tidelift.com/subscription/pkg/rubygems-turbo_tests2?utm_source=rubygems-turbo_tests2&utm_medium=referral&utm_campaign=readme)
+### Enterprise Support
+
+[![Tidelift](https://tidelift.com/badges/package/rubygems/turbo_tests2)](https://tidelift.com/subscription/pkg/rubygems-turbo_tests2?utm_source=rubygems-turbo_tests2&utm_medium=referral&utm_campaign=readme)
 
 Available as part of the Tidelift Subscription.
 
@@ -218,6 +220,7 @@ Options:
         --no-random                  Run examples in defined order without passing a seed
         --create                     Create databases
         --print_failed_group         Prints group that had failures in it
+        --no-rake-hooks              Do not load a Rakefile or invoke setup and cleanup hooks
         --nice                       execute test commands with low priority
 ```
 
@@ -313,6 +316,12 @@ streams from the parent process as workers report examples. Use
 worker stdout/stderr is handled. A CLI flag takes precedence over the
 environment variable.
 
+`TURBO_TESTS2_MAX_PROCESSES=N` supplies a positive inclusive process ceiling
+when neither `--count` nor `--workers` is present. This is intended for an
+outer orchestrator such as `kettle-family`; explicit CLI process counts always
+take precedence. As with `--count`, the runner also caps the actual process
+count at the number of discovered test groups.
+
 | Mode | Behavior |
 |------|----------|
 | `warnings` | Default. Buffer raw worker output, print warning/deprecation lines after successful runs, and print full buffered raw output on failures. |
@@ -331,8 +340,10 @@ bundle exec turbo_tests2 -r fuubar -f Fuubar spec/whatever
 
 ### Rake Hooks
 
-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:
+If Rake and a Rakefile are present, the CLI will invoke the tasks `turbo_tests2:setup` and
+`turbo_tests2:cleanup` before and after running the test suite. If no Rakefile is discoverable,
+the test suite runs without hooks. These tasks can be used to do work that should only happen
+once, such as removing files or collating coverage:
 
 ```ruby
 # lib/tasks/turbo_tests2.rake
@@ -349,6 +360,14 @@ namespace :turbo_tests2 do
 end
 ```
 
+Projects with a discoverable Rakefile can disable this integration explicitly:
+
+```bash
+bundle exec turbo_tests2 --no-rake-hooks
+```
+
+This prevents the Rakefile from being loaded and skips both hooks.
+
 ### SimpleCov
 
 You can get accurate coverage reporting by having SimpleCov write the results for each process into a different directory
@@ -528,18 +547,18 @@ See [LICENSE.md][📄license] for the official copyright notice.
 <details markdown="1">
 <summary>Copyright holders</summary>
 
-- Copyright (c) 2020-2023 Illia
+- Copyright (c) 2020-2024 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 Hiroshi SHIBATA
 - Copyright (c) 2025-2026 Gareth Jones
 - Copyright (c) 2025-2026 Peter H. Boling
+- Copyright (c) 2026 Jeff Widman
 
 </details>
 
@@ -756,7 +775,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.909-FFDD67.svg?style=for-the-badge&logo=YouTube&logoColor=blue
+[🧮kloc-img]: https://img.shields.io/badge/KLOC-0.922-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

data/lib/turbo_tests/cli.rb

@@ -25,6 +25,7 @@ module TurboTests
       print_failed_group = false
       create = false
       nice = false
+      rake_hooks = true
       worker_output = nil
       parallel_options = {}
       cli_args, parallel_args = split_parallel_args(@argv)
@@ -159,6 +160,10 @@ module TurboTests
           print_failed_group = true
         end
 
+        opts.on("--no-rake-hooks", "Do not load a Rakefile or invoke setup and cleanup hooks") do
+          rake_hooks = false
+        end
+
         opts.on("--nice", "execute test commands with low priority") do
           nice = true
         end
@@ -170,6 +175,11 @@ module TurboTests
         return TurboTests::Runner.create(count)
       end
 
+      # Family orchestration supplies an inclusive ceiling for the complete
+      # test process pool. A command-line count remains the explicit operator
+      # choice, so it always wins over the inherited budget.
+      count ||= max_processes_from_environment
+
       requires.each { |f| require(f) }
 
       if formatters.empty?
@@ -183,9 +193,10 @@ module TurboTests
         formatter[:outputs] << "-" if formatter[:outputs].empty?
       end
 
-      load_rake
-
-      invoke_rake_hook("setup")
+      if rake_hooks
+        load_rake
+        invoke_rake_hook("setup")
+      end
 
       files = cli_args.empty? ? nil : cli_args
 
@@ -206,7 +217,7 @@ module TurboTests
         parallel_options: parallel_options
       )
 
-      invoke_rake_hook("cleanup")
+      invoke_rake_hook("cleanup") if rake_hooks
 
       # From https://github.com/galtzo-floss/turbo_tests2/pull/20/
       exit(exitstatus)
@@ -232,6 +243,18 @@ module TurboTests
       ]
     end
 
+    def max_processes_from_environment
+      value = ENV.fetch("TURBO_TESTS2_MAX_PROCESSES", "").strip
+      return if value.empty?
+
+      count = Integer(value, 10)
+      return count if count.positive?
+
+      raise OptionParser::InvalidArgument, "invalid TURBO_TESTS2_MAX_PROCESSES #{value.inspect}; expected a positive integer"
+    rescue ArgumentError
+      raise OptionParser::InvalidArgument, "invalid TURBO_TESTS2_MAX_PROCESSES #{value.inspect}; expected a positive integer"
+    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|
@@ -412,6 +435,8 @@ module TurboTests
       # which may contain non-Rake arguments (e.g. RSpec's --pattern flag when
       # tests are run via `rake spec`).
       Rake.application.init("rake", [])
+      return unless Rake.application.find_rakefile_location
+
       Rake.application.load_rakefile
     end
 

data/lib/turbo_tests/version.rb

@@ -4,7 +4,7 @@ module TurboTests
   # Version namespace for this gem.
   module Version
     # Current gem version.
-    VERSION = "3.2.6"
+    VERSION = "3.2.8"
   end
   # Current gem version exposed at the traditional constant location.
   VERSION = Version::VERSION # Traditional Constant Location

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_tests2
 version: !ruby/object:Gem::Version
-  version: 3.2.6
+  version: 3.2.8
 platform: ruby
 authors:
 - Illia
@@ -15,6 +15,7 @@ authors:
 - Hiroshi SHIBATA
 - Gareth Jones
 - Peter H. Boling
+- Jeff Widman
 bindir: exe
 cert_chain:
 - |
@@ -107,20 +108,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.6
+        version: 3.1.0
   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.0
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
@@ -198,7 +199,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.2
+        version: 3.2.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -208,7 +209,7 @@ dependencies:
         version: '3.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.2.2
+        version: 3.2.3
 - !ruby/object:Gem::Dependency
   name: kettle-test
   requirement: !ruby/object:Gem::Requirement
@@ -218,7 +219,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.19
+        version: 2.0.21
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -228,7 +229,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.19
+        version: 2.0.21
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -252,7 +253,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.8
+        version: 1.0.9
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -262,7 +263,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.8
+        version: 1.0.9
 - !ruby/object:Gem::Dependency
   name: gitmoji-regex
   requirement: !ruby/object:Gem::Requirement
@@ -272,7 +273,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.12
+        version: 2.0.13
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -282,7 +283,7 @@ dependencies:
         version: '2.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.0.12
+        version: 2.0.13
 description: "\U0001F680 turbo_tests2` is an RSpec parallel test runner built on `parallel_tests`.
   It uses `parallel_tests` for process counts, file grouping, and runtime balancing,
   then replaces interleaved worker output with incremental summarized RSpec reporting.
@@ -314,10 +315,10 @@ licenses:
 - MIT
 metadata:
   homepage_uri: https://turbo-tests2.galtzo.com
-  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.2.6
-  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.2.6/CHANGELOG.md
+  source_code_uri: https://github.com/galtzo-floss/turbo_tests2/tree/v3.2.8
+  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.2.8/CHANGELOG.md
   bug_tracker_uri: https://github.com/galtzo-floss/turbo_tests2/issues
-  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.2.6
+  documentation_uri: https://www.rubydoc.info/gems/turbo_tests2/3.2.8
   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