em_alldone 0.0.1 → 0.0.2

data/CHANGELOG.rdoc

@@ -1,3 +1,7 @@
+=== 0.0.2 / 2014-07-31
+
+* Add EmAlldone.with for setting the arguments passed to the callback.
+
 === 0.0.1 / 2014-07-31
 
 * Initial commit

data/README.rdoc

@@ -12,15 +12,28 @@ success or failure. Doesn't support errbacks.
 
 A quick example:
 
+    require 'eventmachine'
     require 'em_alldone'
 
     d1 = EM::DefaultDeferrable.new
     d2 = EM::DefaultDeferrable.new
-    EmAlldone.new(d1, d2) do
-      puts "All done"
+    EmAlldone.new(d1, d2) do |arg|
+      puts "All done #{arg}"
     end
-    d1.succeed # Nothing happens
-    d2.succeed # Prints out "All done"
+    d2.succeed 2 # Nothing happens
+    d1.succeed 1 # Prints out "All done 2"
+
+    d1 = EM::DefaultDeferrable.new
+    d2 = EM::DefaultDeferrable.new
+    str = "Hello"
+    d1.callback do
+      str.upcase!
+    end
+    EmAlldone.with([d1, d2], str) do |arg|
+      puts "All done #{arg}"
+    end
+    d2.succeed 2 # Nothing happens
+    d1.succeed 1 # Prints out "All done HELLO"
 
 
 == REQUIREMENTS:
@@ -32,8 +45,7 @@ gem installed and required.
 
 == INSTALL:
 
-TODO
-
+    gem install em_alldone
 
 == RUNNING THE SPECS:
 

data/lib/em_alldone.rb

@@ -3,7 +3,47 @@
 # success or failure. Doesn't support errbacks.
 class EmAlldone
   module Version # :nodoc:
-    STRING = '0.0.1'
+    STRING = '0.0.2'
+  end
+
+  # This is a super simple implementation of EM::DefaultDeferrable.
+  # This is used so we don't need to explicitly depend upon the EventMachine gem.
+  # This is not meant for external use.
+  class BasicDeferrable # :nodoc:
+    # Does nothing
+    def errback; end
+    def fail(*args); end
+
+    # If the callback arguments are set (i.e. `succeed` has been called),
+    # then the given callback will be run immediately.
+    def callback &block
+      @callback = block
+      if @callback_args
+        @callback.call *@callback_args
+      end
+      self
+    end
+
+    # If the callback is set, then it will be run.
+    # Otherwise we save the arguments for later.
+    def succeed(*args)
+      if @callback
+        @callback.call(*args)
+      else
+        @callback_args = args
+      end
+    end
+  end
+
+
+
+  # Returns an instance. However, it ensures that when the callback is called
+  # it is called with the specified arguments.
+  def self.with(deferrables, *args, &block)
+    deferrables = deferrables.flatten
+    deferrables << BasicDeferrable.new
+    deferrables[-1].succeed *args
+    new(deferrables, &block)
   end
 
   def initialize(*deferrables, &block)

data/spec/em_alldone_spec.rb

@@ -52,4 +52,41 @@ describe EmAlldone do
       @it_ran.should be_true
     end
   end
+
+  context "the arguments to the callback" do
+    let(:d1) { EM::DefaultDeferrable.new }
+    let(:d2) { EM::DefaultDeferrable.new }
+    before do
+      EmAlldone.new(d1, d2) do |*args|
+        @it_ran = args
+      end
+    end
+
+    context "implicitly set" do
+      it "is the arguments of the last deferrable's succeed" do
+        d2.succeed 2, "two"
+        d1.succeed 1
+        @it_ran.should == [2, "two"]
+      end
+
+      it "is the arguments of the last deferrable's fail" do
+        d1.fail 1, "one"
+        d2.fail 2
+        @it_ran.should == [2]
+      end
+    end
+
+    context "explicitly set" do
+      it "is the explicitly set argements" do
+        EmAlldone.with([d1, d2], "explicitly", :set) do |*args|
+          @it_ran = args
+        end
+
+        d1.succeed 1
+        d2.fail 2, "two"
+
+        @it_ran.should == ["explicitly", :set]
+      end
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: em_alldone
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-31 00:00:00.000000000 Z
+date: 2014-08-01 00:00:00.000000000 Z
 dependencies: []
 description: Provides a way to execute a callback when all of a set of deferrables
   complete.
@@ -54,7 +54,7 @@ rubyforge_project:
 rubygems_version: 1.8.28
 signing_key: 
 specification_version: 3
-summary: em_alldone0.0.1
+summary: em_alldone0.0.2
 test_files:
 - spec/em_alldone_spec.rb
 - spec/spec_helper.rb