liquid_stream 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 030832c0751d60e0b1ba8a20b10dd2c6c5da59bc
-  data.tar.gz: ccaf5b71f6f6d8cada5f15ec8fe675aca28f3d9a
+  metadata.gz: 6273d042d67ee818d165028563c77f2d97ff9a96
+  data.tar.gz: b33895f8647855e6529257646a6b7a7c3f88583c
 SHA512:
-  metadata.gz: 1ba6ae8462051277b9ef97d7837f6ae92e68334b619f67301aa50fcd3fdf4dbc6a0313ef72ca398592a2b6e40168f3b5239e2335da14af712d0f82d278422b59
-  data.tar.gz: 92f0d41dd6b43e0158a711bc619a495c0ba1779c0db771f41b7ac0c83a7b3c77995d24f02541acef582ffbceb80fbf1c95d94c95aed11b4c186505b75b3e7ecf
+  metadata.gz: c3da6f7e939f3637d723c1bbf4807fecc6b7ff96ca2bbc151e1b4236a86a3c8b55c03eff0fa6e66b76ce1d4285b82424fcb36ff6d69b10d5108a7cd8e79334b0
+  data.tar.gz: 37d6f4de42207e39118ef4e80d316e61a8c8aa350fe7a50855890fa2ab21a2b4641125cad9f07aa41b8989344bb269aee580ad2e5ef33ddff68839f338270c2b

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 0.0.3
+
+- Allow `LiquidStream::Streams` to have a default source
+- For `LiquidStream::Streams`, if no source nor default source is defined, then source is an empty array
+
 # 0.0.2
 
 Fixes issue with Utils being in the wrong place and broke loading

data/README.md

@@ -113,6 +113,21 @@ You may not want to expose something that will make it easy for a user to break
     posts_stream = PostsStream.new(posts)
     posts_stream.to_a # boom!
 
+## Stream/Streams Source
+
+Singular `Stream` and collection `Streams` both use the term source. This is the object that is wrapped by the stream. For collection `Streams`, source acts a little differently. The reason for this is best shown by the following:
+
+    s = PostsStream.new
+    s.source # nil
+
+    PostsStream.default_source = Post.all
+    s = PostsStream.new
+    s.source # Post.all
+    s = PostsStream.new(Post.popular)
+    s.source # Post.popular
+
+As you can see, you may want the source of a collection stream to be different things, or default to something if none is given.
+
 ## Contributing
 
 1. Fork it

data/lib/liquid_stream/streams.rb

@@ -3,8 +3,10 @@ module LiquidStream
 
     delegate :count, :size, to: :source
 
-    def initialize(source, stream_context={})
-      @source = source
+    class_attribute :default_source
+
+    def initialize(source=nil, stream_context={})
+      @source = source_from(source)
       @stream_context = stream_context
     end
 
@@ -33,5 +35,16 @@ module LiquidStream
         stream_class_from(@stream_context[:method] || self.class)
     end
 
+    def source_from(s)
+      src = s
+      src ||= if self.class.default_source.respond_to?(:call)
+                self.class.default_source.call
+              else
+                self.class.default_source
+              end
+      src ||= []
+      src
+    end
+
   end
 end

data/lib/liquid_stream/version.rb

@@ -1,3 +1,3 @@
 module LiquidStream
-  VERSION = "0.0.2"
+  VERSION = "0.0.3"
 end

data/spec/liquid_stream/streams_spec.rb

@@ -82,4 +82,29 @@ describe LiquidStream::Streams do
     end
   end
 
+  describe '.default_source' do
+    it 'should set the default source' do
+      described_class.default_source = ['some', 'items']
+      expect(described_class.new.source).to eq(['some', 'items'])
+    end
+
+    context 'when the default source is a lambda' do
+      it 'should resolve to the what the lambda returns' do
+        described_class.default_source = -> { ['some'] }
+        expect(described_class.new.source).to eq(['some'])
+      end
+    end
+  end
+
+  describe '#source' do
+    context 'when there is no source passed nor default source defined' do
+      it 'should be an empty array' do
+        PostsStream.default_source = nil
+        stream = PostsStream.new
+        expect(stream.source).to eq([])
+      end
+    end
+  end
+
+
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: liquid_stream
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Ramon Tayag
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-21 00:00:00.000000000 Z
+date: 2014-05-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -165,7 +165,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Allow a more Ruby-like interface to Liquid drops with context awareness