chore: release 0.3.1

alec-c4 · alec-c4 · commit 037ac805c8e5 · 2026-02-05T16:40:05.000+03:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,35 +5,46 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.1] - 2026-02-05
+
+### Fixed
+
+- **RSpec Integration:** Fixed `uninitialized constant RSpec::Matchers` error when loading the gem in environments where RSpec is only partially initialized (e.g., via `Bundler.require`).
+  - Matchers are now only defined if `RSpec::Matchers` is actually present.
+  - Matchers are no longer automatically loaded by `require "e2e"`; they are now explicitly loaded via `require "e2e/rspec"`.
+
 ## [0.3.0] - 2026-02-05
 
 ### Added
+
 - **Matchers:** Added custom RSpec matchers:
-    - `have_class("class-name")`
-    - `have_text("content")` / `have_content`
-    - `have_value("val")`
-    - `have_attribute("name", "val")`
-    - `be_visible`
-    - `be_checked`
-    - `be_disabled` / `be_enabled`
+  - `have_class("class-name")`
+  - `have_text("content")` / `have_content`
+  - `have_value("val")`
+  - `have_attribute("name", "val")`
+  - `be_visible`
+  - `be_checked`
+  - `be_disabled` / `be_enabled`
 - **Element API:** Added `classes`, `has_class?`, `visible?`, `[]`, `value`, `checked?`, `disabled?`, `enabled?`.
 - **Debugging:** Improved debugging documentation and fixed `pause` helper.
 
 ## [0.2.0] - 2026-02-05
 
 ### Added
+
 - **Browser Switching:** Support for Chromium, Firefox, and WebKit via `E2E.config.browser_type`.
 - **Dynamic Session Management:** `E2E.reset_session!` to handle browser switching mid-suite.
 - **Generators:**
-    - `rails g e2e:install` now detects test framework (RSpec/Minitest) and injects RuboCop config.
-    - `rails g e2e:test` scaffolds test files based on the detected framework.
+  - `rails g e2e:install` now detects test framework (RSpec/Minitest) and injects RuboCop config.
+  - `rails g e2e:test` scaffolds test files based on the detected framework.
 - **Minitest Support:** Full integration via `E2E::Minitest::TestCase`.
 - **RuboCop Integration:** Automatic injection of `inherit_gem` to relax rules for E2E specs.
 - **Debugging:** `pause` helper for calling Playwright Inspector.
 
 ## [0.1.0] - 2026-02-05
 
 ### Added
+
 - **Core:** Initial release of `e2e` gem, a unified testing framework wrapper around Playwright.
 - **Drivers:** Playwright driver implementation using `playwright-ruby-client` (IPC/Pipes).
 - **DSL:** Capybara-like API including `visit`, `click_button`, `click_link`, `fill_in`, `check`, `uncheck`, `attach_file`, `find`, `all`.
diff --git a/Gemfile.lock b/Gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    e2e (0.3.0)
+    e2e (0.3.1)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -148,7 +148,7 @@ CHECKSUMS
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
-  e2e (0.3.0)
+  e2e (0.3.1)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
   irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
diff --git a/gemfiles/rails_7.0.gemfile.lock b/gemfiles/rails_7.0.gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.0)
+    e2e (0.3.1)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -335,7 +335,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.0)
+  e2e (0.3.1)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
diff --git a/gemfiles/rails_7.1.gemfile.lock b/gemfiles/rails_7.1.gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.0)
+    e2e (0.3.1)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -349,7 +349,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.0)
+  e2e (0.3.1)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
diff --git a/gemfiles/rails_7.2.gemfile.lock b/gemfiles/rails_7.2.gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.0)
+    e2e (0.3.1)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -343,7 +343,7 @@ CHECKSUMS
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
   docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.0)
+  e2e (0.3.1)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
diff --git a/gemfiles/rails_8.0.gemfile.lock b/gemfiles/rails_8.0.gemfile.lock
@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    e2e (0.3.0)
+    e2e (0.3.1)
       playwright-ruby-client (>= 1.40.0)
       rack
       rackup
@@ -337,9 +337,9 @@ CHECKSUMS
   crass (1.0.6) sha256=dc516022a56e7b3b156099abc81b6d2b08ea1ed12676ac7a5657617f012bd45d
   date (3.5.1) sha256=750d06384d7b9c15d562c76291407d89e368dda4d4fff957eb94962d325a0dc0
   diff-lcs (1.6.2) sha256=9ae0d2cba7d4df3075fe8cd8602a8604993efc0dfa934cff568969efb1909962
-  docile (1.4.1)
+  docile (1.4.1) sha256=96159be799bfa73cdb721b840e9802126e4e03dfc26863db73647204c727f21e
   drb (2.2.3) sha256=0b00d6fdb50995fe4a45dea13663493c841112e4068656854646f418fda13373
-  e2e (0.3.0)
+  e2e (0.3.1)
   erb (6.0.1) sha256=28ecdd99c5472aebd5674d6061e3c6b0a45c049578b071e5a52c2a7f13c197e5
   erubi (1.13.1) sha256=a082103b0885dbc5ecf1172fede897f9ebdb745a4b97a5e8dc63953db1ee4ad9
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
@@ -403,9 +403,9 @@ CHECKSUMS
   rubocop-rspec (3.9.0) sha256=8fa70a3619408237d789aeecfb9beef40576acc855173e60939d63332fdb55e2
   ruby-progressbar (1.13.0) sha256=80fc9c47a9b640d6834e0dc7b3c94c9df37f08cb072b7761e4a71e22cff29b33
   securerandom (0.4.1) sha256=cc5193d414a4341b6e225f0cb4446aceca8e50d5e1888743fac16987638ea0b1
-  simplecov (0.22.0)
-  simplecov-html (0.13.2)
-  simplecov_json_formatter (0.1.4)
+  simplecov (0.22.0) sha256=fe2622c7834ff23b98066bb0a854284b2729a569ac659f82621fc22ef36213a5
+  simplecov-html (0.13.2) sha256=bd0b8e54e7c2d7685927e8d6286466359b6f16b18cb0df47b508e8d73c777246
+  simplecov_json_formatter (0.1.4) sha256=529418fbe8de1713ac2b2d612aa3daa56d316975d307244399fa4838c601b428
   standard (1.53.0) sha256=f3c9493385db7079d0abce6f7582f553122156997b81258cd361d3480eeacf9c
   standard-custom (1.0.2) sha256=424adc84179a074f1a2a309bb9cf7cd6bfdb2b6541f20c6bf9436c0ba22a652b
   standard-performance (1.9.0) sha256=49483d31be448292951d80e5e67cdcb576c2502103c7b40aec6f1b6e9c88e3f2
diff --git a/lib/e2e.rb b/lib/e2e.rb
@@ -6,7 +6,6 @@
 require_relative "e2e/session"
 require_relative "e2e/dsl"
 require_relative "e2e/element"
-require_relative "e2e/matchers"
 require_relative "e2e/rails"
 require_relative "e2e/drivers/playwright"
 
diff --git a/lib/e2e/matchers.rb b/lib/e2e/matchers.rb
@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-if defined?(RSpec)
+if defined?(RSpec::Matchers)
   RSpec::Matchers.define :have_class do |expected_class|
     match do |element|
       element.has_class?(expected_class)
diff --git a/lib/e2e/rspec.rb b/lib/e2e/rspec.rb
@@ -1,6 +1,11 @@
 # frozen_string_literal: true
 
 require "e2e"
+begin
+  require "rspec/expectations"
+rescue LoadError
+end
+require_relative "matchers"
 
 RSpec.configure do |config|
   config.include E2E::DSL, type: :e2e
diff --git a/lib/e2e/version.rb b/lib/e2e/version.rb
@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module E2E
-  VERSION = "0.3.0"
+  VERSION = "0.3.1"
 end
