snap_diff-capybara 2.0.0.beta2 → 2.0.0.beta4

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: snap_diff-capybara
 version: !ruby/object:Gem::Version
-  version: 2.0.0.beta2
+  version: 2.0.0.beta4
 platform: ruby
 authors:
 - Uwe Kubosch
-bindir: exe
+bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -69,7 +69,8 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '4'
-description: Save screen shots and track changes with graphical diff
+description: Take screenshots in your Capybara tests, commit the baselines to git,
+  and let your suite fail on unintended visual changes. Runs offline, no SaaS.
 email:
 - uwe@kubosch.no
 executables: []
@@ -77,16 +78,12 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- CODE_OF_CONDUCT.md
 - LICENSE.txt
-- Rakefile
-- capybara-screenshot-diff.gemspec
-- docs/RELEASE_PREP.md
+- README.md
 - docs/UPGRADING.md
 - docs/architecture.md
 - docs/ci-integration.md
 - docs/configuration.md
-- docs/docker-testing.md
 - docs/drivers.md
 - docs/framework-setup.md
 - docs/images/snap_diff_annotated.png
@@ -96,7 +93,6 @@ files:
 - docs/reporters.md
 - docs/snapdiff.md
 - docs/thread_safety.md
-- gems.rb
 - lib/capybara-screenshot-diff.rb
 - lib/capybara/screenshot/diff.rb
 - lib/capybara/screenshot/diff/annotation_service.rb
@@ -133,6 +129,7 @@ files:
 - lib/capybara_screenshot_diff/snap.rb
 - lib/capybara_screenshot_diff/snap_manager.rb
 - lib/capybara_screenshot_diff/static.rb
+- lib/snap_diff-capybara.rb
 - lib/snap_diff.rb
 - lib/snap_diff/annotation_service.rb
 - lib/snap_diff/area_calculator.rb
@@ -157,6 +154,7 @@ files:
 - lib/snap_diff/legacy_shims.rb
 - lib/snap_diff/os.rb
 - lib/snap_diff/region.rb
+- lib/snap_diff/removal.rb
 - lib/snap_diff/reporters/default.rb
 - lib/snap_diff/reporters/html.rb
 - lib/snap_diff/reporters/templates/report.html.erb
@@ -177,6 +175,11 @@ licenses:
 - MIT
 metadata:
   allowed_push_host: https://rubygems.org/
+  bug_tracker_uri: https://github.com/snap-diff/snap_diff-capybara/issues
+  changelog_uri: https://github.com/snap-diff/snap_diff-capybara/blob/master/CHANGELOG.md
+  documentation_uri: https://github.com/snap-diff/snap_diff-capybara/blob/master/docs/snapdiff.md
+  rubygems_mfa_required: 'true'
+  source_code_uri: https://github.com/snap-diff/snap_diff-capybara
 rdoc_options: []
 require_paths:
 - lib
@@ -193,5 +196,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 4.0.16
 specification_version: 4
-summary: Track your GUI changes with diff assertions
+summary: Visual regression testing for Capybara — screenshot diffs in your test suite
 test_files: []

data/CODE_OF_CONDUCT.md

@@ -1,129 +0,0 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, religion, or sexual identity
-and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment for our
-community include:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes,
-  and learning from the experience
-* Focusing on what is best not just for us as individuals, but for the
-  overall community
-
-Examples of unacceptable behavior include:
-
-* The use of sexualized language or imagery, and sexual attention or
-  advances of any kind
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information, such as a physical or email
-  address, without their explicit permission
-* Other conduct which could reasonably be considered inappropriate in a
-  professional setting
-
-## Enforcement Responsibilities
-
-Community leaders are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-Community leaders have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, and will communicate reasons for moderation
-decisions when appropriate.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-Examples of representing our community include using an official e-mail address,
-posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement by
-[opening a GitHub Issue](https://github.com/snap-diff/snap_diff-capybara/issues).
-
-All complaints will be reviewed and investigated promptly and fairly.
-
-All community leaders are obligated to respect the privacy and security of the
-reporter of any incident.
-
-## Enforcement Guidelines
-
-Community leaders will follow these Community Impact Guidelines in determining
-the consequences for any action they deem in violation of this Code of Conduct:
-
-### 1. Correction
-
-**Community Impact:** Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome in the community.
-
-**Consequence:** A private, written warning from community leaders, providing
-clarity around the nature of the violation and an explanation of why the
-behavior was inappropriate. A public apology may be requested.
-
-### 2. Warning
-
-**Community Impact:** A violation through a single incident or series
-of actions.
-
-**Consequence:** A warning with consequences for continued behavior. No
-interaction with the people involved, including unsolicited interaction with
-those enforcing the Code of Conduct, for a specified period of time. This
-includes avoiding interactions in community spaces as well as external channels
-like social media. Violating these terms may lead to a temporary or
-permanent ban.
-
-### 3. Temporary Ban
-
-**Community Impact:** A serious violation of community standards, including
-sustained inappropriate behavior.
-
-**Consequence:** A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time. No public or
-private interaction with the people involved, including unsolicited interaction
-with those enforcing the Code of Conduct, is allowed during this period.
-Violating these terms may lead to a permanent ban.
-
-### 4. Permanent Ban
-
-**Community Impact:** Demonstrating a pattern of violation of community
-standards, including sustained inappropriate behavior, harassment of an
-individual, or aggression toward or disparagement of classes of individuals.
-
-**Consequence:** A permanent ban from any sort of public interaction within
-the community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-https://www.contributor-covenant.org/version/2/1/code_of_conduct.html.
-
-Community Impact Guidelines were inspired by
-[Mozilla's code of conduct enforcement ladder](https://github.com/mozilla/diversity).
-
-[homepage]: https://www.contributor-covenant.org
-
-For answers to common questions about this code of conduct, see the FAQ at
-https://www.contributor-covenant.org/faq. Translations are available at
-https://www.contributor-covenant.org/translations.

data/Rakefile

@@ -1,65 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rake/testtask"
-
-task default: :test
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
-end
-
-Rake::TestTask.new("test:unit") do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/unit/**/*_test.rb"]
-end
-
-Rake::TestTask.new("test:integration") do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/integration/**/*_test.rb"]
-end
-
-desc "Run all tests with coverage"
-task :coverage do
-  ENV["COVERAGE"] = "true"
-  Rake::Task["test"].invoke
-end
-
-desc "Generate sample HTML report. Use bin/rake 'report:sample[embed]' for base64 images"
-task "report:sample", [:embed] do |_t, args|
-  embed_arg = args[:embed] ? "--embed" : ""
-  ruby "scripts/generate_sample_report.rb #{embed_arg}"
-end
-
-desc "Remove screenshot diff artifacts (keeps baselines)"
-task "snap_diff:clean" do
-  patterns = ["**/*.diff.png", "**/*.base.png", "**/*.base.diff.png", "**/*.heatmap.diff.png",
-    "**/*.diff.webp", "**/*.base.webp", "**/*.base.diff.webp", "**/*.heatmap.diff.webp",
-    "**/snap_diff_report.html"]
-  removed = patterns.flat_map { |p| Dir.glob("tmp/#{p}") + Dir.glob("doc/screenshots/#{p}") }.uniq
-  removed.each { |f| FileUtils.rm_f(f) }
-  puts "Removed #{removed.size} diff artifacts"
-end
-
-task "clobber" do
-  puts "Cleanup tmp/"
-  FileUtils.rm_rf(Dir["./tmp/*"])
-end
-
-task "test:benchmark" do
-  require_relative "scripts/benchmark/find_region_benchmark"
-  benchmark = Capybara::Screenshot::Diff::Drivers::FindRegionBenchmark.new
-
-  puts "For Medium Screen Size: 800x600"
-  benchmark.for_medium_size_screens
-
-  puts ""
-  puts "*" * 100
-
-  puts "For Small Screen Size: 80x60"
-  benchmark.for_small_images
-end

data/capybara-screenshot-diff.gemspec

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-lib = File.expand_path("lib", __dir__)
-$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require "capybara/screenshot/diff/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "capybara-screenshot-diff"
-  spec.version = Capybara::Screenshot::Diff::VERSION
-  spec.authors = ["Uwe Kubosch"]
-  spec.email = ["uwe@kubosch.no"]
-  spec.summary = "Track your GUI changes with diff assertions"
-  spec.description = "Save screen shots and track changes with graphical diff"
-  spec.homepage = "https://github.com/snap-diff/snap_diff-capybara"
-  spec.required_ruby_version = ">= 3.2"
-  spec.license = "MIT"
-  spec.metadata["allowed_push_host"] = "https://rubygems.org/"
-  spec.files = `git ls-files -z`.split("\x0").reject do |f|
-    f.match(%r{(^(\.|tmp|bin|test|spec|features|gemfiles|scripts|foo)/)|(^(\.|Dockerfile|CONTRIBUTING|README))})
-  end
-
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  spec.add_development_dependency "actionpack", ">= 7.1", "< 9"
-  spec.add_development_dependency "activesupport", ">= 7.1", "< 9"
-  spec.add_runtime_dependency "capybara", ">= 2", "< 4"
-end

data/docs/RELEASE_PREP.md

@@ -1,44 +0,0 @@
-# Release Preparation — v1.15.1
-
-## Summary
-
-HIGH-severity VipsDriver resize fix (retina halving could enlarge screenshots
-and corrupt baselines) plus the driver contract tests that caught it.
-
-## Release Checklist
-
-### Pre-Release
-
-- [x] Update version to `1.15.1`
-- [x] Run tests: `bundle exec rake test:unit` (376 runs, 0 failures)
-- [x] Update CHANGELOG.md
-
-### Release (One Click)
-
-1. Push to GitHub
-2. Go to [Actions → Release](https://github.com/snap-diff/snap_diff-capybara/actions/workflows/release.yml)
-3. Click **Run workflow**, enter `1.15.1`
-4. Workflow will: test → tag → publish to RubyGems → create GitHub Release
-
-### Post-Release
-
-- [ ] Verify on [RubyGems](https://rubygems.org/gems/capybara-screenshot-diff)
-- [ ] Verify GitHub Release created
-
-## What Changed
-
-### Added
-- `SnapDiff::Config` — flat, additive consolidation of all 27 settings
-  (`SnapDiff.config` / `SnapDiff.configure`); old accessors stay canonical
-
-### Fixed
-- `pending_if_new` no longer converts real teardown/after-hook failures into
-  pending tests (Minitest defers to `after_teardown`; RSpec uses `append_after`;
-  known residual for consumer `append_after` hooks documented)
-- `BacktraceFilter` custom `lib_directory` matches on a path boundary
-
-### Internal
-- Guard tests for failure masking and skip-area/VCS-baseline regressions;
-  two files merged into sole consumers (constant paths preserved)
-
-See [CHANGELOG.md](../CHANGELOG.md) for full details.

data/docs/docker-testing.md

@@ -1,24 +0,0 @@
-# Docker Testing
-
-## Running tests in Docker
-
-Screenshot tests depend on exact browser rendering, which varies across OS and browser versions. Use `bin/dtest` to run tests inside Docker for consistent, reproducible results matching CI:
-
-```bash
-bin/dtest                          # Run all tests with all drivers
-bin/dtest test/integration/        # Run specific test directory
-```
-
-This builds a Docker image with Chrome and runs the test suite against three Capybara drivers: `cuprite`, `selenium_chrome_headless`, and `selenium_headless`.
-
-## Recording baseline screenshots
-
-Screenshot baselines are committed to the repo and compared against during tests. When you set up the project for the first time, or after upgrading the browser/driver, you need to re-record them:
-
-```bash
-RECORD_SCREENSHOTS=1 bin/dtest
-```
-
-This skips screenshot comparisons and saves new baselines instead. Without this step, tests will fail because your local browser renders pixels differently from the previously committed baselines.
-
-[← Back to README](../README.md)

data/gems.rb

@@ -1,39 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in capybara-screenshot-diff.gemspec
-gemspec path: __dir__
-
-gem "rake"
-
-# Image processing libraries
-gem "chunky_png", ">= 1.3", require: false
-gem "oily_png", platform: :ruby, git: "https://github.com/wvanbergen/oily_png", ref: "44042006e79efd42ce4b52c1d78a4c70f0b4b1b2"
-gem "ruby-vips", require: false
-
-group :test do
-  gem "capybara", ">= 3.26"
-  gem "mutex_m" # Needed for RubyMine debugging.  Try removing it.
-  gem "minitest", "< 6", require: false
-  gem "minitest-mock", require: false
-  gem "minitest-stub-const", require: false
-  gem "simplecov", require: false
-  gem "rspec", require: false
-end
-
-# Capybara Server
-gem "puma", require: false
-gem "rackup", require: false
-
-# Capybara Drivers
-gem "cuprite", require: false
-gem "selenium-webdriver", ">= 4.11", require: false
-
-# Test Frameworks
-# gem "cucumber", require: false
-# gem "cucumber-rails", require: false
-
-group :tools do
-  gem "standard", require: false
-end