e2e 0.7.2 → 0.7.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8b1979d8cb29dc3f972388c02f2e9b650d46bbb3a6e77d5df9a2b73469c3147f
-  data.tar.gz: 142e1b3e1f5f0d340d1500c403fc2a5bdda313a2eedc91b3a572f1d552b55d61
+  metadata.gz: 054a523b511bfbd8e1798c0b4733161b29a2a65938b8697266e36f8f63c7207e
+  data.tar.gz: f27d6c894f7dfeaa3626274b6dab9819de23f7249980a69f783e3740f86f62cb
 SHA512:
-  metadata.gz: 34870c3c1ce7dc4a649377763117170a84a9bcd43f3c530798965948d4b0a5ca979049f8cfffcff36ab923e89b34c54d436b271d1629fb13ce03c1d6087e2e4e
-  data.tar.gz: 341af70802d3e123fde8d0fb58b8bc25c5d795857cd6d913378304ecd3b5e8c6f97195e2f5d407d9c514a8e4cd3a05b78488c7d7970149f0cf1a51b71f2551ee
+  metadata.gz: 4318374aef6f2f4fbcdff1c5019d9122ee8bdc3843bf96181c1aee9733f34c882b9c9ee9a38fff3714dd64a8a761b70f5d2fb36e49643b69591822861034f294
+  data.tar.gz: 76cd349a59d5fe14f44e06d9c6c65f711e7eea2feb8c6806369d5e4457b3e2c149af43fef43d5a70fdbfeb49273fb043074b2cd4225af473f6fb847c3ab46da8

data/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.3] - 2026-08-20
+
+### Fixed
+
+- `E2E::Server` eager loads a Rails app (once, before the in-process WEBrick thread starts) to close a rare full-process deadlock: Zeitwerk's per-loader autoload monitor and Ruby's own internal `require` lock can deadlock each other (a classic lock-ordering inversion) when the server thread and the caller's thread each reference a not-yet-loaded app constant for the first time at the same moment. The process idles at ~0% CPU forever with no exception raised. Only reproduces when `config.eager_load` is off (the common local-dev/test setting; CI setups that force eager loading were never affected). Opt out with `config.eager_load_app = false`.
+
 ## [0.7.2] - 2026-08-13
 
 ### Added

data/README.md

@@ -339,6 +339,11 @@ E2E.configure do |config|
   # Vite / Inertia: ensure public/vite-test is fresh before the suite
   # :auto (default) | :build | :warn | :skip — or SKIP_VITE_TEST_BUILD=1
   config.ensure_vite_assets = :auto
+  # Eager load a Rails app (once) before the in-process server thread starts.
+  # Prevents a rare deadlock where that thread and the caller's thread race to
+  # autoload the same app constant for the first time. Leave this on unless
+  # eager loading your app is itself broken. Default: true
+  config.eager_load_app = true
   config.flash_selectors = {
     any: "[role='alert'], [role='status'], .flash",
     notice: "[role='status'], .flash.notice",

data/gemfiles/rails_7.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.7.2)
+    e2e (0.7.3)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -333,12 +333,13 @@ CHECKSUMS
   benchmark (0.5.0) sha256=465df122341aedcb81a2a24b4d3bd19b6c67c1530713fd533f3ff034e419236c
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  bundler (4.0.16) sha256=d6ca5dd440c24f9abce9844cf44cc8e18c6a553de65a47efb4544137af92c47d
   concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1
   crass (1.0.7) sha256=94868719948664c89ddcaf0a37c65048413dfcb1c869470a5f7a7ceb5390b295
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.7.2)
+  e2e (0.7.3)
   erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.4.0) sha256=037f12fbf1d9d7a014d501c2d5c77356fd4ddd96d7a7991d6700bba96706f427
@@ -421,4 +422,4 @@ CHECKSUMS
   zeitwerk (2.8.3) sha256=2c85125a8467ce069e20123d1e709a08955c9d29c118c25b46b7b7fafdbb92e5
 
 BUNDLED WITH
-  4.0.5
+  4.0.16

data/gemfiles/rails_7.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.7.2)
+    e2e (0.7.3)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -350,6 +350,7 @@ CHECKSUMS
   benchmark (0.5.0) sha256=465df122341aedcb81a2a24b4d3bd19b6c67c1530713fd533f3ff034e419236c
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  bundler (4.0.16) sha256=d6ca5dd440c24f9abce9844cf44cc8e18c6a553de65a47efb4544137af92c47d
   cgi (0.5.2) sha256=61ca30298171190fd4fa0d8018e57ada456eae9b7a2b78526debf7f0a0e6f8bb
   concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
@@ -357,7 +358,7 @@ CHECKSUMS
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.7.2)
+  e2e (0.7.3)
   erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.4.0) sha256=037f12fbf1d9d7a014d501c2d5c77356fd4ddd96d7a7991d6700bba96706f427
@@ -446,4 +447,4 @@ CHECKSUMS
   zeitwerk (2.8.3) sha256=2c85125a8467ce069e20123d1e709a08955c9d29c118c25b46b7b7fafdbb92e5
 
 BUNDLED WITH
-  4.0.5
+  4.0.16

data/gemfiles/rails_7.2.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.7.2)
+    e2e (0.7.3)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -344,6 +344,7 @@ CHECKSUMS
   benchmark (0.5.0) sha256=465df122341aedcb81a2a24b4d3bd19b6c67c1530713fd533f3ff034e419236c
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  bundler (4.0.16) sha256=d6ca5dd440c24f9abce9844cf44cc8e18c6a553de65a47efb4544137af92c47d
   cgi (0.5.2) sha256=61ca30298171190fd4fa0d8018e57ada456eae9b7a2b78526debf7f0a0e6f8bb
   concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
@@ -351,7 +352,7 @@ CHECKSUMS
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.7.2)
+  e2e (0.7.3)
   erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.4.0) sha256=037f12fbf1d9d7a014d501c2d5c77356fd4ddd96d7a7991d6700bba96706f427
@@ -440,4 +441,4 @@ CHECKSUMS
   zeitwerk (2.8.3) sha256=2c85125a8467ce069e20123d1e709a08955c9d29c118c25b46b7b7fafdbb92e5
 
 BUNDLED WITH
-  4.0.5
+  4.0.16

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.7.2)
+    e2e (0.7.3)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -341,13 +341,14 @@ CHECKSUMS
   benchmark (0.5.0) sha256=465df122341aedcb81a2a24b4d3bd19b6c67c1530713fd533f3ff034e419236c
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  bundler (4.0.16) sha256=d6ca5dd440c24f9abce9844cf44cc8e18c6a553de65a47efb4544137af92c47d
   concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
   crass (1.0.7) sha256=94868719948664c89ddcaf0a37c65048413dfcb1c869470a5f7a7ceb5390b295
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.7.2)
+  e2e (0.7.3)
   erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.4.0) sha256=037f12fbf1d9d7a014d501c2d5c77356fd4ddd96d7a7991d6700bba96706f427
@@ -437,4 +438,4 @@ CHECKSUMS
   zeitwerk (2.8.3) sha256=2c85125a8467ce069e20123d1e709a08955c9d29c118c25b46b7b7fafdbb92e5
 
 BUNDLED WITH
-  4.0.5
+  4.0.16

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.7.2)
+    e2e (0.7.3)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -343,13 +343,14 @@ CHECKSUMS
   base64 (0.3.0) sha256=27337aeabad6ffae05c265c450490628ef3ebd4b67be58257393227588f5a97b
   bigdecimal (4.1.2) sha256=53d217666027eab4280346fba98e7d5b66baaae1b9c3c1c0ffe89d48188a3fbd
   builder (3.3.0) sha256=497918d2f9dca528fdca4b88d84e4ef4387256d984b8154e9d5d3fe5a9c8835f
+  bundler (4.0.16) sha256=d6ca5dd440c24f9abce9844cf44cc8e18c6a553de65a47efb4544137af92c47d
   concurrent-ruby (1.3.8) sha256=b2f1be836e968ccc78ccfce277ea79c72a88633f22306782c16ff23fb415d1e1
   connection_pool (3.0.2) sha256=33fff5ba71a12d2aa26cb72b1db8bba2a1a01823559fb01d29eb74c286e62e0a
   crass (1.0.7) sha256=94868719948664c89ddcaf0a37c65048413dfcb1c869470a5f7a7ceb5390b295
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.7.2)
+  e2e (0.7.3)
   erb (6.0.7) sha256=c5ca6dc25b0ef974a44dc8f59fe847577122483b1968a38dec305c60bf91ee92
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.4.0) sha256=037f12fbf1d9d7a014d501c2d5c77356fd4ddd96d7a7991d6700bba96706f427
@@ -439,4 +440,4 @@ CHECKSUMS
   zeitwerk (2.8.3) sha256=2c85125a8467ce069e20123d1e709a08955c9d29c118c25b46b7b7fafdbb92e5
 
 BUNDLED WITH
-  4.0.5
+  4.0.16

data/lib/e2e/server.rb

@@ -16,6 +16,7 @@ module E2E
     end
 
     def start
+      eager_load_app!
       @thread = Thread.new do
         webrick_handler.run(
           @app,
@@ -43,6 +44,31 @@ module E2E
 
     private
 
+    # Zeitwerk's per-loader autoload monitor and Ruby's own internal `require`
+    # lock can deadlock each other (classic lock-ordering inversion) when two
+    # threads race to autoload the same not-yet-loaded app constant for the
+    # first time. That race is exactly what this gem sets up by design: the
+    # WEBrick thread servicing the very first request and the caller's thread
+    # (evaluating spec/support files, factories, etc.) can each reference a
+    # fresh app class at the same moment, one thread ends up mid-`require`
+    # holding Ruby's require lock while waiting on Zeitwerk's monitor, the
+    # other holds that monitor while waiting on the require lock -- neither
+    # ever proceeds, and the process idles at ~0% CPU forever.
+    #
+    # Eager loading synchronously on the caller's thread, before the server
+    # thread ever starts, guarantees no constant is loaded for the first time
+    # under concurrency, so the race can't occur. This mirrors what already
+    # happens for free in CI-style setups that force `config.eager_load = true`
+    # in the test environment -- local runs that leave eager loading off are
+    # exactly where this hang has been observed.
+    def eager_load_app!
+      return unless E2E.config.eager_load_app
+      return unless defined?(::Rails) && ::Rails.respond_to?(:application) && ::Rails.application
+      return if ::Rails.application.config.eager_load
+
+      ::Rails.application.eager_load!
+    end
+
     # rackup 2.x (the version paired with Rack 3) exposes Rackup::Handler.
     # Older stacks that pin Rack 2.x (e.g. Rails 7.0/7.1 via this gem's own
     # Appraisal matrix) resolve `rackup` down to its 1.x line, which has no

data/lib/e2e/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module E2E
-  VERSION = "0.7.2"
+  VERSION = "0.7.3"
 end

data/lib/e2e.rb

@@ -68,7 +68,7 @@ module E2E
     }.freeze
 
     attr_accessor :driver, :headless, :app, :browser_type, :wait_timeout, :flash_selectors,
-      :navigation_timeout, :navigation_wait_until, :ensure_vite_assets
+      :navigation_timeout, :navigation_wait_until, :ensure_vite_assets, :eager_load_app
 
     def initialize
       @driver = :playwright
@@ -83,6 +83,9 @@ module E2E
       @flash_selectors = DEFAULT_FLASH_SELECTORS.dup
       # :auto builds when ViteRuby is loaded; :build requires it; :warn / :skip
       @ensure_vite_assets = :auto
+      # See Server#eager_load_app! for why this defaults on. Set to false only
+      # if eager loading the host app is itself broken or unacceptably slow.
+      @eager_load_app = true
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: e2e
 version: !ruby/object:Gem::Version
-  version: 0.7.2
+  version: 0.7.3
 platform: ruby
 authors:
 - Alexey Poimtsev
@@ -286,7 +286,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.18
+rubygems_version: 4.0.19
 specification_version: 4
 summary: Unified E2E testing framework for Ruby.
 test_files: []