parallel_tests 5.7.0 → 5.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f1e67ef9a02b33a054474fc052eb824f47220fd9da0451990e324269007f317a
-  data.tar.gz: fae078645fa22ef747f19cfd302151df284a493977f8c791fa8b6c05c4419a7c
+  metadata.gz: '092bd037e5c9728f7274bddb7490af927fca7c80f2504d79f23b3344da77c39b'
+  data.tar.gz: 6562747c26170da4848f852ca7ef76fbd9cff2378899f0ec1b88302de9046aa9
 SHA512:
-  metadata.gz: 5a124362dbf263564e987bbfef5538c0c6de8233aa35113cacf4eb51d773051d28f07bde7d12148fd07f9c39d5d4b6ab6d5e30d99a851b973e2b820e7dd5c4a4
-  data.tar.gz: 46c6e22f663dc9140c408d1424a576181d9de81d463925fc65d70bd5ee3a118f4eb6f3b078077e944d1f1b4c80b761442de5d20c76dbb8af701ab7f9bdfcfa3a
+  metadata.gz: 81ae4c12dc1e4dbd17c3b52d7b0d7b0e46ea74f97e54a467029576f550a51ecf4ba4809c473c86a82ba2bf6325ea08cd260a9e14c64a27b0785fb6f0aa1f86d6
+  data.tar.gz: 82a9c37846b5eed1eb39f07d4fbab82b1aeb820d643f3713b080ff28d62777c4b74b9ce7ec20e187c27b111ce4c031c1c490cfad3cce854bc9c9245041e7c582

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Grosser
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/Readme.md

@@ -257,18 +257,19 @@ Options are:
         --isolate-n PROCESSES        Use 'isolate'  singles with number of processes, default: 1
         --highest-exit-status        Exit with the highest exit status provided by test run(s)
         --failure-exit-code INT      Specify the exit code to use when tests fail
-        --specify-groups SPECS       Use 'specify-groups' if you want to specify multiple specs running in multiple
-                                     processes in a specific formation. Commas indicate specs in the same process,
-                                     pipes indicate specs in a new process. If SPECS is a '-' the value for this
-                                     option is read from STDIN instead. Cannot use with --single, --isolate, or
-                                     --isolate-n.  Ex.
-                                     $ parallel_tests -n 3 . --specify-groups '1_spec.rb,2_spec.rb|3_spec.rb'
-                                       Process 1 will contain 1_spec.rb and 2_spec.rb
-                                       Process 2 will contain 3_spec.rb
-                                       Process 3 will contain all other specs
+        --specify-groups SPECS       Specify multiple specs running in multiple processes in a given formation.
+                                     Commas separates specs in the same process, pipes separate processes.
+                                     Spec not mentioned are run in a separate process. 
+                                     With '-' the value is read from STDIN. 
+                                     Cannot use with --single, --isolate, or --isolate-n.
+                                     parallel_tests -n 3 . --specify-groups '1_spec.rb,2_spec.rb|3_spec.rb'
+                                     Process 1 = 1_spec.rb + 2_spec.rb, Process 2 = 3_spec.rb, Process 3 = remainder
         --only-group GROUP_INDEX[,GROUP_INDEX]
-                                     Only run the given group numbers.
-                                     Changes `--group-by` default to 'filesize'.
+                                     Only run the given group numbers. Changes `--group-by` default to 'filesize'.
+        --only-group-continuous-test-env
+                                     Instead of resetting `ENV['TEST_ENV_NUMBER']` when using `--only-group`, the env matches the group index`.
+                                     Use when running in parallel with shared resources.
+                                     Requires `--only-group`.
     -e, --exec COMMAND               execute COMMAND in parallel and with ENV['TEST_ENV_NUMBER']
         --exec-args COMMAND          execute COMMAND in parallel with test files as arguments, for example:
                                      $ parallel_tests --exec-args echo

data/lib/parallel_tests/cli.rb

@@ -82,6 +82,11 @@ module ParallelTests
 
         report_number_of_tests(groups) unless options[:quiet]
         test_results = execute_in_parallel(groups, groups.size, options) do |group, index|
+          if options[:only_group] && options[:only_group_continuous_test_env]
+            # Here's where we "sync" the index. Since only_group is numerical, we need `- 1` to make it an index
+            # e.g. --only-group=1,4 should yield index 0 & 3 instead of 0 & 1
+            index = options[:only_group][index] - 1
+          end
           run_tests(group, index, num_processes, options)
         end
         report_results(test_results, options) unless options[:quiet]
@@ -256,28 +261,33 @@ module ParallelTests
         opts.on(
           "--specify-groups SPECS",
           heredoc(<<~TEXT, newline_padding)
-            Use 'specify-groups' if you want to specify multiple specs running in multiple
-            processes in a specific formation. Commas indicate specs in the same process,
-            pipes indicate specs in a new process. If SPECS is a '-' the value for this
-            option is read from STDIN instead. Cannot use with --single, --isolate, or
-            --isolate-n.  Ex.
-            $ parallel_tests -n 3 . --specify-groups '1_spec.rb,2_spec.rb|3_spec.rb'
-              Process 1 will contain 1_spec.rb and 2_spec.rb
-              Process 2 will contain 3_spec.rb
-              Process 3 will contain all other specs
+            Specify multiple specs running in multiple processes in a given formation.
+            Commas separates specs in the same process, pipes separate processes.
+            Spec not mentioned are run in a separate process.
+            With '-' the value is read from STDIN.
+            Cannot use with --single, --isolate, or --isolate-n.
+            parallel_tests -n 3 . --specify-groups '1_spec.rb,2_spec.rb|3_spec.rb'
+            Process 1 = 1_spec.rb + 2_spec.rb, Process 2 = 3_spec.rb, Process 3 = remainder
           TEXT
         ) { |groups| options[:specify_groups] = groups }
 
         opts.on(
           "--only-group GROUP_INDEX[,GROUP_INDEX]",
           Array,
+          "Only run the given group numbers. Changes `--group-by` default to 'filesize'."
+        ) { |groups| options[:only_group] = groups.map(&:to_i) }
+
+        opts.on(
+          "--only-group-continuous-test-env",
           heredoc(<<~TEXT, newline_padding)
-            Only run the given group numbers.
-            Changes `--group-by` default to 'filesize'.
+            Instead of resetting `ENV['TEST_ENV_NUMBER']` when using `--only-group`, the env matches the group index`.
+            Use when running in parallel with shared resources.
+            Requires `--only-group`.
           TEXT
-        ) { |groups| options[:only_group] = groups.map(&:to_i) }
+        ) { options[:only_group_continuous_test_env] = true }
 
         opts.on("-e", "--exec COMMAND", "execute COMMAND in parallel and with ENV['TEST_ENV_NUMBER']") { |arg| options[:execute] = Shellwords.shellsplit(arg) }
+
         opts.on(
           "--exec-args COMMAND",
           heredoc(<<~TEXT, newline_padding)
@@ -334,16 +344,20 @@ module ParallelTests
         opts.on("--verbose-process-command", "Print the command that will be executed by each process before it begins") { options[:verbose_process_command] = true }
         opts.on("--verbose-rerun-command", "After a process fails, print the command executed by that process") { options[:verbose_rerun_command] = true }
         opts.on("--quiet", "Print only tests output") { options[:quiet] = true }
+
         opts.on("-v", "--version", "Show Version") do
           puts ParallelTests::VERSION
           exit 0
         end
+
         opts.on("-h", "--help", "Show this.") do
           puts opts
           exit 0
         end
       end.parse!(argv)
 
+      raise "--only-group is required for --only-group-continuous-test-env" if options[:only_group_continuous_test_env] && !options[:only_group]
+
       raise "Both options are mutually exclusive: verbose & quiet" if options[:verbose] && options[:quiet]
 
       if options[:count] == 0
@@ -375,6 +389,9 @@ module ParallelTests
       if !allowed.include?(options[:group_by]) && options[:only_group]
         raise "--group-by #{allowed.join(" or ")} is required for --only-group"
       end
+      if options[:only_group]&.any? { |g| g <= 0 }
+        raise '--only-group should be >= 0'
+      end
 
       if options[:specify_groups] && options.keys.intersect?([:single_process, :isolate, :isolate_count])
         raise "Can't pass --specify-groups with any of these keys: --single, --isolate, or --isolate-n"

data/lib/parallel_tests/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module ParallelTests
-  VERSION = '5.7.0'
+  VERSION = '5.8.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: parallel_tests
 version: !ruby/object:Gem::Version
-  version: 5.7.0
+  version: 5.8.0
 platform: ruby
 authors:
 - Michael Grosser
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-09 00:00:00.000000000 Z
+date: 2026-09-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: parallel
@@ -34,6 +34,7 @@ executables:
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
 - Readme.md
 - bin/parallel_cucumber
 - bin/parallel_rspec
@@ -69,9 +70,9 @@ licenses:
 - MIT
 metadata:
   bug_tracker_uri: https://github.com/grosser/parallel_tests/issues
-  changelog_uri: https://github.com/grosser/parallel_tests/blob/v5.7.0/CHANGELOG.md
-  documentation_uri: https://github.com/grosser/parallel_tests/blob/v5.7.0/Readme.md
-  source_code_uri: https://github.com/grosser/parallel_tests/tree/v5.7.0
+  changelog_uri: https://github.com/grosser/parallel_tests/blob/v5.8.0/CHANGELOG.md
+  documentation_uri: https://github.com/grosser/parallel_tests/blob/v5.8.0/Readme.md
+  source_code_uri: https://github.com/grosser/parallel_tests/tree/v5.8.0
   wiki_uri: https://github.com/grosser/parallel_tests/wiki
   rubygems_mfa_required: 'true'
 post_install_message:
@@ -82,7 +83,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="