lazily 0.2.0 → 0.2.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZjcyNzBlNzc2ZDNiODVjYWY3ZmJhYTIwOWQyMmU2MDQ1ZWQyOTIyNA==
+  data.tar.gz: !binary |-
+    MjZiZWFkNTM0YmQ2NTM4ZTA0MWE0NWYzM2Y3ZDMyNzU2YTkwMmUwOQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    YTJmNmYyNzIzM2ZhN2M1OGZjZmRlNThjYzYxMmE2NDRiNzA1MzViMDg1OTNh
+    ZjNkZDc2NWQ2Y2YwNzQ0NjRjNzM2ODM3MGQzNGQxYjVkYWEwMWNjMWU2ZDIz
+    NDk0N2M3NWNlNTdhZTNmMGM1MzBmNmJkNTU3NzZkMTllMGZlNTU=
+  data.tar.gz: !binary |-
+    ZDAxM2Y1MjEyNThkMDk2NWZlM2VlNjdiN2QyOTNhMGZkYWE3NTU1MjE1ODI3
+    YjU0NmY5MDRmNTA2NmRjMDE2YjM1MzUwMjk1ZDc5ODRlOTY2NWVjMWQ0OWM0
+    Mzg5YzAxZDY4YWNhNmNlYmU3ZGEwODI1MGQyNmNmY2M3YjJjMjA=

data/README.md

@@ -86,6 +86,20 @@ Outputs will be yielded in the expected order, making it a drop-in replacement f
 
 Unlike some other "parallel map" implementations, the output of `#in_threads` is lazy (though it does need to pre-fetch elements from the source collection as required to start Threads).
 
+Lazy queue processing
+---------------------
+
+`Lazily.dequeue` makes a Queue look like a (lazy) Enumerable, making it easier to process data produced by other Threads, e.g.
+
+    q = Queue.new
+    Thread.new do
+      q << 1
+      q << 2
+      q << 3
+    end
+
+    Lazily.dequeue(q).take(2).to_a    # => [1,2]
+
 Lazy combination of Enumerables
 -------------------------------
 

data/lib/lazily.rb

@@ -1,4 +1,5 @@
 require "lazily/combining"
+require "lazily/dequeuing"
 require "lazily/filtering"
 require "lazily/proxy"
 require "lazily/threading"

data/lib/lazily/dequeuing.rb

@@ -0,0 +1,32 @@
+require "lazily/enumerable"
+
+module Lazily
+
+  class << self
+
+    def dequeue(queue)
+      Dequeuer.new(queue)
+    end
+
+  end
+
+  class Dequeuer
+
+    include Lazily::Enumerable
+
+    def initialize(queue, terminator = nil)
+      @queue = queue
+      @terminator = terminator
+    end
+
+    def each
+      loop do
+        next_value = @queue.pop
+        break if @terminator === next_value
+        yield next_value
+      end
+    end
+
+  end
+
+end

data/lib/lazily/version.rb

@@ -1,3 +1,3 @@
 module Lazily
-  VERSION = "0.2.0".freeze
+  VERSION = "0.2.1".freeze
 end

data/spec/lazily/dequeuing_spec.rb

@@ -0,0 +1,35 @@
+require "spec_helper"
+require "thread"
+
+describe Lazily, "dequeuing" do
+
+  let(:queue) { Queue.new }
+
+  describe ".dequeue" do
+
+    it "drains a queue" do
+      queue << "one"
+      queue << "two"
+      queue << "three"
+      queue << nil
+      Lazily.dequeue(queue).to_a.should == %w(one two three)
+    end
+
+    it "polls the queue" do
+      lambda do
+        Timeout.timeout(0.1) do
+          Lazily.dequeue(queue).first
+        end
+      end.should raise_error(TimeoutError)
+    end
+
+    it "is lazy" do
+      queue << "one"
+      Timeout.timeout(0.1) do
+        Lazily.dequeue(queue).first.should eq("one")
+      end
+    end
+
+  end
+
+end

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lazily
 version: !ruby/object:Gem::Version
-  version: 0.2.0
-  prerelease: 
+  version: 0.2.1
 platform: ruby
 authors:
 - Mike Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-07-14 00:00:00.000000000 Z
+date: 2013-09-29 00:00:00.000000000 Z
 dependencies: []
 description: ! "    Lazily implements \"lazy\" versions of many Enumerable methods,\n
   \   allowing streamed processing of large (or even infinite) collections.\n\n    It's
@@ -33,6 +32,7 @@ files:
 - lib/lazily/associating.rb
 - lib/lazily/combining.rb
 - lib/lazily/concatenating.rb
+- lib/lazily/dequeuing.rb
 - lib/lazily/enumerable.rb
 - lib/lazily/filtering.rb
 - lib/lazily/merging.rb
@@ -44,6 +44,7 @@ files:
 - spec/lazily/associating_spec.rb
 - spec/lazily/bugs_spec.rb
 - spec/lazily/concatenating_spec.rb
+- spec/lazily/dequeuing_spec.rb
 - spec/lazily/filtering_spec.rb
 - spec/lazily/merging_spec.rb
 - spec/lazily/prefetching_spec.rb
@@ -53,38 +54,32 @@ files:
 - spec/spec_helper.rb
 homepage: http://github.com/mdub/lazily
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 3722161259490547720
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 3722161259490547720
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.0.7
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Lazy Enumerables for everybody!
 test_files:
 - spec/lazily/associating_spec.rb
 - spec/lazily/bugs_spec.rb
 - spec/lazily/concatenating_spec.rb
+- spec/lazily/dequeuing_spec.rb
 - spec/lazily/filtering_spec.rb
 - spec/lazily/merging_spec.rb
 - spec/lazily/prefetching_spec.rb