turbo_tests2 3.1.1 → 3.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 60ede4cd429a0a25151b01cd9f0bcddbafb8002e048e55b4aef4dbb47d5fa5d8
-  data.tar.gz: 7b64b241458249d78ff9b632ecc7679fc5e27620f8f36aea0d1f4170236c9cd9
+  metadata.gz: 3f7e32f7c287251c9f42dc998ba6b717d2977f1f8d741de4f1f0fb774089589b
+  data.tar.gz: fffd71116b9ce2d824896c779feaa53d467fece2e8e649074690c9e98752a035
 SHA512:
-  metadata.gz: a24112e4b8d4280f937aa5b9617cfa6367c4aef082750e819ac76a12681ab596ad8bf2f72c5701833f4efe29e33de89a4eed316422e4b341fb781f2addba3ef5
-  data.tar.gz: 34da19c8fbeee18e9541c488c34c8045f8a9ea5f2628b679339c6cbb0160e492fa7b9b21231ca6ecb30685826c27206788d58c6512a4ffc18e7f34728ca625df
+  metadata.gz: 8b35cc849e52d2c7963fdfa1f51a558261cd7fc0ee00b63c04c7d4d8170fa515aaf0a51717e9bf1fb1bf2e6b2c8eaa19a67f2aac1f9bbbe7ffacdc20140ed4da
+  data.tar.gz: d24ee3ba58ec58d7d942d1f9fc5617fa1d12e34efbc8a65dc5a1db52018af5660a287c7f9c08ce207061ba0d71ecc5727506f92b01bbcc80dda112e0251fb547

data/CHANGELOG.md

@@ -28,10 +28,22 @@ 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.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]
@@ -114,7 +126,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.1...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

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-2026 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,4 +1,4 @@
-<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>
+<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
 
@@ -181,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
@@ -644,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.670-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

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
@@ -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
@@ -146,6 +155,7 @@ module TurboTests
         fail_fast: fail_fast,
         count: count,
         seed: seed,
+        order: order,
         nice: nice,
         print_failed_group: print_failed_group,
         parallel_options: parallel_options

data/lib/turbo_tests/runner.rb

@@ -34,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)
 
@@ -67,6 +69,7 @@ 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,
@@ -88,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)
@@ -101,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]
 
@@ -241,6 +257,10 @@ module TurboTests
           [
             "--seed", @seed
           ]
+        elsif @order
+          [
+            "--order", @order
+          ]
         else
           []
         end

data/lib/turbo_tests/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_tests2
 version: !ruby/object:Gem::Version
-  version: 3.1.1
+  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.7
+        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.7
+        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.2
+        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.2
+        version: 2.0.3
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -311,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.1
-  changelog_uri: https://github.com/galtzo-floss/turbo_tests2/blob/v3.1.1/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.1
+  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