html_surgeon 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 94d817ba0e3871c050f1d56fd80034cfc389562c
-  data.tar.gz: aca28c4bcc429fd9e7ea1294c3f81896f641cda2
+  metadata.gz: 128a0133d9c441981b5488fcd23ce7d1d199b295
+  data.tar.gz: 80cbf114adcbbf71b74ca8c2edc42af26bf32ee6
 SHA512:
-  metadata.gz: ebe07e4c500cdaa9b95b852abb1e3b894eb3805c6ebfa9fac34fa0a56d34f3488700a025ac3f0cb1a5df1d6f194634b9724afea8c9769a09428148ea7219e8e1
-  data.tar.gz: c348f793ae6186dceb2f00db9269b45a0477d1e816b2084b672eb431b09d6d8e8a7d3147cff48ecb34bfc55ce35f12ec854ee6d28756eafb8f4bb068bcb3035e
+  metadata.gz: 383b56f154ac0bf797035ad02da5c9ce24bad52efc2d9e2e0659ff91cdce5df07654068845836b12a5cf36feb82f92f5766648424b835aea927ad50e4db8d818
+  data.tar.gz: 86d0f5ba4376e8337cb62ccf75341d46e72df559b422eca1ae3ac574d06eb58ce1237d08bbd5519677ef94d88ec0f60874e6270b0ca342444488080500ecffb2

data/README.md

@@ -147,7 +147,7 @@ the attribute's value (formatted) is:
 ]
 ```
 
-it has a `change_set` with the UUID of the change set, `changed_at` with the moment it was applied, and the rest define the change.
+it has a `change_set` with the ID of the change set, `changed_at` with the moment it was applied, and the rest define the change.
 
 ## Selecting the Node Set
 
@@ -161,8 +161,9 @@ change_set = surgeon.css('div.to-be-changed')
 
 ### using xpath
 
-not implemented yet.
-
+```ruby
+change_set = surgeon.xpath("span") # note that we use Nokogiri's HTML Fragment and the use of self is special.
+```
 
 ## Available Changes
 
@@ -227,5 +228,10 @@ Bug reports and pull requests are welcome on GitHub at https://github.com/eturin
 
 ## CHANGESET
 
-### v 0.2.0
-- added `rollback support
+### v0.3.0
+
+- added fluid ChangeSet ID setter
+- added change_set xpath support
+
+### v0.2.0
+- added rollback support

data/lib/html_surgeon/change.rb

@@ -7,7 +7,7 @@ module HtmlSurgeon
 
     attr_reader :change_set
     delegate :audit?, to: :change_set
-    delegate :uuid, :run_time, to: :change_set, prefix: true
+    delegate :id, :run_time, to: :change_set, prefix: true
 
     def initialize(change_set:)
       @change_set = change_set
@@ -34,7 +34,7 @@ module HtmlSurgeon
     private
     def basic_audit_data
       {
-        change_set: change_set_uuid,
+        change_set: change_set_id,
         changed_at: change_set_run_time
       }
     end

data/lib/html_surgeon/change_set.rb

@@ -1,7 +1,7 @@
 module HtmlSurgeon
 
   class ChangeSet
-    attr_reader :node_set, :base, :change_list, :uuid, :run_time
+    attr_reader :node_set, :base, :change_list, :run_time
 
     def self.create(node_set, base)
       new_class.new node_set, base
@@ -19,7 +19,7 @@ module HtmlSurgeon
       @node_set    = node_set
       @base        = base
       @change_list = []
-      @uuid        = SecureRandom.uuid
+      @id          = SecureRandom.uuid
       @run_time    = nil
     end
 
@@ -27,6 +27,16 @@ module HtmlSurgeon
 
     # TODO: #preview, like run but in another doc, does not change it yet.
 
+    # chainable fluid ID setter
+    def id(custom_id = nil)
+      if custom_id
+        @id = custom_id
+        self
+      else
+        @id
+      end
+    end
+
     def run
       @run_time = Time.now.utc
 

data/lib/html_surgeon/service.rb

@@ -21,6 +21,11 @@ module HtmlSurgeon
       ChangeSet.create(node_set, self)
     end
 
+    def xpath(xpath_selector)
+      node_set = doc.xpath(xpath_selector)
+      ChangeSet.create(node_set, self)
+    end
+
     def rollback(change_set: nil, changed_at: nil, changed_from: nil)
       doc.css("[#{DATA_CHANGE_AUDIT_ATTRIBUTE}]").each do |node|
         NodeReverser.new(node: node, change_set: change_set, changed_at: changed_at, changed_from: changed_from).call

data/lib/html_surgeon/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: html_surgeon
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Eduardo Turiño
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-07-02 00:00:00.000000000 Z
+date: 2015-07-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: nokogiri