polyrun 2.2.0 → 2.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b7bedc5bda9c9ee341927dab2ba6aedafaebe4c26ad73750d8ed7ad4845f4e3
-  data.tar.gz: bac9cd71c5ab3372c0ff5dda891dd354a0ceaac3555f5949870ce8611646debc
+  metadata.gz: a2d28bc9ddd04cf7beebdf3dc7588b61c32c5a17b9c2c97dc25a0135f84c0bef
+  data.tar.gz: 36dbe2a44021aeb42ef235fbddc994cfe823bac129bfe284f8945d60408f06fa
 SHA512:
-  metadata.gz: fe09eaccf1eaf3fba5a998d49f2f2df9cfd6a1da6b1eef960e6cbe894f2269b05777be459fe394a67c3038d72750a8401ae8e224726901ac4bd437e3d01a93ed
-  data.tar.gz: f8090b77fba080b7ca1996afeec0c2680ca26e0d0a4571453210f421f4921685bd8c5bcfeb79724556e377ff26968a914b52bf24b4a1a433a9500d656aa43f41
+  metadata.gz: 701f77a58aad54da7963043a54065cf5a11b4905fbfe6fdb20a25345fa0bc7f5b9fe62730e3828cce94b3203986b99d2f724848bfca56c67815d538723bf0602
+  data.tar.gz: 6591a3dae32970c56b8f329cb7caec8a36b53d25d20ad882dadf8a8d059dad4bcacd97015d8f5cfb822ed7cf0c7b49c03662ede103f3530e4f80f07a7a1f6213

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 # CHANGELOG
 
+## 2.2.2 (2026-07-25)
+
+- BREAKING: Require Ruby 3.4 or newer
+- Fix `Process.spawn` for string worker commands so the command is one argv element instead of character-splatted
+- Drain remaining worker pipe output when the forwarder hits `IOError` or `Errno::EPIPE`
+
+## 2.2.1 (2026-07-13)
+
+- Fix per-example timeout leaving ActiveRecord connection pools in a bad state after `Timeout` interrupts database I/O; disconnect all pools on timeout (adapter-agnostic).
+- Fix `DEBUG_PROSOPITE=1`, `DEBUG_SQL` / `POLYRUN_DEBUG_SQL`, and `DEBUG_TRACE` / `POLYRUN_DEBUG_TRACE` requiring `POLYRUN_EXAMPLE_DEBUG=1`; each flag is standalone again.
+
 ## 2.2.0 (2026-07-13)
 
 - Fix `install_example_rails_logging!` raising `NameError` when example-debug Rails logging runs under `POLYRUN_EXAMPLE_DEBUG=1`.

data/CONTRIBUTING.md

@@ -47,7 +47,6 @@ bundle exec rake bench_performance
 Run the suite under alternate Ruby constraints (see `Appraisals` and `gemfiles/`):
 
 ```bash
-bundle exec appraisal ruby32 rspec
 bundle exec appraisal ruby34 rspec
 bundle exec appraisal ruby40 rspec
 ```

data/README.md

@@ -197,6 +197,19 @@ See [`examples/README.md`](examples/README.md) for Rails apps (Capybara, Playwri
 
 You can replace SimpleCov and simplecov plugins, parallel_tests, and rspec_junit_formatter with Polyrun for those roles. Use `merge-timing`, `report-timing`, and `Data::FactoryCounts` (optionally with `Data::FactoryInstrumentation`) for slow-file and factory metrics. YAML fixture batches and bulk inserts can use `Data::Fixtures` and `ParallelProvisioning` for shard-aware seeding; wire your own `truncate` and `load_seed` in hooks.
 
+## Links
+
+- [GitHub](https://github.com/amkisko/polyrun.rb)
+- [GitLab](https://gitlab.com/amkisko/polyrun.rb)
+- [RubyGems](https://rubygems.org/gems/polyrun)
+- [Versions Atom](https://rubygems.org/gems/polyrun/versions.atom) (feed id `10936755433440`)
+- [libraries.io](https://libraries.io/rubygems/polyrun)
+- [Deps.dev](https://deps.dev/rubygems/polyrun)
+- [SonarCloud](https://sonarcloud.io/project/overview?id=amkisko_polyrun.rb)
+- [Snyk](https://snyk.io/test/github/amkisko/polyrun.rb)
+- [Codecov](https://app.codecov.io/github/amkisko/polyrun.rb)
+- [OpenSSF Scorecard](https://scorecard.dev/viewer/?uri=github.com/amkisko/polyrun.rb)
+
 ## License
 
 Released under the [MIT License](LICENSE). Copyright (c) 2026 Andrei Makarov.

data/docs/SETUP_PROFILE.md

@@ -69,14 +69,14 @@ Orchestration tracing stays on `DEBUG=1` / `POLYRUN_DEBUG=1`. Per-example toolin
 
 | Env | Effect |
 |--------|--------|
-| `POLYRUN_EXAMPLE_DEBUG=1` | Enable example debug installers |
+| `POLYRUN_EXAMPLE_DEBUG=1` | Enable print helpers, Rails logging; disable per-example timeouts |
 | `POLYRUN_DEBUG_SQL=1` or `DEBUG_SQL=1` | Log mutating SQL |
 | `POLYRUN_DEBUG_TRACE=1` or `DEBUG_TRACE=1` | TracePoint under app root |
 | `DEBUG_PROSOPITE=1` | Prosopite N+1 scan when gem is loaded |
 | `DEBUG_LOG_LEVEL` | Rails / ActiveRecord logger severity: `debug`, `info`, `warn`, `error`, `fatal`, or Ruby Logger integers (`0` debug … `4` fatal); default `debug` |
-| `RSPEC_EXAMPLE_TIMEOUT_SEC` | Per-example timeout (disabled while example debug is on) |
+| `RSPEC_EXAMPLE_TIMEOUT_SEC` | Per-example timeout (disabled while example debug is on); on timeout, ActiveRecord connection pools are disconnected so the next example gets fresh connections (any adapter) |
 
-In `spec_helper` / `spec/support`: `require "polyrun/rspec"` then `Polyrun::RSpec.install_sharded_formatter_compat!` (silences per-worker seed/summary/pending under `POLYRUN_SHARD_*`), `install_example_debug!`, `install_example_rails_logging!`, `install_example_timeout!`. Pair with `install_worker_ping!` for idle timeouts.
+In `spec_helper` / `spec/support`: `require "polyrun/rspec"` then `Polyrun::RSpec.install_sharded_formatter_compat!` (silences per-worker seed/summary/pending under `POLYRUN_SHARD_*`), `install_example_debug!`, `install_example_rails_logging!`, `install_example_prosopite!`, `install_example_timeout!`. Pair with `install_worker_ping!` for idle timeouts.
 
 ## 6. Coverage and CI reports
 

data/lib/polyrun/cli/help.rb

@@ -26,7 +26,7 @@ module Polyrun
           Per-worker wall timeout: --worker-timeout SEC or POLYRUN_WORKER_TIMEOUT_SEC. Exit 124; parent stops remaining workers.
           Per-worker idle timeout: --worker-idle-timeout SEC or POLYRUN_WORKER_IDLE_TIMEOUT_SEC after a progress ping (POLYRUN_WORKER_PING_FILE). Enable pings in test setup. Exit 125. Optional periodic pings: POLYRUN_WORKER_PING_THREAD=1 (POLYRUN_WORKER_PING_INTERVAL_SEC).
           Worker output routing (opt-in): POLYRUN_WORKER_OUTPUT_ROUTING=1 or POLYRUN_WORKER_LOG_DIR; per-shard logs under tmp/polyrun/workers (POLYRUN_WORKER_OUTPUT_PREFIX=0 for log-only)
-          Example debug (RSpec, opt-in): POLYRUN_EXAMPLE_DEBUG=1; POLYRUN_DEBUG_SQL / POLYRUN_DEBUG_TRACE
+          Example debug (RSpec, opt-in): POLYRUN_EXAMPLE_DEBUG=1 (print/Rails logging/timeouts); POLYRUN_DEBUG_SQL / DEBUG_SQL; POLYRUN_DEBUG_TRACE / DEBUG_TRACE; DEBUG_PROSOPITE=1
           Sharded formatter compat: silences per-worker seed, summary, and pending lines under POLYRUN_SHARD_* (see docs/SETUP_PROFILE.md)
           Orchestration warnings on process stderr: POLYRUN_ORCHESTRATION_STDERR=1
           Spec quality (opt-in): POLYRUN_SPEC_QUALITY=1; run-shards --merge-spec-quality; merge-spec-quality / report-spec-quality

data/lib/polyrun/rspec/active_record_timeout_recovery.rb

@@ -0,0 +1,51 @@
+module Polyrun
+  module RSpec
+    # Drops pooled connections after per-example Timeout interrupts database I/O.
+    # Uses only ActiveRecord connection-pool APIs (PostgreSQL, MySQL, SQLite, SQL Server, etc.).
+    module ActiveRecordTimeoutRecovery
+      module_function
+
+      def disconnect_all_connection_pools!
+        return unless active_record_loaded?
+
+        if defined?(ActiveRecord) && ActiveRecord.respond_to?(:disconnect_all!)
+          ActiveRecord.disconnect_all!
+          return
+        end
+
+        each_connection_pool(&:disconnect!)
+      end
+
+      def active_record_loaded?
+        defined?(ActiveRecord::Base) &&
+          ActiveRecord::Base.respond_to?(:connection_handler)
+      end
+
+      def each_connection_pool
+        connection_handlers.each do |handler|
+          pools_for(handler).each { |pool| yield pool }
+        end
+      end
+
+      def connection_handlers
+        base = ActiveRecord::Base
+        if base.respond_to?(:connection_handlers)
+          base.connection_handlers.values
+        else
+          [base.connection_handler]
+        end
+      end
+
+      def pools_for(handler)
+        if handler.respond_to?(:all_connection_pools)
+          handler.all_connection_pools
+        elsif handler.respond_to?(:connection_pool_list)
+          handler.connection_pool_list
+        else
+          []
+        end
+      end
+      private_class_method :active_record_loaded?, :each_connection_pool, :connection_handlers, :pools_for
+    end
+  end
+end

data/lib/polyrun/rspec/example_debug.rb

@@ -6,9 +6,10 @@ module Polyrun
   module RSpec
     # Per-example RSpec debugging for local investigation (SQL, TracePoint, timeouts).
     #
-    # +POLYRUN_EXAMPLE_DEBUG=1+ enables installers; +DEBUG=1+ / +POLYRUN_DEBUG=1+ trace orchestration only.
+    # +POLYRUN_EXAMPLE_DEBUG=1+ enables print helpers, Rails logging, and disables per-example timeouts.
     # +POLYRUN_DEBUG_SQL=1+ or legacy +DEBUG_SQL=1+ logs mutating SQL.
     # +POLYRUN_DEBUG_TRACE=1+ or legacy +DEBUG_TRACE=1+ traces :call/:raise under the app root.
+    # +DEBUG_PROSOPITE=1+ runs Prosopite N+1 scans when the gem is loaded.
     # +DEBUG_LOG_LEVEL+ accepts Ruby Logger severities as integers (0 debug … 4 fatal) or names.
     module ExampleDebug
       LOG_LEVEL_BY_NAME = {
@@ -26,15 +27,15 @@ module Polyrun
       end
 
       def sql_enabled?
-        enabled? && (truthy?(ENV["POLYRUN_DEBUG_SQL"]) || truthy?(ENV["DEBUG_SQL"]))
+        truthy?(ENV["POLYRUN_DEBUG_SQL"]) || truthy?(ENV["DEBUG_SQL"])
       end
 
       def trace_enabled?
-        enabled? && (truthy?(ENV["POLYRUN_DEBUG_TRACE"]) || truthy?(ENV["DEBUG_TRACE"]))
+        truthy?(ENV["POLYRUN_DEBUG_TRACE"]) || truthy?(ENV["DEBUG_TRACE"])
       end
 
       def prosopite_enabled?
-        enabled? && truthy?(ENV["DEBUG_PROSOPITE"])
+        truthy?(ENV["DEBUG_PROSOPITE"])
       end
 
       def print_spec_enabled?
@@ -99,14 +100,22 @@ module Polyrun
         return if seconds <= 0
         return if example_timeout_disabled?
 
+        require_relative "active_record_timeout_recovery"
+
         rspec_config.around(:each) do |example|
-          if example.metadata[:benchmark] || example.metadata[:slow]
-            example.run
-          else
-            Timeout.timeout(seconds) { example.run }
+          timed_out = false
+          begin
+            if example.metadata[:benchmark] || example.metadata[:slow]
+              example.run
+            else
+              Timeout.timeout(seconds) { example.run }
+            end
+          rescue Timeout::Error
+            timed_out = true
+            raise "Example timed out after #{seconds}s (#{example.location})"
+          ensure
+            ActiveRecordTimeoutRecovery.disconnect_all_connection_pools! if timed_out
           end
-        rescue Timeout::Error
-          raise "Example timed out after #{seconds}s (#{example.location})"
         end
       end
 

data/lib/polyrun/version.rb

@@ -1,3 +1,3 @@
 module Polyrun
-  VERSION = "2.2.0"
+  VERSION = "2.2.2"
 end

data/lib/polyrun/worker_output.rb

@@ -66,7 +66,8 @@ module Polyrun
             err: err_write
           )
         else
-          Process.spawn(child_env, *cmd, *paths, out: out_write, err: err_write)
+          # Array(cmd) so a String command is one argv element (not character-splatted).
+          Process.spawn(child_env, *Array(cmd), *Array(paths), out: out_write, err: err_write)
         end
 
       out_write.close
@@ -137,7 +138,7 @@ module Polyrun
           forwarder.consume(stream, io.readpartial(4096))
         end
       rescue IOError, Errno::EPIPE
-        # worker closed the pipe
+        drain_remaining_output(io, forwarder, stream)
       ensure
         io.close unless io.closed?
       end
@@ -145,6 +146,16 @@ module Polyrun
     end
     private_class_method :forwarder_thread
 
+    # EOFError subclasses IOError; keep drain rescues separate so a closed pipe
+    # during the final read does not escape the forwarder thread.
+    def drain_remaining_output(io, forwarder, stream)
+      remaining = io.read
+      forwarder.consume(stream, remaining) if remaining && !remaining.empty?
+    rescue IOError, Errno::EPIPE
+      nil
+    end
+    private_class_method :drain_remaining_output
+
     def drain_forwarders(entry)
       entry[:ios].each do |io|
         io.close unless io.closed?

data/polyrun.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.summary = "Parallel tests, coverage (SimpleCov-compatible) formatters, fixtures/snapshots, assets & DB provisioning—zero runtime deps"
   spec.homepage = "https://github.com/amkisko/polyrun.rb"
   spec.license = "MIT"
-  spec.required_ruby_version = ">= 3.1.0"
+  spec.required_ruby_version = ">= 3.4"
 
   spec.files = (
     Dir["lib/**/*", "sig/**/*.rbs", "bin/polyrun", "README.md", "CHANGELOG.md", "docs/SETUP_PROFILE.md", "LICENSE", "CONTRIBUTING.md", "CODE_OF_CONDUCT.md", "SECURITY.md", "polyrun.gemspec"] +

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: polyrun
 version: !ruby/object:Gem::Version
-  version: 2.2.0
+  version: 2.2.2
 platform: ruby
 authors:
 - Andrei Makarov
@@ -338,6 +338,7 @@ files:
 - lib/polyrun/reporting/rspec_failure_fragment_formatter.rb
 - lib/polyrun/reporting/rspec_junit.rb
 - lib/polyrun/rspec.rb
+- lib/polyrun/rspec/active_record_timeout_recovery.rb
 - lib/polyrun/rspec/example_debug.rb
 - lib/polyrun/rspec/example_debug_instrumentation.rb
 - lib/polyrun/rspec/sharded_formatter_compat.rb
@@ -392,14 +393,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: '3.4'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.3
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Parallel tests, coverage (SimpleCov-compatible) formatters, fixtures/snapshots,
   assets & DB provisioning—zero runtime deps