kind_dom 0.9.7 → 0.9.8

data/lib/kind_dom/base.rb

@@ -33,11 +33,14 @@ module KindDom
   class Base
   
     attr_reader :dom
+    attr_accessor :find_cache
   
     # A new KindDom object may be created from raw XML [string] data, or 
     # an already instantiated KindDom::Base, XML::Node or XML::Document.
     #
-    def initialize(xml_in=nil)
+    # Caches intermediate found values, before yielding to the optional block. 
+    # Disable the cache with opt `:find_cache => false` or set #find_cache to false
+    def initialize(xml_in=nil, opts={})
       unless xml_in.nil?
         case 
         when xml_in.kind_of?(KindDom::Base)
@@ -50,6 +53,7 @@ module KindDom
           @dom = parser.parse
         end
       end
+      @find_cache = {} if opts[:find_cache].nil? ? true : opts[:find_cache]
     rescue XML::Parser::ParseError
     end
   
@@ -62,17 +66,19 @@ module KindDom
     # (or default) before returning.
     #
     def content_for(xpath='.', default=nil)       # :yields: found_content
-      node = case @dom.class.to_s
-      when 'XML::Document' then
-        @dom.root.find_first(xpath)
-      else # 'XML::Node'
-        @dom.find_first(xpath)
-      end
-      content = case node.class.to_s
-      when 'XML::Attr' then
-        node.value
-      else
-        node.content
+      content = cache "content_for(#{xpath})" do
+        node = case @dom.class.to_s
+        when 'XML::Document' then
+          @dom.root.find_first(xpath)
+        else # 'XML::Node'
+          @dom.find_first(xpath)
+        end
+        case node.class.to_s
+        when 'XML::Attr' then
+          node.value
+        else
+          node.content
+        end
       end
     rescue NoMethodError
     ensure
@@ -92,7 +98,9 @@ module KindDom
     # (or default) before returning.
     #
     def collection_of(xpath, default=nil)      # :yields: found_collection
-      c = @dom.find(xpath).collect {|n| self.class.new(n) }
+      c = cache "collection_of(#{xpath})" do
+        @dom.find(xpath).collect {|n| self.class.new(n) }
+      end
     rescue NoMethodError
     ensure
       c = c.blank?||c.size<1 ? default : c
@@ -111,11 +119,13 @@ module KindDom
     # (or default) before returning.
     #
     def first_of(xpath, default=nil)      # :yields: found_node
-      n = case @dom.class.to_s
-      when 'XML::Document' then
-        @dom.root.find_first(xpath)
-      else # 'XML::Node'
-        @dom.find_first(xpath)
+      n = cache "first_of(#{xpath})" do
+        case @dom.class.to_s
+        when 'XML::Document' then
+          @dom.root.find_first(xpath)
+        else # 'XML::Node'
+          @dom.find_first(xpath)
+        end
       end
     rescue NoMethodError
     ensure
@@ -126,6 +136,17 @@ module KindDom
         return n
       end
     end
-  
+    
+    private
+    
+    def cache(key)
+      if @find_cache and @find_cache.has_key?(key)
+        x = @find_cache[key]
+      else
+        x = yield
+        @find_cache[key] = x if @find_cache
+      end
+      return x
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: kind_dom
 version: !ruby/object:Gem::Version 
-  version: 0.9.7
+  version: 0.9.8
 platform: ruby
 authors: 
 - Mars Hall
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-07-05 00:00:00 -07:00
+date: 2008-08-20 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency