html_surgeon 0.3.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 128a0133d9c441981b5488fcd23ce7d1d199b295
-  data.tar.gz: 80cbf114adcbbf71b74ca8c2edc42af26bf32ee6
+  metadata.gz: 6988528869b8d0783dc66a3fc95ac318a39f44f4
+  data.tar.gz: 9b0a847987cf59900c58d88d68edf65a78c5d2cd
 SHA512:
-  metadata.gz: 383b56f154ac0bf797035ad02da5c9ce24bad52efc2d9e2e0659ff91cdce5df07654068845836b12a5cf36feb82f92f5766648424b835aea927ad50e4db8d818
-  data.tar.gz: 86d0f5ba4376e8337cb62ccf75341d46e72df559b422eca1ae3ac574d06eb58ce1237d08bbd5519677ef94d88ec0f60874e6270b0ca342444488080500ecffb2
+  metadata.gz: 9e5ffbded35f90903bc1aaa0af358dd903fa99024f122ff20195b4c91b667d8842136aa31546422ec12ee81d045be4d13d7ac6562c0844e3314ac260778b9ee8
+  data.tar.gz: 8baf36739a718bb7eb98a0208ebb92ef2564a8349492062cb5bac7275252d7449d8802a00c56481c45b711e26a54629f779a88db28b3cbd9ff5ec9e8464dec2d

data/README.md

@@ -165,6 +165,16 @@ change_set = surgeon.css('div.to-be-changed')
 change_set = surgeon.xpath("span") # note that we use Nokogiri's HTML Fragment and the use of self is special.
 ```
 
+### Refining the selection
+
+we can skip some nodes based on callbacks added to the Change Set using `select` and `reject` methods.
+
+```ruby
+change_set = surgeon.css('.to-be-changed')
+change_set.reject { |node| node.name == 'div' }.select { |node| node.get_attribute('class').to_s.split(' ').include? 'yeah-do-it' }
+change_set.run # => nodes skipped if reject callback return truthy or if select callback return falsey 
+```
+
 ## Available Changes
 
 ### Replace Tag Name
@@ -228,6 +238,10 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/eturin
 
 ## CHANGESET
 
+### v0.4.0
+
+- added `select` and `reject` callbacks to Change Set, based on blocks with `node` as single argument
+
 ### v0.3.0
 
 - added fluid ChangeSet ID setter

data/lib/html_surgeon/change_set.rb

@@ -1,7 +1,7 @@
 module HtmlSurgeon
 
   class ChangeSet
-    attr_reader :node_set, :base, :change_list, :run_time
+    attr_reader :node_set, :base, :change_list, :run_time, :refinement_callbacks
 
     def self.create(node_set, base)
       new_class.new node_set, base
@@ -16,11 +16,12 @@ module HtmlSurgeon
     end
 
     def initialize(node_set, base)
-      @node_set    = node_set
-      @base        = base
-      @change_list = []
-      @id          = SecureRandom.uuid
-      @run_time    = nil
+      @node_set             = node_set
+      @base                 = base
+      @change_list          = []
+      @id                   = SecureRandom.uuid
+      @run_time             = nil
+      @refinement_callbacks = []
     end
 
     delegate :audit?, :html, to: :base
@@ -51,6 +52,16 @@ module HtmlSurgeon
       change_list.map &:log
     end
 
+    def select(&block)
+      refinement_callbacks << [:select, block]
+      self
+    end
+
+    def reject(&block)
+      refinement_callbacks << [:reject, block]
+      self
+    end
+
     # CHANGES
 
     private
@@ -61,6 +72,19 @@ module HtmlSurgeon
     end
 
     def apply_on_node(node)
+      refinement_callbacks.each do |(type, refinement)|
+        case type
+        when :select
+          return false unless refinement.call(node)
+        when :reject
+          return false if refinement.call(node)
+        end
+      end
+
+      do_apply_on_node(node)
+    end
+
+    def do_apply_on_node(node)
       change_list.each do |change|
         change.apply(node)
       end

data/lib/html_surgeon/version.rb

@@ -1,3 +1,3 @@
 module HtmlSurgeon
-  VERSION = "0.3.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: html_surgeon
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Eduardo Turiño