chop 0.37.0 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f913987c39cc9d3a8c36fbd479af12e59fd8319415c15b24fcbd32e737af1aa
-  data.tar.gz: e85ac13a6ceabcad966813e1050ed5ce21f5d2db012453407458019c4c1c7a1e
+  metadata.gz: 0daeb281cda901500a0d95a2aee5ce2362322a930c36a395440093b6dcd41e5b
+  data.tar.gz: 73f5b4b2bc8ded47e68210efa01785842d8444770c68430a049aeb32e8f6d98f
 SHA512:
-  metadata.gz: 96d2f1ae11404d221fdc04d37b8d9f322fa5d1dc9f90e0dba798fcdc964d6492c5558d6c9911f5643318a7b2eb6bc850bc4790daca7737830b61101d4543ca22
-  data.tar.gz: 904edaee4530b7ed62c11f65791f5b1c55eaf9432e66d4b0b3dbe1f7bdb7c3813710fc295b4972a85f487cb66a40a7051f7d59ffb0cd2d5125b5b4a48c2247c3
+  metadata.gz: 375fba97039e7e2ad8f63ea1c111e66d0499193e458311c909497851115a8759f2ac1259df90a0fe5886748d73c75b040a48261170196d72295b694e2604d467
+  data.tar.gz: c95e301a217166638a1c6129334b59abc62f1b8950dd6317e7b9c2cf8c7223bceffba18db6aa91308682ac98c6b74d02aedba60ba59bc04db7a8a12cc2b355d6

data/README.md

@@ -26,6 +26,7 @@ All these methods accept blocks for customization.
 ### Configuration methods for `Chop`:
 
 * `.register_creation_strategy`: Provide a key and a block to register alternate strategies for `.create!`, e.g. FactoryGirl.
+* `.atomic_diff=`: When set to `true`, `#diff!` captures the root element's HTML in a single read and parses it locally with Nokogiri, avoiding multiple CDP round-trips that can cause stale element errors during DOM morphs (e.g. Turbo). Off by default. Can be overridden per-call with the `atomic:` keyword argument.
 
 ### Block methods for `#create!`:
 
@@ -55,7 +56,10 @@ Lifecycle hooks:
 
 Transform the table of Capybara nodes before converting them to text and passing to `diff!`.
 
-Overide Capybara finders:
+Options (keyword arguments):
+* `atomic: true/false`: Override the global `Chop.atomic_diff` setting for this call. Example: `table.diff! "table", atomic: true`
+
+Override Capybara finders:
 * `#rows`: overrides existing default row finder.
 * `#cells`: overrides existing default cell finder.
 * `#text`: overrides existing default text finder.

data/lib/chop/config.rb

@@ -1,7 +1,11 @@
 module Chop
   module Config
+    attr_accessor :atomic_diff
+
     def register_creation_strategy *args, &block
       Chop::Create.register_creation_strategy *args, &block
     end
   end
+
+  extend Config
 end

data/lib/chop/diff.rb

@@ -2,15 +2,18 @@ require "active_support/core_ext/string/inflections"
 require "active_support/core_ext/object/blank"
 require "active_support/core_ext/class/attribute"
 require "active_support/hash_with_indifferent_access"
+require "chop/config"
 require "chop/regex_templates"
 
 module Chop
   class Diff < Struct.new(:selector, :table, :session, :timeout, :block)
-    def self.diff! selector, table, session: Capybara.current_session, timeout: Capybara.default_max_wait_time, errors: [], **kwargs, &block
+    def self.diff! selector, table, session: Capybara.current_session, timeout: Capybara.default_max_wait_time, atomic: Chop.atomic_diff, errors: [], **kwargs, &block
       errors += session.driver.invalid_element_errors
       errors += [Cucumber::MultilineArgument::DataTable::Different]
       session.document.synchronize timeout, errors: errors do
-        new(selector, table, session, timeout, block).diff! **kwargs
+        instance = new(selector, table, session, timeout, block)
+        instance.instance_variable_set(:@atomic, atomic)
+        instance.diff! **kwargs
       end
     end
 
@@ -145,7 +148,10 @@ module Chop
       end
 
       rows.map do |row|
-        row.map { |cell| text_finder.call(cell) }
+        row.map do |cell|
+          text = text_finder.call(cell)
+          @atomic && text.is_a?(String) ? normalize_atomic_text(text) : text
+        end
       end
     end
 
@@ -172,13 +178,31 @@ module Chop
       end
     end
 
+    # Normalize text from a Nokogiri snapshot to match what Capybara drivers
+    # return from visible_text. Replicates Capybara::Node::WhitespaceNormalizer#normalize_spacing.
+    def normalize_atomic_text(text)
+      text
+        .delete("\u200b\u200e\u200f")
+        .tr(" \n\f\t\v\u2028\u2029", " ")
+        .squeeze(" ")
+        .sub(/\A[[:space:]&&[^\u00a0]]+/, "")
+        .sub(/[[:space:]&&[^\u00a0]]+\z/, "")
+        .tr("\u00a0", " ")
+    end
+
     def root
       @root ||= begin
-        if selector.is_a?(Capybara::Node::Element)
+        element = if selector.is_a?(Capybara::Node::Element)
           selector
         else
           session.find(selector, wait: timeout)
         end
+        if @atomic
+          html = element["outerHTML"] || element.native.to_html
+          Node(html)
+        else
+          element
+        end
       rescue Capybara::ElementNotFound
         raise unless @allow_not_found
         Node("")

data/lib/chop/version.rb

@@ -1,3 +1,3 @@
 module Chop
-  VERSION = "0.37.0"
+  VERSION = "0.38.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chop
 version: !ruby/object:Gem::Version
-  version: 0.37.0
+  version: 0.38.0
 platform: ruby
 authors:
 - Micah Geisel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-04 00:00:00.000000000 Z
+date: 2026-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord