smartest 0.6.0 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6c8e44520f35d8daac5d01122fd2dc2b1f70f0fcbc61c1ff1d2a6c8ce5179a72
-  data.tar.gz: 4400e77b387079fa88978ff82d34b492f250fdf6de75aae773911a5b91672169
+  metadata.gz: 60329ddc39f19de585b5eca7624d830188201867f12acc4c5d455086770c6e55
+  data.tar.gz: e3b94d9094456040638436153dea247c90a09df900f73fac8a446e230cf121e6
 SHA512:
-  metadata.gz: b5f7dde5de541b2eec20747164936cee3945076fb985c636d4ae2ea2473e0e2b795b9e5b393800b198e2bae5ae8c6e0892ab173d74e995404a1f4941ce27fd57
-  data.tar.gz: 0226224e48d5dfcaa82b9b22fc03ab295cab9fd463f5f0e17bab881d38e9f68eb98946641a45f5b6a13a884d1649c714a6e8aacd86e772b1aa6ec9d82fbf323c
+  metadata.gz: 47ba0913bb68d3015905baa12677ed6ac2f812723935a546d0f6f9c0e0154776fb72a9e2844a77833743c97a8363066c7199c767022022b17f169415c48b9001
+  data.tar.gz: 86f5bdd1c49b6f461408c5ee21075a0a75406e8f6c139f6146871fcbd0dea6644129e63339602851f2a122ac075d6bcc7b96d95d69224e446dc5e6031c951cf9

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # Changelog
 
+## 0.6.1
+
+### Bug Fixes
+
+- Fix Rails Docker scaffold friction in `smartest --init-rails` and the
+  generated Playwright fixtures so the Docker-based browser test setup works
+  out of the box.
+
+### Documentation
+
+- Document fresh Rails database preparation for browser tests, including the
+  Docker-based workflow.
+
 ## 0.6.0
 
 ### New Features

data/README.md

@@ -256,11 +256,15 @@ smartest/matchers/playwright_matcher.rb
 smartest/example_rails_system_test.rb
 ```
 
-The generated fixture requires `smartest/rails` and starts
+The generated fixture requires `smartest/rails`, loads `config/environment`
+when `test_helper` requires the fixture file, and starts
 `Smartest::Rails::TestServer` against `Rails.application` in the same Ruby
-process as the test runner. `Smartest::Rails::TestServer` is only loaded by
-explicitly requiring `smartest/rails`; plain `require "smartest"` does not load
-Puma.
+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.
 
 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
@@ -282,7 +286,13 @@ SMARTEST_SKIP_BROWSER_DOWNLOAD=1 bundle exec smartest --init-rails
 At runtime, set `PLAYWRIGHT_WS_ENDPOINT`,
 `SMARTEST_RAILS_TEST_SERVER_HOST`, `SMARTEST_RAILS_TEST_SERVER_PORT`, and
 `SMARTEST_RAILS_BASE_URL` so the generated fixture connects to the Playwright
-sidecar and gives the browser a Docker-network URL for Rails.
+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.
+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
+the same service normally runs in development.
 
 Run the generated Rails browser example with:
 

data/lib/smartest/init_browser_generator.rb

@@ -160,11 +160,15 @@ module Smartest
     end
 
     def install_dependencies
-      install_commands.each do |command|
-        @output.puts "run     #{command.join(" ")}"
-        next if @command_runner.call(command, chdir: @root)
+      commands = install_commands
 
-        raise "command failed: #{command.join(" ")}"
+      with_unbundled_env do
+        commands.each do |command|
+          @output.puts "run     #{command.join(" ")}"
+          next if @command_runner.call(command, chdir: @root)
+
+          raise "command failed: #{command.join(" ")}"
+        end
       end
     end
 
@@ -179,5 +183,15 @@ module Smartest
     def run_system_command(command, chdir:)
       system(*command, chdir: chdir)
     end
+
+    def with_unbundled_env(&block)
+      require "bundler"
+
+      if Bundler.respond_to?(:with_unbundled_env)
+        Bundler.with_unbundled_env(&block)
+      else
+        Bundler.with_clean_env(&block)
+      end
+    end
   end
 end

data/lib/smartest/init_rails_generator.rb

@@ -10,14 +10,14 @@ module Smartest
       require 'smartest/rails'
       require "playwright"
 
+      # Force the test environment and load Rails while test_helper is required
+      # so app constants are available before per-test fixtures are resolved.
+      ENV["RAILS_ENV"] = "test"
+      ENV["RACK_ENV"] = "test"
+      require_relative "../../config/environment"
+
       class RailsSystemTestFixture < Smartest::Fixture
         suite_fixture :rails_server do
-          # Set the environment before loading config/environment so the test
-          # server cannot boot against the development database by default.
-          ENV["RAILS_ENV"] ||= "test"
-          ENV["RACK_ENV"] ||= ENV["RAILS_ENV"]
-          require_relative "../../config/environment"
-
           server = Smartest::Rails::TestServer.new(
             app: Rails.application,
             host: ENV["SMARTEST_RAILS_TEST_SERVER_HOST"],
@@ -211,11 +211,15 @@ module Smartest
     end
 
     def install_dependencies
-      install_commands.each do |command|
-        @output.puts "run     #{command.join(" ")}"
-        next if @command_runner.call(command, chdir: @root)
+      commands = install_commands
+
+      with_unbundled_env do
+        commands.each do |command|
+          @output.puts "run     #{command.join(" ")}"
+          next if @command_runner.call(command, chdir: @root)
 
-        raise "command failed: #{command.join(" ")}"
+          raise "command failed: #{command.join(" ")}"
+        end
       end
 
       if skip_browser_download?
@@ -238,5 +242,15 @@ module Smartest
     def run_system_command(command, chdir:)
       system(*command, chdir: chdir)
     end
+
+    def with_unbundled_env(&block)
+      require "bundler"
+
+      if Bundler.respond_to?(:with_unbundled_env)
+        Bundler.with_unbundled_env(&block)
+      else
+        Bundler.with_clean_env(&block)
+      end
+    end
   end
 end

data/lib/smartest/version.rb

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

data/smartest/smartest_test.rb

@@ -2183,6 +2183,49 @@ test("cli browser init generator creates Playwright scaffold and installation co
   end
 end
 
+test("cli browser init generator runs installation commands outside the current Bundler environment") do
+  require "bundler"
+
+  Dir.mktmpdir do |dir|
+    File.write(File.join(dir, "Gemfile"), <<~RUBY)
+      source "https://rubygems.org"
+
+      gem "smartest"
+    RUBY
+
+    command_environments = []
+    output = StringIO.new
+    generator = Smartest::InitBrowserGenerator.new(
+      root: dir,
+      output: output,
+      command_runner: ->(_command, chdir:) {
+        command_environments << {
+          bundle_gemfile: ENV["BUNDLE_GEMFILE"],
+          bundle_bin_path: ENV["BUNDLE_BIN_PATH"],
+          rubyopt: ENV["RUBYOPT"]
+        }
+        true
+      }
+    )
+
+    SmartestSelfTest.with_env(
+      "BUNDLE_GEMFILE" => File.join(dir, "Gemfile"),
+      "BUNDLE_BIN_PATH" => "/tmp/smartest-self-test-bundle",
+      "RUBYOPT" => "-rbundler/setup -W0"
+    ) do
+      status = generator.run
+      expect(status).to eq(0)
+    end
+
+    expect(command_environments.length).to eq(4)
+    expect(command_environments.all? do |environment|
+      environment[:bundle_gemfile].nil? &&
+        environment[:bundle_bin_path].nil? &&
+        !environment[:rubyopt].to_s.include?("bundler/setup")
+    end).to eq(true)
+  end
+end
+
 test("cli browser init generator skips npm init when package.json already exists") do
   Dir.mktmpdir do |dir|
     File.write(File.join(dir, "Gemfile"), <<~RUBY)
@@ -2341,8 +2384,12 @@ test("cli rails init generator creates Rails browser scaffold and installation c
     expect(rails_fixture).to include("require 'smartest/rails'")
     expect(rails_fixture).to include("class RailsSystemTestFixture < Smartest::Fixture")
     expect(rails_fixture).to include("suite_fixture :rails_server")
-    expect(rails_fixture).to include("server cannot boot against the development database")
+    expect(rails_fixture).to include('ENV["RAILS_ENV"] = "test"')
+    expect(rails_fixture).to include('ENV["RACK_ENV"] = "test"')
+    expect(rails_fixture).not_to include('ENV["RAILS_ENV"] ||=')
+    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('host: ENV["SMARTEST_RAILS_TEST_SERVER_HOST"]')
     expect(rails_fixture).not_to include("bind_host:")
@@ -2398,6 +2445,112 @@ test("cli rails init generator creates Rails browser scaffold and installation c
   end
 end
 
+test("cli rails init generator forces Rails test environment when the generated fixture is required") do
+  Dir.mktmpdir do |dir|
+    FileUtils.mkdir_p(File.join(dir, "config"))
+    File.write(File.join(dir, "Gemfile"), <<~RUBY)
+      source "https://rubygems.org"
+
+      gem "rails"
+      gem "smartest"
+    RUBY
+    File.write(File.join(dir, "config/environment.rb"), <<~RUBY)
+      raise "RAILS_ENV was not set before loading Rails" unless ENV["RAILS_ENV"] == "test"
+      raise "RACK_ENV was not set before loading Rails" unless ENV["RACK_ENV"] == "test"
+
+      class User
+      end
+    RUBY
+
+    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)
+      module Smartest
+        class Fixture
+          def self.suite_fixture(*)
+          end
+
+          def self.fixture(*)
+          end
+        end
+
+        module Rails
+        end
+      end
+    RUBY
+    File.write(File.join(stub_dir, "playwright.rb"), "")
+
+    generator = Smartest::InitRailsGenerator.new(
+      root: dir,
+      output: StringIO.new,
+      command_runner: ->(_command, chdir:) { true }
+    )
+    generator.run
+
+    stdout, stderr, status = Open3.capture3(
+      {
+        "RUBYLIB" => stub_dir,
+        "RAILS_ENV" => "development",
+        "RACK_ENV" => "development"
+      },
+      "ruby",
+      "-e",
+      <<~RUBY
+        require #{File.join(dir, "smartest/fixtures/rails_system_fixture").inspect}
+        puts User.name
+      RUBY
+    )
+
+    expect(status.success?).to eq(true)
+    expect(stderr).to eq("")
+    expect(stdout).to eq("User\n")
+  end
+end
+
+test("cli rails init generator runs installation commands outside the current Bundler environment") do
+  require "bundler"
+
+  Dir.mktmpdir do |dir|
+    File.write(File.join(dir, "Gemfile"), <<~RUBY)
+      source "https://rubygems.org"
+
+      gem "rails"
+      gem "smartest"
+    RUBY
+
+    command_environments = []
+    output = StringIO.new
+    generator = Smartest::InitRailsGenerator.new(
+      root: dir,
+      output: output,
+      command_runner: ->(_command, chdir:) {
+        command_environments << {
+          bundle_gemfile: ENV["BUNDLE_GEMFILE"],
+          bundle_bin_path: ENV["BUNDLE_BIN_PATH"],
+          rubyopt: ENV["RUBYOPT"]
+        }
+        true
+      }
+    )
+
+    SmartestSelfTest.with_env(
+      "BUNDLE_GEMFILE" => File.join(dir, "Gemfile"),
+      "BUNDLE_BIN_PATH" => "/tmp/smartest-self-test-bundle",
+      "RUBYOPT" => "-rbundler/setup -W0"
+    ) do
+      status = generator.run
+      expect(status).to eq(0)
+    end
+
+    expect(command_environments.length).to eq(4)
+    expect(command_environments.all? do |environment|
+      environment[:bundle_gemfile].nil? &&
+        environment[:bundle_bin_path].nil? &&
+        !environment[:rubyopt].to_s.include?("bundler/setup")
+    end).to eq(true)
+  end
+end
+
 test("cli rails init generator skips browser install when requested by environment") do
   SmartestSelfTest.with_env("SMARTEST_SKIP_BROWSER_DOWNLOAD" => "1") do
     Dir.mktmpdir do |dir|

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: smartest
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.6.1
 platform: ruby
 authors:
 - Yusuke Iwaki
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-09 00:00:00.000000000 Z
+date: 2026-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake