resync 0.1.3 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7788451959096dfbc4797cbf223b4817f2058ed4
-  data.tar.gz: e50c9e4839b2a595cb8cb1685f3bbd1b7a4a06c4
+  metadata.gz: aeaccafe9b78c6c1b73438dbc3615691e55acf37
+  data.tar.gz: 20ca197220dff4f8ac252d1fd3060446fad6e5e4
 SHA512:
-  metadata.gz: f138fb16a10639f60575f198db8d320b8b17e411fb2d8dc5a78b9a75742cfcfd55991c6dee6367e3d13b7c3e7c090ccc9ac8cd85bca9049b0aa5330d65ce57ee
-  data.tar.gz: 7b916f07c91848b65cfd3c390bdb321eec05a86dcd4e49745ca4f32d49a8913b1343242a635cb3dc75b69f4c6900ddde3dffde6f0e99ff322a9efbc94e97c032
+  metadata.gz: b82cd0986b56ea9aed5f12abc1532ead2bb942128938fed721b68fee918987acbc8fdb8683074d0669c5999cd9036d6b28c72b184ab39d44ed2f8928c48f2d85
+  data.tar.gz: eb88c946de862ab36cf3be1f9c01ff94f1f5ebe01d586ae6424bc729c004f0c6c80fd8b8a779415502c550faed3b350ee0f56b3e6c53e3d2e6273bd3934d10a9

data/CHANGES.md

@@ -1,3 +1,9 @@
+## 0.2.0
+
+- `BaseResourceList#resources` now returns an `IndexableLazy` instead of a plain array.
+- Added `BaseResourcesList#resources_in` to filter resource lists by time. 
+- All `Augmented` objects now expose the complete set of time attribtues, so as to avoid having to fish around in the metadata.
+
 ## 0.1.3
 
 - Fix issue making it difficult to extend CapabilityList

data/lib/resync/resource_list.rb

@@ -10,6 +10,5 @@ module Resync
 
     # The capability provided by this type.
     CAPABILITY = 'resourcelist'
-
   end
 end

data/lib/resync/shared/augmented.rb

@@ -72,5 +72,22 @@ module Resync
     def link_for(rel:)
       links.find { |l| l.rel == rel }
     end
+
+    def at_time
+      metadata.at_time if metadata
+    end
+
+    def from_time
+      metadata.from_time if metadata
+    end
+
+    def until_time
+      metadata.until_time if metadata
+    end
+
+    def completed_time
+      metadata.completed_time if metadata
+    end
+
   end
 end

data/lib/resync/shared/base_resource_list.rb

@@ -8,8 +8,8 @@ module Resync
   # must define a +CAPABILITY+ constant identifying the capability
   # they represent (e.g. +resourcelist+, +changelist+).
   #
-  # @!attribute [rw] resources
-  #   @return [Array<Resource>] the +<url>+ or +<sitemap>+ elements contained in this list.
+  # @!attribute [r] resources
+  #   @return [Util::IndexableLazy<Resource>] the +<url>+ or +<sitemap>+ elements contained in this list.
   class BaseResourceList < Augmented
     include ::XML::Mapping
 
@@ -40,7 +40,7 @@ module Resync
 
     # Sets the +resources+ list. +nil+ is treated as an empty list.
     def resources=(value)
-      @resources = value || []
+      @resources = Util::IndexableLazy.new(value || [])
     end
 
     # Sets the metadata.
@@ -61,9 +61,9 @@ module Resync
 
     # Finds resources with the specified capability.
     # @param capability [String] the capability.
-    # @return [Array<Resource>] those resources having that capability, or an empty array if none exist.
+    # @return [Enumerator::Lazy<Resource>] those resources having that capability, or an empty array if none exist.
     def resources_for(capability:)
-      resources.select { |l| l.capability == capability }
+      resources.select { |r| r.capability == capability }
     end
 
     # Shortcut to find the first resource with the specified capability (in ResourceSync there often
@@ -71,7 +71,18 @@ module Resync
     # @param capability [String] the capability.
     # @return [Resource] the first resource having that capability, or nil if none exists.
     def resource_for(capability:)
-      resources.find { |l| l.capability == capability }
+      resources.find { |r| r.capability == capability }
+    end
+
+    # Finds only those resources falling within the specified time range. Any of the time
+    # attributes (+:modified_time+, +:at_time+, +:completed_time+, +:from_time+, +:until_time+)
+    # can be used for filtering.
+    # @param time_range [Range[Time]] the range of acceptable times (inclusive or exclusive)
+    # @param time_attr [Symbol] the time type to filter on: +:modified_time+, +:at_time+,
+    #   +:completed_time+, +:from_time+ or +:until_time+
+    # @return [Enumerator::Lazy<Resource>] a lazy enumeration of the resources within the specified range.
+    def resources_in(time_range:, time_attr:)
+      resources.select { |r| time_range.cover?(r.send(time_attr)) }
     end
 
     # ------------------------------------------------------------
@@ -109,7 +120,7 @@ module Resync
       capability = self.class::CAPABILITY
       fail ArgumentError, "Missing constant #{self.class}::CAPABILITY" unless capability
       return Metadata.new(capability: capability) unless metadata
-      fail ArgumentError, "#{metadata} does not appear to be metadata" unless metadata.respond_to?('capability')
+      fail ArgumentError, ":metadata argument <#{metadata}> does not appear to be metadata" unless metadata.respond_to?(:capability)
       fail ArgumentError, "Wrong capability for #{self.class.name} metadata; expected '#{capability}', was '#{metadata.capability}'" unless metadata.capability == capability
       metadata
     end

data/lib/resync/shared/sorted_resource_list.rb

@@ -48,12 +48,21 @@ module Resync
     def sorted(value)
       return [] unless value
       value.sort do |left, right|
-        if left.modified_time && right.modified_time
-          left.modified_time <=> right.modified_time
-        else
-          right.modified_time ? 1 : -1
+        compare(left, right)
+      end
+    end
+
+    def compare(left, right)
+      [:modified_time, :from_time, :at_time, :until_time, :completed_time].each do |time_reader|
+        left_time = left.send(time_reader)
+        right_time = right.send(time_reader)
+        if left_time && right_time
+          return left_time <=> right_time
+        elsif left_time || right_time
+          return left_time ? -1 : 1
         end
       end
+      0
     end
 
     def by_uri(resources)

data/lib/resync/util/indexable_lazy.rb

@@ -0,0 +1,18 @@
+require 'delegate'
+
+module Resync
+  module Util
+    class IndexableLazy < SimpleDelegator
+
+      def initialize(array)
+        super(array.lazy)
+        @array = array
+      end
+
+      def [](key)
+        @array[key]
+      end
+
+    end
+  end
+end

data/lib/resync/util.rb

@@ -0,0 +1,6 @@
+module Resync
+  # Miscellaneous utilities
+  module Types
+    Dir.glob(File.expand_path('../util/*.rb', __FILE__), &method(:require))
+  end
+end

data/lib/resync/version.rb

@@ -1,4 +1,4 @@
 module Resync
   # The version of this gem.
-  VERSION = '0.1.3'
+  VERSION = '0.2.0'
 end

data/spec/unit/resync/capability_list_spec.rb

@@ -80,10 +80,10 @@ module Resync
       it 'maps resources by capability' do
         resources = valid_resources
         capability_list = CapabilityList.new(resources: resources, links: [Link.new(rel: 'up', uri: 'http://example.org/')])
-        expect(capability_list.resources_for(capability: 'resourcelist')).to eq([resources[0]])
-        expect(capability_list.resources_for(capability: 'resourcedump')).to eq([resources[1]])
-        expect(capability_list.resources_for(capability: 'changelist')).to eq([resources[2]])
-        expect(capability_list.resources_for(capability: 'changedump')).to eq([resources[3]])
+        expect(capability_list.resources_for(capability: 'resourcelist').to_a).to eq([resources[0]])
+        expect(capability_list.resources_for(capability: 'resourcedump').to_a).to eq([resources[1]])
+        expect(capability_list.resources_for(capability: 'changelist').to_a).to eq([resources[2]])
+        expect(capability_list.resources_for(capability: 'changedump').to_a).to eq([resources[3]])
       end
     end
 

data/spec/unit/resync/resource_dump_index_spec.rb

@@ -3,10 +3,7 @@ require_relative 'shared/base_resource_list_examples'
 module Resync
   describe ResourceListIndex do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/resource_dump_manifest_spec.rb

@@ -3,10 +3,7 @@ require_relative 'shared/base_resource_list_examples'
 module Resync
   describe ResourceDumpManifest do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/resource_dump_spec.rb

@@ -3,10 +3,7 @@ require_relative 'shared/base_resource_list_examples'
 module Resync
   describe ResourceDump do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/resource_list_index_spec.rb

@@ -3,10 +3,7 @@ require_relative 'shared/base_resource_list_examples'
 module Resync
   describe ResourceListIndex do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/resource_list_spec.rb

@@ -3,10 +3,7 @@ require_relative 'shared/base_resource_list_examples'
 module Resync
   describe ResourceList do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/resource_spec.rb

@@ -4,6 +4,13 @@ require_relative 'shared/augmented_examples'
 
 module Resync
   describe Resource do
+
+    def required_arguments
+      { uri: 'http://example.org' }
+    end
+
+    it_behaves_like Augmented
+
     describe '#new' do
 
       describe 'uri' do
@@ -23,13 +30,6 @@ module Resync
         end
       end
 
-      describe 'links' do
-        def required_arguments
-          { uri: 'http://example.org' }
-        end
-        it_behaves_like Augmented
-      end
-
       describe 'metadata' do
         it 'accepts metadata' do
           md = Metadata.new

data/spec/unit/resync/shared/augmented_examples.rb

@@ -13,15 +13,14 @@ module Resync
     describe 'links' do
       it 'accepts a list of links' do
         links = [Link.new(rel: 'describedby', uri: 'http://example.org/'), Link.new(rel: 'duplicate', uri: 'http://example.com/')]
-        list = new_instance(links: links)
-        expect(list.links).to eq(links)
+        augmented = new_instance(links: links)
+        expect(augmented.links).to eq(links)
       end
 
-      it 'defaults to an empty list if no links are specified' do
-        list = new_instance
-        expect(list.links).to eq([])
+      it 'defaults to an empty augmented if no links are specified' do
+        augmented = new_instance
+        expect(augmented.links).to eq([])
       end
-
     end
 
     describe '#links_for' do
@@ -32,10 +31,10 @@ module Resync
           Link.new(rel: 'describedby', uri: 'http://example.org/desc2'),
           Link.new(rel: 'duplicate', uri: 'http://example.com/dup2')
         ]
-        list = new_instance(links: links)
-        expect(list.links_for(rel: 'describedby')).to eq([links[0], links[2]])
-        expect(list.links_for(rel: 'duplicate')).to eq([links[1], links[3]])
-        expect(list.links_for(rel: 'elvis')).to eq([])
+        augmented = new_instance(links: links)
+        expect(augmented.links_for(rel: 'describedby')).to eq([links[0], links[2]])
+        expect(augmented.links_for(rel: 'duplicate')).to eq([links[1], links[3]])
+        expect(augmented.links_for(rel: 'elvis')).to eq([])
       end
     end
 
@@ -47,10 +46,27 @@ module Resync
           Link.new(rel: 'describedby', uri: 'http://example.org/desc2'),
           Link.new(rel: 'duplicate', uri: 'http://example.com/dup2')
         ]
-        list = new_instance(links: links)
-        expect(list.link_for(rel: 'describedby')).to eq(links[0])
-        expect(list.link_for(rel: 'duplicate')).to eq(links[1])
-        expect(list.link_for(rel: 'elvis')).to eq(nil)
+        augmented = new_instance(links: links)
+        expect(augmented.link_for(rel: 'describedby')).to eq(links[0])
+        expect(augmented.link_for(rel: 'duplicate')).to eq(links[1])
+        expect(augmented.link_for(rel: 'elvis')).to eq(nil)
+      end
+    end
+
+    describe 'additional time attributes' do
+      it 'extracts the at_time, from_time, until_time, and completed_time from the metadata' do
+        capability = described_class::CAPABILITY if defined?(described_class::CAPABILITY)
+        md = Metadata.new(
+          at_time: Time.utc(1999, 1, 1),
+          from_time: Time.utc(2001, 1, 1),
+          until_time: Time.utc(2003, 1, 1),
+          completed_time: Time.utc(2005, 1, 1),
+          capability: capability
+        )
+        augmented = new_instance(metadata: md)
+        [:at_time, :from_time, :until_time, :completed_time].each do |t|
+          expect(augmented.send(t)).to be_time(md.send(t))
+        end
       end
     end
 

data/spec/unit/resync/shared/base_resource_list_examples.rb

@@ -9,7 +9,12 @@ module Resync
 
     # TODO: Find a better way to express this
     def resource_list
-      (defined? valid_resources) ? valid_resources : [Resource.new(uri: 'http://example.org/'), Resource.new(uri: 'http://example.com/')]
+      (defined? valid_resources) ? valid_resources : [
+        Resource.new(uri: 'http://example.com/res1'),
+        Resource.new(uri: 'http://example.com/res2'),
+        Resource.new(uri: 'http://example.com/res3'),
+        Resource.new(uri: 'http://example.com/res4')
+      ]
     end
 
     # TODO: Find a better way to express this
@@ -25,15 +30,34 @@ module Resync
     describe '#new' do
       describe 'resources' do
         it 'accepts a list of resources' do
-          puts defined? valid_resources
           resources = resource_list
           list = new_instance(resources: resources)
-          expect(list.resources).to eq(resources)
+          expect(list.resources.to_a).to eq(resources)
+        end
+
+        it 'is lazy' do
+          resources = resource_list
+          list = new_instance(resources: resources)
+
+          half = resources.size / 2
+          (0...resources.size).each do |i|
+            if i < half
+              expect(resources[i]).to receive(:priority).and_return(i)
+            else
+              expect(resources[i]).not_to receive(:priority)
+            end
+          end
+
+          count = 0
+          list.resources.take(half).each do |r|
+            expect(r.priority).to eq(count)
+            count += 1
+          end
         end
 
         it 'defaults to an empty list if no resources are specified' do
           list = new_instance
-          expect(list.resources).to eq([])
+          expect(list.resources.to_a).to eq([])
         end
       end
 
@@ -67,9 +91,9 @@ module Resync
             Resource.new(uri: 'http://example.com/dataset1/changelist2.xml', metadata: Metadata.new(capability: 'changelist'))
           ]
           list = new_instance(resources: resources)
-          expect(list.resources_for(capability: 'resourcedump')).to eq([resources[0], resources[2]])
-          expect(list.resources_for(capability: 'changelist')).to eq([resources[1], resources[3]])
-          expect(list.resources_for(capability: 'changedump')).to eq([])
+          expect(list.resources_for(capability: 'resourcedump').to_a).to eq([resources[0], resources[2]])
+          expect(list.resources_for(capability: 'changelist').to_a).to eq([resources[1], resources[3]])
+          expect(list.resources_for(capability: 'changedump').to_a).to eq([])
         end
       end
     end
@@ -91,7 +115,7 @@ module Resync
       end
     end
 
-    describe 'capability' do
+    describe '#capability' do
       it 'extracts the capability' do
         metadata = Metadata.new(capability: described_class::CAPABILITY)
         list = new_instance(metadata: metadata)
@@ -99,5 +123,48 @@ module Resync
       end
     end
 
+    describe '#resources_in' do
+      [:at_time, :completed_time, :from_time, :until_time, :modified_time].each do |reader|
+        it "allows filtering by #{reader}" do
+          before_time = Time.utc(1969, 1, 1)
+          start_time = Time.utc(1970, 1, 1)
+          end_time = Time.utc(1980, 1, 1)
+          after_time = Time.utc(1981, 1, 1)
+          times = [before_time, start_time, end_time, after_time]
+
+          writer = "#{reader}=".to_sym
+          resources = resource_list
+          resources.each_with_index do |r, i|
+            if writer == :modified_time=
+              r.send(writer, times[i])
+            else
+              md = r.metadata || (r.metadata = Metadata.new)
+              md.send(writer, times[i])
+            end
+            expect(r.send(reader)).to be_time(times[i]) # just to be sure
+          end
+
+          list = new_instance(resources: resources, metadata: Metadata.new(capability: described_class::CAPABILITY))
+
+          range_inclusive = start_time..end_time
+
+          filtered = list.resources_in(time_range: range_inclusive, time_attr: reader).to_a
+          expect(filtered.size).to eq(2)
+          expect(filtered).not_to include(resources[0])
+          expect(filtered).to include(resources[1])
+          expect(filtered).to include(resources[2])
+          expect(filtered).not_to include(resources[3])
+
+          range_exclusive = start_time...end_time
+          filtered = list.resources_in(time_range: range_exclusive, time_attr: reader).to_a
+          expect(filtered.size).to eq(1)
+          expect(filtered).not_to include(resources[0])
+          expect(filtered).to include(resources[1])
+          expect(filtered).not_to include(resources[2])
+          expect(filtered).not_to include(resources[3])
+        end
+      end
+    end
+
   end
 end

data/spec/unit/resync/shared/sorted_list_examples.rb

@@ -24,7 +24,20 @@ module Resync
           resource0 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1997, 7, 16, 19, 20, 30.45))
           resource1 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1998, 7, 16, 19, 20, 30.45))
           list = new_instance(resources: [resource1, resource0])
-          expect(list.resources).to eq([resource0, resource1])
+          expect(list.resources.to_a).to eq([resource0, resource1])
+        end
+
+        it 'is non-destructive when sorting resources with identical times' do
+          resource0 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1997, 7, 16, 19, 20, 30.45))
+          resource1 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1998, 7, 16, 19, 20, 30.45))
+          resource2 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1998, 7, 16, 19, 20, 30.45))
+          resource4 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1998, 1, 16, 19, 20, 30.45))
+          list = new_instance(resources: [resource1, resource4, resource2, resource0])
+          resources = list.resources.to_a
+          expect(resources[0]).to be(resource0)
+          expect(resources[1]).to be(resource4)
+          expect(resources).to include(resource1)
+          expect(resources).to include(resource2)
         end
 
         it 'sorts resources with modified_time before resources without' do
@@ -32,7 +45,44 @@ module Resync
           resource1 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(1998, 7, 16, 19, 20, 30.45))
           resource2 = Resource.new(uri: 'http://example.com')
           list = new_instance(resources: [resource1, resource2, resource0])
-          expect(list.resources).to eq([resource0, resource1, resource2])
+          expect(list.resources.to_a).to eq([resource0, resource1, resource2])
+        end
+
+        it 'sorts resources by from_time' do
+          resource0 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(from_time: Time.utc(1997, 7, 16, 19, 20, 30.45)))
+          resource1 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(from_time: Time.utc(1998, 7, 16, 19, 20, 30.45)))
+          list = new_instance(resources: [resource1, resource0])
+          expect(list.resources.to_a).to eq([resource0, resource1])
+        end
+
+        it 'sorts resources by at_time' do
+          resource0 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(at_time: Time.utc(1997, 7, 16, 19, 20, 30.45)))
+          resource1 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(at_time: Time.utc(1998, 7, 16, 19, 20, 30.45)))
+          list = new_instance(resources: [resource1, resource0])
+          expect(list.resources.to_a).to eq([resource0, resource1])
+        end
+
+        it 'sorts resources by until_time' do
+          resource0 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(until_time: Time.utc(1997, 7, 16, 19, 20, 30.45)))
+          resource1 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(until_time: Time.utc(1998, 7, 16, 19, 20, 30.45)))
+          list = new_instance(resources: [resource1, resource0])
+          expect(list.resources.to_a).to eq([resource0, resource1])
+        end
+
+        it 'sorts resources by completed_time' do
+          resource0 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(completed_time: Time.utc(1997, 7, 16, 19, 20, 30.45)))
+          resource1 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(completed_time: Time.utc(1998, 7, 16, 19, 20, 30.45)))
+          list = new_instance(resources: [resource1, resource0])
+          expect(list.resources.to_a).to eq([resource0, resource1])
+        end
+
+        it 'preferentially sorts by modified_time' do
+          resource0 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(at_time: Time.utc(1998, 7, 16, 19, 20, 30.45)))
+          resource1 = Resource.new(uri: 'http://example.org', metadata: Metadata.new(at_time: Time.utc(1997, 7, 16, 19, 20, 30.45)))
+          resource2 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(2001, 7, 16, 19, 20, 30.45), metadata: Metadata.new(at_time: Time.utc(2003, 7, 16, 19, 20, 30.45)))
+          resource3 = Resource.new(uri: 'http://example.org', modified_time: Time.utc(2000, 1, 16, 19, 20, 30.45), metadata: Metadata.new(at_time: Time.utc(2005, 7, 16, 19, 20, 30.45)))
+          list = new_instance(resources: [resource0, resource1, resource2, resource3])
+          expect(list.resources.to_a).to eq([resource3, resource2, resource1, resource0])
         end
       end
     end

data/spec/unit/resync/source_description_spec.rb

@@ -5,10 +5,7 @@ require_relative 'shared/augmented_examples'
 module Resync
   describe SourceDescription do
     it_behaves_like BaseResourceList
-
-    describe 'links' do
-      it_behaves_like Augmented
-    end
+    it_behaves_like Augmented
 
     describe 'XML conversion' do
       describe '#from_xml' do

data/spec/unit/resync/util/indexable_lazy_spec.rb

@@ -0,0 +1,133 @@
+require 'spec_helper'
+
+module Resync
+  module Util
+    describe IndexableLazy do
+
+      before(:each) do
+        @size = 3
+        @array = Array.new(@size) { instance_double(Object) }
+        @lazy = IndexableLazy.new(@array)
+      end
+
+      describe '#size' do
+        it 'returns the size of the underlying array' do
+          expect(@lazy.size).to eq(@size)
+        end
+      end
+
+      describe '#[]' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          (0...@lazy.size).each do |i|
+            expect(@lazy[i]).to eq(@array[i])
+            break if @lazy[i].to_s == '1'
+          end
+        end
+      end
+
+      describe '#each' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          @lazy.each do |v|
+            break if v.to_s == '1'
+          end
+        end
+      end
+
+      describe '#each_with_index' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          @lazy.each_with_index do |v, i|
+            break if v.to_s == '1' || i > 1
+          end
+        end
+      end
+
+      describe '#each_with_object' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          acc = []
+          @lazy.each_with_object(acc) do |v, obj|
+            obj << v.to_s
+            break if obj[-1] == '1'
+          end
+          expect(acc).to eq(%w(0 1))
+        end
+      end
+
+      describe '#find' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          expect(@lazy.find { |v| v.to_s == '1' }).to be(@array[1])
+        end
+      end
+
+      describe '#find_index' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          expect(@lazy.find_index { |v| v.to_s == '1' }).to eq(1)
+        end
+      end
+
+      describe '#take_while' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          expect(@lazy.take_while { |v| v.to_s == '0' }.to_a).to eq([@array[0]])
+        end
+      end
+
+      describe '#map' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          mapped = @lazy.map(&:to_s)
+          expect(mapped.take(2).to_a).to eq(%w(0 1))
+        end
+      end
+
+      describe '#take' do
+        it 'is lazy' do
+          expect(@array[0]).to receive(:to_s).and_return('0')
+          expect(@array[1]).to receive(:to_s).and_return('1')
+          expect(@array[2]).not_to receive(:to_s)
+
+          expect(@lazy.take(2).map(&:to_s).to_a).to eq(%w(0 1))
+        end
+      end
+
+      describe '#select' do
+        it 'is lazy' do
+          expect(@array[0]).not_to receive(:to_s)
+          expect(@array[1]).not_to receive(:to_s)
+          expect(@array[2]).not_to receive(:to_s)
+
+          @lazy.select(&:to_s)
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: resync
 version: !ruby/object:Gem::Version
-  version: 0.1.3
+  version: 0.2.0
 platform: ruby
 authors:
 - David Moles
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-06-05 00:00:00.000000000 Z
+date: 2015-06-09 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mime-types
@@ -191,6 +191,8 @@ files:
 - lib/resync/types.rb
 - lib/resync/types/change.rb
 - lib/resync/types/change_frequency.rb
+- lib/resync/util.rb
+- lib/resync/util/indexable_lazy.rb
 - lib/resync/version.rb
 - lib/resync/xml.rb
 - lib/resync/xml_parser.rb
@@ -256,6 +258,7 @@ files:
 - spec/unit/resync/shared/sorted_list_examples.rb
 - spec/unit/resync/shared/uri_field_examples.rb
 - spec/unit/resync/source_description_spec.rb
+- spec/unit/resync/util/indexable_lazy_spec.rb
 - spec/unit/resync/xml/timenode_spec.rb
 - spec/unit/resync/xml/xml_spec.rb
 - spec/unit/resync/xml_parser_spec.rb
@@ -279,7 +282,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.4.6
+rubygems_version: 2.4.7
 signing_key: 
 specification_version: 4
 summary: Utility library for ResourceSync
@@ -345,6 +348,7 @@ test_files:
 - spec/unit/resync/shared/sorted_list_examples.rb
 - spec/unit/resync/shared/uri_field_examples.rb
 - spec/unit/resync/source_description_spec.rb
+- spec/unit/resync/util/indexable_lazy_spec.rb
 - spec/unit/resync/xml/timenode_spec.rb
 - spec/unit/resync/xml/xml_spec.rb
 - spec/unit/resync/xml_parser_spec.rb