capybara-screenshot-diff 1.6.3 → 1.8.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ecb7108c89946f6489787b491c0cd831f096d09ee656e68674887952682aee7a
-  data.tar.gz: d41e23dae6a64663d26b586235ccc4cdc10d02a43b3fefa6a8563327cde563bd
+  metadata.gz: 3e7e3bdfacb7c2fad912c72ade765c9ec6a50f306048a374d8056fc02c27d643
+  data.tar.gz: c1527905de61a1d801c545729d68b811ba91db5902c1ff209b4dc212fa252971
 SHA512:
-  metadata.gz: 89501dc8c7ab1b540d182dacd10f8bf2d3b24521851db20bed42eb7c066b484d5a5cfbc766a4a0d5c80539500c1eef342f55be4069da455ba1d2ba14524d2463
-  data.tar.gz: 12c02e086af0df03206eaa5ac332306b0b199c33d70b6393c64a60a70a5777e4598b4aedf67afc0a6aa06166247efd7e6a0c21652aa4c2587e13009566363b87
+  metadata.gz: c9c7868fe6d13263db039cf2a7fbb85234abee8f3bc05dd51fc5cc78579a96c1de3f2275782f5c806e9b154472ad51a991cfad1847a54d4811460597a3a4b8fe
+  data.tar.gz: 209f71e33b2b4bdead447293c0e286de6b6e1d945f4e12889e1b4f94675bb8bc035956f19a9897ceeedf278999598bb095991ecd34f2eaffa219d088ea19d577

data/Rakefile

@@ -16,3 +16,32 @@ Rake::TestTask.new("test:integration") do |t|
   t.libs << "lib"
   t.test_files = FileList["test/integration/**/*_test.rb"]
 end
+
+Rake::TestTask.new("test:signatures") do |t|
+  ENV["RBS_TEST_DOUBLE_SUITE"] ||= "minitest"
+  ENV["RBS_TEST_TARGET"] ||= "Capybara::Screenshot::Diff::*"
+  ENV["RBS_TEST_OPT"] ||= "-rset -rpathname -Isig"
+
+  t.libs << "test"
+  t.ruby_opts << "-r rbs/test/setup"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task "clobber" do
+  puts "Cleanup tmp/*.png"
+  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

@@ -12,15 +12,18 @@ Gem::Specification.new do |spec|
   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/donv/capybara-screenshot-diff"
-  spec.required_ruby_version = ">= 2.5.0"
+  spec.required_ruby_version = ">= 3.0.0"
   spec.license = "MIT"
   spec.metadata["allowed_push_host"] = "https://rubygems.org/"
-  spec.files = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.files = `git ls-files -z`.split("\x0").reject do |f|
+    f.match(%r{(^(\.|tmp|bin|test|spec|features|gemfiles|scripts)/)|(^(\.|Dockerfile|CONTRIBUTING|README))})
+  end
+
   spec.bindir = "exe"
   spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_runtime_dependency "actionpack", ">= 4.2", "< 8"
+  spec.add_runtime_dependency "actionpack", ">= 6.1", "< 8"
   spec.add_runtime_dependency "capybara", ">= 2", "< 4"
   spec.add_runtime_dependency "chunky_png", "~> 1.3"
 end

data/gems.rb

@@ -8,7 +8,7 @@ gemspec path: __dir__
 gem "rake"
 
 # Image processing libraries
-gem "oily_png", platform: :ruby
+gem "oily_png", platform: :ruby, git: "https://github.com/donv/oily_png", branch: "patch-2"
 gem "ruby-vips", require: false
 
 # Test
@@ -18,12 +18,18 @@ gem "simplecov", require: false
 
 # Capybara Server
 gem "puma", require: false
+gem "rackup", require: false
 
 # Capybara Drivers
 gem "cuprite", require: false
 gem "selenium-webdriver", require: false
-gem "webdrivers", require: false
+gem "webdrivers", "~> 5.0", require: false
+
+# Test Frameworks
+# gem "cucumber", require: false
+# gem "cucumber-rails", require: false
 
 group :tools do
   gem "standard", require: false
+  gem "rbs", require: false, platform: :ruby
 end

data/lib/capybara/screenshot/diff/browser_helpers.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+require_relative "region"
+
+module Capybara
+  module Screenshot
+    module BrowserHelpers
+      def self.resize_to(window_size)
+        if session.driver.respond_to?(:resize)
+          session.driver.resize(*window_size)
+        elsif BrowserHelpers.selenium?
+          session.driver.browser.manage.window.resize_to(*window_size)
+        end
+      end
+
+      def self.selenium?
+        current_capybara_driver_class <= Capybara::Selenium::Driver
+      end
+
+      def self.window_size_is_wrong?(expected_window_size = nil)
+        selenium? && expected_window_size &&
+          session.driver.browser.manage.window.size != ::Selenium::WebDriver::Dimension.new(*expected_window_size)
+      end
+
+      def self.bounds_for_css(*css_selectors)
+        css_selectors.reduce([]) do |regions, selector|
+          regions.concat(all_visible_regions_for(selector))
+        end
+      end
+
+      IMAGE_WAIT_SCRIPT = <<~JS
+        function pending_image() {
+          var images = document.images;
+          for (var i = 0; i < images.length; i++) {
+            if (!images[i].complete) {
+                return images[i].src;
+            }
+          }
+          return false;
+        }(window)
+      JS
+
+      HIDE_CARET_SCRIPT = <<~JS
+        if (!document.getElementById('csdHideCaretStyle')) {
+          let style = document.createElement('style');
+          style.setAttribute('id', 'csdHideCaretStyle');
+          document.head.appendChild(style);
+          let styleSheet = style.sheet;
+          styleSheet.insertRule("* { caret-color: transparent !important; }", 0);
+        }
+      JS
+
+      def self.hide_caret
+        session.execute_script(HIDE_CARET_SCRIPT)
+      end
+
+      FIND_ACTIVE_ELEMENT_SCRIPT = <<~JS
+        function activeElement(){
+          const ae = document.activeElement; 
+          if (ae.nodeName === "INPUT" || ae.nodeName === "TEXTAREA") { 
+            ae.blur();      
+            return ae;
+          }
+          return null;
+        }(window);
+      JS
+
+      def self.blur_from_focused_element
+        session.evaluate_script(FIND_ACTIVE_ELEMENT_SCRIPT)
+      end
+
+      GET_BOUNDING_CLIENT_RECT_SCRIPT = <<~JS
+        [
+          this.getBoundingClientRect().left,
+          this.getBoundingClientRect().top,
+          this.getBoundingClientRect().right,
+          this.getBoundingClientRect().bottom
+        ]
+      JS
+
+      def self.all_visible_regions_for(selector)
+        BrowserHelpers.session.all(selector, visible: true).map(&method(:region_for))
+      end
+
+      def self.region_for(element)
+        element.evaluate_script(GET_BOUNDING_CLIENT_RECT_SCRIPT).map { |point| point.negative? ? 0 : point.to_i }
+      end
+
+      def self.session
+        Capybara.current_session
+      end
+
+      def self.pending_image_to_load
+        BrowserHelpers.session.evaluate_script(IMAGE_WAIT_SCRIPT)
+      end
+
+      def self.current_capybara_driver_class
+        session.driver.class
+      end
+    end
+  end
+end

data/lib/capybara/screenshot/diff/cucumber.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require "capybara/screenshot/diff"
+require "capybara/screenshot/diff/test_methods"
+
+World(Capybara::Screenshot::Diff::TestMethods)
+
+Before do
+  Capybara::Screenshot::Diff.delayed = false
+  Capybara::Screenshot::BrowserHelpers.resize_to(Capybara::Screenshot.window_size) if Capybara::Screenshot.window_size
+end

data/lib/capybara/screenshot/diff/difference.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Capybara
+  module Screenshot
+    module Diff
+      class Difference < Struct.new(:region, :meta, :comparison)
+        def different?
+          !(blank? || tolerable?)
+        end
+
+        def base_image
+          comparison.base_image
+        end
+
+        def options
+          comparison.options
+        end
+
+        def tolerance
+          options[:tolerance]
+        end
+
+        def skip_area
+          options[:skip_area]
+        end
+
+        def area_size_limit
+          options[:area_size_limit]
+        end
+
+        def blank?
+          region.nil? || region_area_size.zero?
+        end
+
+        def region_area_size
+          region&.size || 0
+        end
+
+        def ratio
+          meta[:difference_level]
+        end
+
+        def to_h
+          {area_size: region_area_size, region: coordinates}.merge!(meta)
+        end
+
+        def coordinates
+          region&.to_edge_coordinates
+        end
+
+        def inspect
+          to_h.to_json
+        end
+
+        def tolerable?
+          !!((area_size_limit && area_size_limit >= region_area_size) || (tolerance && tolerance >= ratio))
+        end
+      end
+    end
+  end
+end

data/lib/capybara/screenshot/diff/drivers/base_driver.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "chunky_png"
+require "capybara/screenshot/diff/difference"
+
+module Capybara
+  module Screenshot
+    module Diff
+      # Compare two images and determine if they are equal, different, or within some comparison
+      # range considering color values and difference area size.
+      module Drivers
+        class BaseDriver
+          PNG_EXTENSION = ".png"
+
+          def same_dimension?(comparison)
+            dimension(comparison.base_image) == dimension(comparison.new_image)
+          end
+
+          def height_for(image)
+            image.height
+          end
+
+          def width_for(image)
+            image.width
+          end
+
+          def image_area_size(image)
+            width_for(image) * height_for(image)
+          end
+
+          def dimension(image)
+            [width_for(image), height_for(image)]
+          end
+
+          def inscribed?(dimensions, i)
+            width_for(i) < dimensions[0] || height_for(i) < dimensions[1]
+          end
+        end
+      end
+    end
+  end
+end