chop 0.36.6 → 0.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a4d477e3610880a15f5ab315ad6c2f3a212f28f443147e363edc79508c7316b8
-  data.tar.gz: c0cdf43b5a9415e21216d1ed4babddee3a141d9651bf593d6ffac484b1d1140c
+  metadata.gz: 0daeb281cda901500a0d95a2aee5ce2362322a930c36a395440093b6dcd41e5b
+  data.tar.gz: 73f5b4b2bc8ded47e68210efa01785842d8444770c68430a049aeb32e8f6d98f
 SHA512:
-  metadata.gz: e3c86c9f999bdb1c9b2cbb8c721affa85008ae8cd65947311d182bdd1c5923d0aeedd14f4e2e75a6820c211a7e477a599e18628c2230c26dc6ef75530728d6ec
-  data.tar.gz: e51e524727d4a813a0e19756fdc9c82a389e2e30404eac8de13fd7f512fd4edf218ca96787b5c9a63e56e2dc2557115add2851cb2d408adfc0c6399de35e4185
+  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.
@@ -163,7 +167,7 @@ end
 
 Given "the following stories exist:" do |table|
   table.create! factory_girl: "conversation_table/story" do
-    belongs_to :industry, ConversationTable::Industry
+    belongs_to :industry # class is inferred from association reflection
 
     rename :image => :image_file
     file :image_file

data/chop.gemspec

@@ -23,6 +23,7 @@ Gem::Specification.new do |spec|
   spec.add_dependency "cucumber"
   spec.add_dependency "capybara"
 
+  spec.add_development_dependency "sqlite3", "~> 1.4"
   spec.add_development_dependency "appraisal"
   spec.add_development_dependency "rake"
   spec.add_development_dependency "rspec"

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/create.rb

@@ -159,7 +159,7 @@ module Chop
 
     def has_many key, klass=nil, delimiter: ", ", field: :name, find_by: nil
       field = find_by if find_by
-      klass ||= key.to_s.classify.constantize
+      klass ||= class_from_association(key)
       self.field key do |names|
         names.split(delimiter).map do |name|
           klass.find_by!(field => name)
@@ -169,7 +169,7 @@ module Chop
 
     def has_one key, klass=nil, field: :name, find_by: nil
       field = find_by if find_by
-      klass ||= key.to_s.classify.constantize
+      klass ||= class_from_association(key)
       self.field key do |name|
         klass.find_by!(field => name) if name.present?
       end
@@ -206,6 +206,12 @@ module Chop
         keys.replace keys.first.values
       end
     end
+
+    def class_from_association(key)
+      if self[:klass].respond_to?(:reflect_on_association)
+        self[:klass].reflect_on_association(key)&.klass
+      end || key.to_s.classify.constantize
+    end
   end
 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.36.6"
+  VERSION = "0.38.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chop
 version: !ruby/object:Gem::Version
-  version: 0.36.6
+  version: 0.38.0
 platform: ruby
 authors:
 - Micah Geisel
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-02-03 00:00:00.000000000 Z
+date: 2026-02-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord
@@ -52,6 +52,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.4'
 - !ruby/object:Gem::Dependency
   name: appraisal
   requirement: !ruby/object:Gem::Requirement