smartest 0.6.2 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e22e30a25a1dc0d4069da141636cbc78cc3e304265f38affe9f025ef97e65187
-  data.tar.gz: 67e90ecd4512d5175dc39805ea3551640708826013926dc2f9a3edc9d661a542
+  metadata.gz: b6ad960075fac5ace157331444bdc448d1325cbf1fa19d7ecc17b67586011e97
+  data.tar.gz: 7ba158adac3211340a492432208ea9c57315be6946b28acd8e9c4a423de67a28
 SHA512:
-  metadata.gz: 614de06c5e7ba1e12c5d9d5fbbc2f786cbfd2bee0303abe3b3f98f61007ec7332912eaf06128b7899a58ea006d78c507ed3ab48f006c24d20905d3d3828a951b
-  data.tar.gz: a0d20f767b563c06683d4f288183d7c21d8f937e37a126d623af2e4c8e900405a0a46afd39de1848cf05ff11b4f1bbc7473e2aaa49a81365960ef263ae158e8d
+  metadata.gz: 3926a55fa11cfbd6bae599318cb94aa5e7f32840d853f5c25244aaf0cac827df7f6bfe2de1f849e73a009d02ff599f4f52a1041d0b6a0680369945503c859100
+  data.tar.gz: 1eb3e75230cf1aa0b278c0486d1986f509f9eee6fcb1fe3e43f28cea9f74f3eef9490032228cea6eae515c318c2a70ad3573c5118d6277ea095dfc402c370a58

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.7.0
+
+### Breaking Changes
+
+- Rename the Rails test server to a Rack test server. Replace
+  `require "smartest/rails"` with `require "smartest/rack"` and
+  `Smartest::Rails::TestServer` with `Smartest::Rack::TestServer`.
+
 ## 0.6.1
 
 ### Bug Fixes

data/README.md

@@ -259,15 +259,17 @@ smartest/matchers/playwright_matcher.rb
 smartest/example_rails_system_test.rb
 ```
 
-The generated fixture requires `smartest/rails`, loads `config/environment`
+The generated fixture requires `smartest/rack`, loads `config/environment`
 when `test_helper` requires the fixture file, and starts
-`Smartest::Rails::TestServer` against `Rails.application` in the same Ruby
+`Smartest::Rack::TestServer` against `Rails.application` in the same Ruby
 process as the test runner. Loading Rails during helper setup makes app
 constants such as ActiveRecord models available inside test files and
 `around_test` hooks before per-test fixtures are resolved. The generated
 fixture forces `RAILS_ENV` and `RACK_ENV` to `test` before Rails boots.
-`Smartest::Rails::TestServer` is only loaded by explicitly requiring
-`smartest/rails`; plain `require "smartest"` does not load Puma.
+`Smartest::Rack::TestServer` is only loaded by explicitly requiring
+`smartest/rack`; plain `require "smartest"` does not load Puma.
+Despite being used by the Rails scaffold, it accepts any Rack app via `app:`,
+including Sinatra, Hanami, and other Rack-compatible apps.
 
 This is aimed at local Rails system tests that combine Rails test data, stubs,
 and Playwright browser assertions. It is not a Capybara compatibility layer or
@@ -292,6 +294,10 @@ At runtime, set `PLAYWRIGHT_WS_ENDPOINT`,
 sidecar and gives the browser a Docker-network URL for Rails. These are usually
 stable Docker topology settings, so put them in `compose.yml` instead of
 repeating them on every `docker compose run` command.
+Because this path connects to Playwright over WebSocket, `websocket-driver` is
+**REQUIRED only when** using `PLAYWRIGHT_WS_ENDPOINT` or
+`Playwright.connect_to_browser_server`; local Rails browser tests that launch
+Playwright locally do not need it.
 For a Rails Compose service named `web`, use
 `SMARTEST_RAILS_BASE_URL=http://web:4001`; replace `web` with your service name.
 The generated Rails fixture sets `RAILS_ENV` and `RACK_ENV` to `test`, even if

data/lib/smartest/init_rails_generator.rb

@@ -7,7 +7,7 @@ module Smartest
     RAILS_SYSTEM_FIXTURE = <<~RUBY
       # frozen_string_literal: true
 
-      require 'smartest/rails'
+      require 'smartest/rack'
       require "playwright"
 
       # Force the test environment and load Rails while test_helper is required
@@ -18,7 +18,7 @@ module Smartest
 
       class RailsSystemTestFixture < Smartest::Fixture
         suite_fixture :rails_server do
-          server = Smartest::Rails::TestServer.new(
+          server = Smartest::Rack::TestServer.new(
             app: Rails.application,
             host: ENV["SMARTEST_RAILS_TEST_SERVER_HOST"],
             port: ENV["SMARTEST_RAILS_TEST_SERVER_PORT"],

data/lib/smartest/{rails.rb → rack.rb}

@@ -7,7 +7,7 @@ require "timeout"
 require_relative "../smartest"
 
 module Smartest
-  module Rails
+  module Rack
     class TestServer
       DEFAULT_READY_TIMEOUT = 10
 
@@ -35,14 +35,14 @@ module Smartest
           sleep 0.05 until responsive?
         end
       rescue Timeout::Error
-        raise "Rails test server did not become ready at #{base_url} within #{timeout} seconds"
+        raise "Rack test server did not become ready at #{base_url} within #{timeout} seconds"
       end
 
       def wait_for_stopped(timeout: DEFAULT_READY_TIMEOUT)
         return unless @thread
         return if @thread.join(timeout)
 
-        raise "Rails test server did not stop within #{timeout} seconds"
+        raise "Rack test server did not stop within #{timeout} seconds"
       end
 
       def base_url
@@ -57,7 +57,7 @@ module Smartest
 
         return bound_port if bound_port && bound_port.positive?
 
-        raise "Rails test server could not determine bound port"
+        raise "Rack test server could not determine bound port"
       end
 
       def responsive?

data/lib/smartest/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Smartest
-  VERSION = "0.6.2"
+  VERSION = "0.7.0"
 end

data/smartest/smartest_test.rb

@@ -2290,13 +2290,13 @@ test("cli browser init generator skips npm init when package.json already exists
   end
 end
 
-test("smartest rails helper is loaded only by explicit require") do
+test("smartest rack helper is loaded only by explicit require") do
   lib_path = File.expand_path("../lib", __dir__)
   stdout, stderr, status = Open3.capture3(
     { "RUBYLIB" => lib_path },
     "ruby",
     "-e",
-    'require "smartest"; puts Smartest.const_defined?(:Rails, false)'
+    'require "smartest"; puts Smartest.const_defined?(:Rack, false)'
   )
 
   expect(status.success?).to eq(true)
@@ -2310,7 +2310,7 @@ test("smartest rails helper is loaded only by explicit require") do
       { "RUBYLIB" => "#{dir}:#{lib_path}" },
       "ruby",
       "-e",
-      'require "smartest/rails"; puts Smartest::Rails.const_defined?(:TestServer, false)'
+      'require "smartest/rack"; puts Smartest::Rack.const_defined?(:TestServer, false)'
     )
 
     expect(status.success?).to eq(true)
@@ -2319,7 +2319,7 @@ test("smartest rails helper is loaded only by explicit require") do
   end
 end
 
-test("smartest rails test server wraps puma with explicit arguments and lifecycle") do
+test("smartest rack test server wraps puma with explicit arguments and lifecycle") do
   lib_path = File.expand_path("../lib", __dir__)
 
   Dir.mktmpdir do |dir|
@@ -2367,10 +2367,10 @@ test("smartest rails test server wraps puma with explicit arguments and lifecycl
       "ruby",
       "-e",
       <<~'RUBY'
-        require "smartest/rails"
+        require "smartest/rack"
 
-        server = Smartest::Rails::TestServer.new(app: Object.new, port: "4567")
-        default_port_server = Smartest::Rails::TestServer.new(app: Object.new)
+        server = Smartest::Rack::TestServer.new(app: Object.new, port: "4567")
+        default_port_server = Smartest::Rack::TestServer.new(app: Object.new)
         thread = server.start
         server.stop
         server.wait_for_stopped
@@ -2411,7 +2411,7 @@ test("cli rails init generator creates Rails browser scaffold and installation c
 
     expect(status).to eq(0)
     rails_fixture = File.read(File.join(dir, "smartest/fixtures/rails_system_fixture.rb"))
-    expect(rails_fixture).to include("require 'smartest/rails'")
+    expect(rails_fixture).to include("require 'smartest/rack'")
     expect(rails_fixture).to include("class RailsSystemTestFixture < Smartest::Fixture")
     expect(rails_fixture).to include("suite_fixture :rails_server")
     expect(rails_fixture).to include('ENV["RAILS_ENV"] = "test"')
@@ -2420,7 +2420,7 @@ test("cli rails init generator creates Rails browser scaffold and installation c
     expect(rails_fixture).to include("constants are available before per-test fixtures are resolved")
     expect(rails_fixture).to include('require_relative "../../config/environment"')
     expect(rails_fixture.index('require_relative "../../config/environment"') < rails_fixture.index("class RailsSystemTestFixture")).to eq(true)
-    expect(rails_fixture).to include("Smartest::Rails::TestServer.new(")
+    expect(rails_fixture).to include("Smartest::Rack::TestServer.new(")
     expect(rails_fixture).to include('host: ENV["SMARTEST_RAILS_TEST_SERVER_HOST"]')
     expect(rails_fixture).not_to include("bind_host:")
     expect(rails_fixture).to include('port: ENV["SMARTEST_RAILS_TEST_SERVER_PORT"]')
@@ -2497,7 +2497,7 @@ test("cli rails init generator forces Rails test environment when the generated
 
     stub_dir = File.join(dir, "stub_load_path")
     FileUtils.mkdir_p(File.join(stub_dir, "smartest"))
-    File.write(File.join(stub_dir, "smartest/rails.rb"), <<~RUBY)
+    File.write(File.join(stub_dir, "smartest/rack.rb"), <<~RUBY)
       module Smartest
         class Fixture
           def self.suite_fixture(*)
@@ -2507,7 +2507,7 @@ test("cli rails init generator forces Rails test environment when the generated
           end
         end
 
-        module Rails
+        module Rack
         end
       end
     RUBY

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.6.2
+  version: 0.7.0
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-23 00:00:00.000000000 Z
+date: 2026-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -66,7 +66,7 @@ files:
 - lib/smartest/matcher_registry.rb
 - lib/smartest/matchers.rb
 - lib/smartest/parameter_extractor.rb
-- lib/smartest/rails.rb
+- lib/smartest/rack.rb
 - lib/smartest/reporter.rb
 - lib/smartest/runner.rb
 - lib/smartest/simple_stub.rb