lookbook_visual_tester 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3f7d81d326a95c67665b1e7bc5f0e253069f92f4dd9755520da6a915609b8111
-  data.tar.gz: 9d5e4fbd12263bffa84e6be352dfcc2dc36a86ea32a7437ec7d310e605cfd87a
+  metadata.gz: d94b40b51271e7c94f1107872615622267d87fea8a4daefd0e3454b4b768f9f1
+  data.tar.gz: f7768f6d78d43b0e42b04cfca1ef4d23e41b932fe1d0005c53e580206a261ee3
 SHA512:
-  metadata.gz: 87f5ee0e350a62685aa7d5c9e7d78dc85c59716c9d0e0ec02b02270a95c21852046b42b8bd9a4b0020b3fe0f9396b4162ad2e00ddc9d6edb9f0707cc88cf51da
-  data.tar.gz: 24b7dd96bc5b536b6e51d6987dc87c3cb5818a6d43ba70ff6f16640525cd9963a38aae6ea249add02e60c53496a5477f92a628eee7bc88be7ec4111de118ac68
+  metadata.gz: 00ed31dbc76cc7baf465ce2875416862f9e4772e114c015798944fa0a1aef81d461cad7dd27456fbed685c1d9bd2454cef1c073cb082d913bc18c986d5493a83
+  data.tar.gz: 2b5a9a9f81b96eef19e3b0e1cf3ff4f49b3d6d9e26216650f31a1c75c4ddb7e966af4785de2323761df15dbb928cdb271a394068b77f1667819c521cd57f7372

data/.env.example

@@ -0,0 +1,13 @@
+# RubyGems release credentials. Copy to .env and fill in.
+# Get an API key at: https://rubygems.org/profile/api_keys
+# For a release-only key, enable the "Push rubygem" scope (and MFA if your
+# account requires it). Keep this file private — never commit the real .env.
+#
+#   cp .env.example .env
+#   # edit .env, then: rake release:gem
+
+RUBYGEMS_API_KEY=
+
+# Optional: if your account has MFA enabled for API access, set the current
+# one-time code here (or pass it at the prompt via `rake release:otp`).
+# GEM_HOST_OTP_CODE=

data/CHANGELOG.md

@@ -1,4 +1,30 @@
 # Changelog
+## [0.7.0] - 2026-08-09
+
+### Removed
+- `cuprite` runtime dependency; legacy `LookbookVisualTester::SessionManager`, `CapybaraSetup`, `ScreenshotTaker`, and `BaselineManager` classes.
+- ImageMagick `convert` and `compare` shell calls from the visual regression path.
+- Hard-coded Devise/Warden/Pundit auth mocking inside the gem.
+- Lookbook 1.x (`examples`) fallback — only Lookbook 2.x (`scenarios`) is supported.
+- Global `$stdout` mutation in rake tasks.
+- Version-fragile `check_preview_controller_config` introspection in `PreviewChecker`.
+
+### Added
+- Pure-Ruby `LookbookVisualTester::ImageTrimmer` (ChunkyPNG) — no ImageMagick needed to trim screenshots.
+- `config.preview_checker_setup` host hook for providing auth/helpers during deep checks.
+- `LookbookVisualTester::ServerTestRunner` and `rake lookbook:server_and_test` for unattended agent/CI runs (process-group cleanup, log capture, configurable timeout).
+- `Runner#initialize(..., output:)` — injectable output stream for thread-safe/quiet runs.
+- `LookbookVisualTester::BrowserDiscovery` plus `config.browser_path` / `LOOKBOOK_BROWSER_PATH` to resolve a real Chrome binary, avoiding PATH-resolved wrapper scripts that break headless mode.
+- `config.browser_options` (defaults to `{ "headless" => "new" }`), `config.browser_timeout`, and `config.process_timeout` for robust modern-Chrome launches.
+
+### Changed
+- `copy_to_clipboard` now defaults to `false` (opt in to `xclip`).
+- `automatic_run` is parsed as a boolean from the `LOOKBOOK_AUTOMATIC_RUN` env var.
+- The Railtie `Lookbook.after_change` auto-run hook now drives the Ferrum `Runner` instead of the deleted Capybara `ScreenshotTaker`.
+- `Runner#run_scenario` decomposed into focused private methods; the concurrent path stores its driver per-thread.
+- `lookbook:approve` matches namespaced previews by exact base name or `_suffix`, so approving `ui/button/default` no longer also approves `ui_button_defaultmobile`.
+- Ferrum dependency bumped to `>= 0.16` and launches with `--headless=new`, fixing "Multiple targets are not supported in headless mode" on modern Chrome builds.
+
 ## [0.6.0] - 2026-01-12
 
 ### Fixed

data/README.md

@@ -12,19 +12,16 @@ A powerful visual regression testing tool for [ViewComponent](https://viewcompon
 - **Intelligent Diffing**: High-quality image comparison using `chunky_png`.
 - **Human-Friendly Aesthetics**: Context is rendered with a light blue tint to make red highlights of differences pop.
 - **Robust Capture**: Automatically disables animations, waits for network idle, and allows masking/cropping.
-- **Lookbook Support**: Compatible with both Lookbook 1.x (`examples`) and 2.x (`scenarios`).
+- **Lookbook Support**: Compatible with Lookbook 2.x (`scenarios`).
 - **Internal Test Harness**: Includes a dummy Rails app for self-contained testing and development.
 
 ## Installation
 
 ### System Dependencies
 
-The gem requires `imagemagick` for image processing and `xclip` for clipboard integration (Linux).
+The gem uses [Ferrum](https://github.com/rubycdp/ferrum) (Chrome) and [ChunkyPNG](https://github.com/wvanbergen/chunky_png) for image processing. You need a Chrome-compatible browser installed locally. **No ImageMagick or `xclip` required.**
 
-For Ubuntu-based systems:
-```bash
-sudo apt-get install imagemagick xclip
-```
+Clipboard support via `xclip` is optional and opt-in (`config.copy_to_clipboard = true`).
 
 ### Gem Installation
 
@@ -46,12 +43,16 @@ You can configure the tester in a Rails initializer:
 
 ```ruby
 LookbookVisualTester.configure do |config|
-  config.lookbook_host = "http://localhost:3000" # Where your rails app is running
+  config.lookbook_host = "http://localhost:5000" # Where your rails app is running
   config.base_path = "coverage/screenshots"    # Root for screenshots
-  config.copy_to_clipboard = true                # Enable xclip support
+  config.copy_to_clipboard = false               # Default: off; opt in to xclip
   config.threads = 4                             # Number of parallel threads (default: 4)
   config.wait_time = 0.5                         # Optional: Wait time (seconds) before screenshot (fixes blank screens)
-  config.tolerance = 0.05                        # Optional: Mismatch tolerance (0.0 to 1.0) to ignore minor rendering differences
+  config.tolerance = 0.0                         # Optional: Mismatch tolerance (0.0 to 1.0) to ignore minor rendering differences
+  config.preview_checker_setup = -> {
+    # Provide auth/helpers for deep checks, e.g.:
+    # Current.user = LookbookFixtures.demo_user
+  }
 end
 ```
 
@@ -83,6 +84,14 @@ Runs all Lookbook previews, generates a terminal summary, and creates an HTML re
 bundle exec rake lookbook:test
 ```
 
+#### Start Server, Test, Stop (for agents/CI)
+Starts Rails, waits for Lookbook to be reachable, runs `lookbook:test`, and stops the server.
+```bash
+bundle exec rake lookbook:server_and_test
+```
+
+Set `LOOKBOOK_SERVER_TIMEOUT` (seconds) and optional `LOOKBOOK_SERVER_LOG` (path to capture server output) as needed.
+
 #### Test a Specific Preview
 Filter previews by name or label.
 ```bash

data/Rakefile

@@ -22,4 +22,57 @@ namespace :release do
     ENV['GEM_HOST_OTP_CODE'] = otp
     Rake::Task['release'].invoke
   end
+
+  desc 'Build the gem and push it to RubyGems (reads .env / RUBYGEMS_API_KEY)'
+  task :gem do
+    require 'fileutils'
+    load_dotenv
+
+    api_key = ENV['RUBYGEMS_API_KEY'] || ENV['GEM_HOST_API_KEY']
+    unless api_key
+      abort <<~MSG
+        Missing RubyGems API key.
+        Set RUBYGEMS_API_KEY (or GEM_HOST_API_KEY) in your environment or .env:
+          https://rubygems.org/profile/api_keys  (enable MFA scopes as needed)
+        Then run: rake release:gem
+      MSG
+    end
+
+    write_credentials(api_key)
+    Rake::Task['build'].invoke
+
+    gem_path = Dir.glob('pkg/*.gem').max_by { |f| File.mtime(f) }
+    push_cmd = ['gem', 'push', gem_path]
+    push_cmd += ['--otp', ENV['GEM_HOST_OTP_CODE']] if ENV['GEM_HOST_OTP_CODE']
+    sh(*push_cmd)
+  end
+
+  def load_dotenv
+    path = File.expand_path('.env', Dir.pwd)
+    return unless File.file?(path)
+    File.readlines(path).each do |line|
+      line = line.strip
+      next if line.empty? || line.start_with?('#')
+      key, val = line.split('=', 2)
+      next unless key && val
+      ENV[key] = val.delete_suffix("\n").strip unless ENV.key?(key)
+    end
+  end
+
+  def write_credentials(api_key)
+    creds_path = File.expand_path('~/.gem/credentials')
+    creds = if File.file?(creds_path)
+              File.read(creds_path)
+            else
+              ''
+            end
+    updated = if creds =~ /^:rubygems_api_key: /
+               creds.gsub(/^:rubygems_api_key: .*/, ":rubygems_api_key: #{api_key}")
+             else
+               creds + ":rubygems_api_key: #{api_key}\n"
+             end
+    FileUtils.mkdir_p(File.dirname(creds_path))
+    File.write(creds_path, updated)
+    FileUtils.chmod(0o600, creds_path)
+  end
 end