parallel_tests 5.6.0 → 5.8.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34db466ecb3d4a72ee1d4f44ebb67bd4676a93df745163aa0fb2cd981365ec1a
-  data.tar.gz: e90ab9fdf7af7a731e5586036dc0b305ae37464caa77e481736ff1919754d7fa
+  metadata.gz: '092bd037e5c9728f7274bddb7490af927fca7c80f2504d79f23b3344da77c39b'
+  data.tar.gz: 6562747c26170da4848f852ca7ef76fbd9cff2378899f0ec1b88302de9046aa9
 SHA512:
-  metadata.gz: a42a001f0d39194e71db4900d9b979bbb6ccfd7ec947bf6b0d9e68d351badc1f4b453228a5e22a9ab56783ae1ed16f3bc2911f93c68aa9eb82e945ef0896bbbf
-  data.tar.gz: 5872ee0b123aed1e52ef43f5eb1785c9bb653351be215c2b00ff2665e2e5debab7b27b6f8a00f6d2b8af9f23080ea0d976b00b2ffb056d1c5eb8026f570bc7b1
+  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

@@ -30,40 +30,22 @@ test:
   database: yourproject_test<%= ENV['TEST_ENV_NUMBER'] %>
 ```
 
-### Create additional database(s)
+### Create additional test database(s)
     rake parallel:create
+    rake parallel:create:<database> # if using multi-db setup, <database> would be `secondary` for example
 
-### (Multi-DB) Create individual database
-    rake parallel:create:<database>
-    rake parallel:create:secondary
-
-### Copy development schema (repeat after migrations)
+### Copy development schema into all test databases (repeat after migrations)
     rake parallel:prepare
 
-### Run migrations in additional database(s) (repeat after migrations)
-    rake parallel:migrate
-
-### (Multi-DB) Run migrations in individual database
-    rake parallel:migrate:<database>
-
-### Setup environment from scratch (create db and loads schema, useful for CI)
-    rake parallel:setup
-
-### Drop all test databases
-    rake parallel:drop
-
-### (Multi-DB) Drop individual test database
-    rake parallel:drop:<database>
-
 ### Run!
-    rake parallel:test          # Minitest
-    rake parallel:spec          # RSpec
-    rake parallel:features      # Cucumber
-    rake parallel:features-spinach       # Spinach
+    rake parallel:test              # Minitest
+    rake parallel:spec              # RSpec
+    rake parallel:features          # Cucumber
+    rake parallel:features-spinach  # Spinach
 
     rake "parallel:test[1]" --> force 1 CPU --> 86 seconds
-    rake parallel:test    --> got 2 CPUs? --> 47 seconds
-    rake parallel:test    --> got 4 CPUs? --> 26 seconds
+    rake parallel:test      --> got 2 CPUs? --> 47 seconds
+    rake parallel:test      --> got 4 CPUs? --> 26 seconds
     ...
 
 Test by pattern with Regex (e.g. use one integration server per subfolder / see if you broke any 'user'-related tests)
@@ -92,6 +74,17 @@ rake "parallel:rake[my:custom:task]"
 rake "parallel:rake[my:custom:task,2]"
 ```
 
+### Run migrations in all test databases (repeat after migrations)
+    rake parallel:migrate
+    rake parallel:migrate:<database> # for multi-db setup
+
+### Setup environment from scratch (create db and loads schema, useful for CI)
+    rake parallel:setup
+
+### Drop all test databases
+    rake parallel:drop
+    rake parallel:drop:<database> # for multi-db setup
+
 
 Running setup or teardown once
 ===================
@@ -144,7 +137,9 @@ Rspec: Add to your `.rspec_parallel` (or `.rspec`), but can also be used via `--
 
 Add to your `test_helper.rb`:
 ```ruby
+
 if ENV['RECORD_RUNTIME']
+   require 'minitest'
    require 'parallel_tests/test/runtime_logger'
    # ParallelTests::Test::RuntimeLogger.logfile = "tmp/parallel_runtime_test.log" # where to write it
 end
@@ -262,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/tasks.rb

@@ -203,8 +203,6 @@ namespace :parallel do
       # fast: dump once, load in parallel
       type = ParallelTests::Tasks.schema_type_based_on_rails_version
 
-      Rake::Task["db:#{type}:dump"].invoke
-
       # remove database connection to prevent "database is being accessed by other users"
       ActiveRecord::Base.remove_connection if ActiveRecord::Base.configurations.any?
 

data/lib/parallel_tests/version.rb

@@ -1,4 +1,4 @@
 # frozen_string_literal: true
 module ParallelTests
-  VERSION = '5.6.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.6.0
+  version: 5.8.0
 platform: ruby
 authors:
 - Michael Grosser
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-02-05 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.6.0/CHANGELOG.md
-  documentation_uri: https://github.com/grosser/parallel_tests/blob/v5.6.0/Readme.md
-  source_code_uri: https://github.com/grosser/parallel_tests/tree/v5.6.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:
   - - ">="