bubble-wrap 1.9.1 → 1.9.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 92e7c0fe2ee325c95b2ca90338fe351be2418071
-  data.tar.gz: 0901bb3e373c4297f699abc1e598eb0d261dcc7c
+  metadata.gz: 95bb977273e17a942c1eafb9b1b50310c6e0eb9d
+  data.tar.gz: 05a96c0c6101319c9e182f857d2f598eafa2011f
 SHA512:
-  metadata.gz: 7d730ae4a4226eca0a485fc4b2fdf0375a872d19f48adec94887395a53592a52d895aa78050257cc16af39928f19c0e472eda912bd32a57a5af708f2438a13c1
-  data.tar.gz: b8712012a3d4817784fe910eb88b7782259e890e943f83af8854c6282d3305c331f5a50affa1deb835a2560aca05d5b5ca0914a1b463bab59e5a1ea59a0469c2
+  metadata.gz: 6947c06f77c6dc682e3dfc96d1c998187ae7a6fadd523d55e0a7031a2fc85fcdc1a444ada67de7314ea1484e42dc49deb9540f9a38ba93bff520f65563994865
+  data.tar.gz: 3e9c849bb376dfbb3b9cd1a73747a420fb25168cea4907991cfa17b5e8b6197e0e6d0e386c44f1e536a77d7d18c712e5d516abfde1c9820dbf001bb4eb6e94ba

data/CHANGELOG.md

@@ -1,9 +1,17 @@
 ## Unreleased
 
-[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.9.0...master)
+[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.9.2...master)
+
+## 1.9.2
+
+[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.9.1...v1.9.2)
+
+* Added `DependentDeferrable`. ([#469](https://github.com/rubymotion/BubbleWrap/pull/469))
 
 ## 1.9.1
 
+[Commit history](https://github.com/rubymotion/BubbleWrap/compare/v1.9.0...v1.9.1)
+
 * Fix issue in loading iOS 8 constants for CoreLocation
 
 ## 1.9.0

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    bubble-wrap (1.9.1)
+    bubble-wrap (1.9.2)
 
 GEM
   remote: https://rubygems.org/

data/README.md

@@ -24,10 +24,10 @@ gem install bubble-wrap
 require 'bubble-wrap'
 ```
 
-If you using Bundler:
+If you use Bundler:
 
 ```ruby
-gem "bubble-wrap", "~> 1.9.0"
+gem "bubble-wrap", "~> 1.9.2"
 ```
 
 BubbleWrap is split into multiple modules so that you can easily choose which parts are included at compile-time.
@@ -1118,6 +1118,26 @@ Great sadness!
 => [:passed]
 ```
 
+#### DependentDeferrable
+
+`DependentDeferrable` depends on children deferrables. A `DependentDeferrable`
+succeeds only when every child succeeds and fails immediately when any child
+fails
+
+```ruby
+> d1 = EM::DefaultDeferrable.new
+=> #<BubbleWrap::Reactor::DefaultDeferrable:0x10c713750>
+> d2 = EM::DefaultDeferrable.new
+=> #<BubbleWrap::Reactor::DefaultDeferrable:0x10370bb10>
+> d = EM::DependentDeferrable.on(d1, d2)
+=> #<BubbleWrap::Reactor::DependentDeferrable:0x106c17b80>
+> d.callback {|a, b| puts "a: #{a} b: #{b}"}
+=> [#<Proc:0x103075210>]
+> d1.succeed 'one', 'one more'
+> d2.succeed :two
+a: ["one", "one more"] b: [:two]
+```
+
 #### ThreadAwareDeferrable
 
 ```ruby

data/lib/bubble-wrap/version.rb

@@ -1,4 +1,4 @@
 module BubbleWrap
-  VERSION = '1.9.1' unless defined?(BubbleWrap::VERSION)
+  VERSION = '1.9.2' unless defined?(BubbleWrap::VERSION)
   MIN_MOTION_VERSION = '3.12'
 end

data/motion/reactor/deferrable.rb

@@ -147,6 +147,14 @@ module BubbleWrap
         @deferred_timeout = Timer.new(seconds) {me.fail}
       end
 
+      def deferred_status
+        @deferred_status ||= :unknown
+      end
+
+      def deferred_args
+        @deferred_args
+      end
+
     end
   end
 end

data/motion/reactor/dependent_deferrable.rb

@@ -0,0 +1,27 @@
+module BubbleWrap
+  module Reactor
+    class DependentDeferrable < DefaultDeferrable
+      # args are Deferrable(s) which the returned Deferrable depends on.
+      # returns a Deferrable that depends on args.
+      # which:
+      #   succeeds only when every Deferrable in args succeeds
+      #   fails immediately when any Deferrable in args fails
+      # Have to be careful that #deferred_args for DependentDeferrable is a list of #deferred_args from its children Deferrable(s).
+      def self.on(*args)
+        deferrable = self.new
+        @children_deferrables = args
+        @children_deferrables.each do |e|
+          e.callback do |result|
+            if @children_deferrables.all? {|a| a.deferred_status == :succeeded}
+              deferrable.succeed(*@children_deferrables.map(&:deferred_args))
+            end
+          end
+          e.errback do |result|
+            deferrable.fail(*e.deferred_args)
+          end
+        end
+        deferrable
+      end
+    end
+  end
+end

data/spec/motion/reactor/dependent_deferrable_spec.rb

@@ -0,0 +1,93 @@
+describe BubbleWrap::Reactor::DependentDeferrable do
+
+  before do
+    @subject = Class.new do
+      include BubbleWrap::Reactor::Deferrable
+    end
+    @d1 = @subject.new
+    @d2 = @subject.new
+    @object = BubbleWrap::Reactor::DependentDeferrable.on(@d1, @d2)
+  end
+
+  describe '.callback' do
+
+    it "calls the callback block with arguments after all children .succeed" do
+      args1 = [1, 2]
+      args2 = [3, 4]
+      @object.callback do |*passed_args|
+        passed_args.should.equal [args1, args2]
+      end
+      @d1.succeed *args1
+      @d2.succeed *args2
+    end
+
+    it "calls the callback block with arguments only after all children .succeed" do
+      execution_order = []
+      @object.callback do |*passed_args|
+        execution_order << 3
+      end
+      execution_order << 1
+      @d1.succeed :succeeds
+      execution_order << 2
+      @d2.succeed :succeeds
+      execution_order.should.equal [1, 2, 3]
+    end
+
+    it "calls the callback if even if the deferrable already succeeded" do
+      @d1.succeed :succeeded1
+      @d2.succeed :succeeded2
+      @object.callback do |*args|
+        NSLog "args: #{args} class: #{args.class}"
+        args[0].should.equal [:succeeded1]
+        args[1].should.equal [:succeeded2]
+      end
+    end
+
+  end
+
+  describe '.errback' do
+    it "calls the errback block after a child fails" do
+      args1 = [1, 2]
+      args2 = [3, 4]
+      @object.errback do |*passed_args|
+        passed_args.should.equal args1
+      end
+      @d1.fail *args1
+    end
+
+    it "calls the errback block immediately after a child fails" do
+      execution_order = []
+      @object.errback do |*passed_args|
+        execution_order << 2
+      end
+      execution_order << 1
+      @d1.fail :fail
+      execution_order << 3
+      @d2.fail :fail
+      execution_order.should.equal [1, 2, 3]
+    end
+
+    it "calls the errback block after a child fails even if others succeeds" do
+      args1 = [1, 2]
+      args2 = [3, 4]
+      callback_called = false
+      @object.callback do |*passed_args|
+        callback_called = true
+      end
+      @object.errback do |*passed_args|
+        passed_args.should.equal args2
+      end
+      @d1.succeed *args1
+      @d2.fail *args2
+      callback_called.should.equal false
+    end
+
+    it "calls the errback block even if the deferrable failed first" do
+      @d1.fail :err
+      @object.errback do |err|
+        err.should.equal :err
+      end
+    end
+  end
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bubble-wrap
 version: !ruby/object:Gem::Version
-  version: 1.9.1
+  version: 1.9.2
 platform: ruby
 authors:
 - Matt Aimonetti
@@ -14,7 +14,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-07-10 00:00:00.000000000 Z
+date: 2015-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: mocha
@@ -141,6 +141,7 @@ extra_rdoc_files:
 - motion/reactor.rb
 - motion/reactor/default_deferrable.rb
 - motion/reactor/deferrable.rb
+- motion/reactor/dependent_deferrable.rb
 - motion/reactor/eventable.rb
 - motion/reactor/future.rb
 - motion/reactor/periodic_timer.rb
@@ -190,6 +191,7 @@ extra_rdoc_files:
 - spec/motion/motion/core_motion_spec.rb
 - spec/motion/network-indicator/network_indicator_spec.rb
 - spec/motion/reactor/deferrable_spec.rb
+- spec/motion/reactor/dependent_deferrable_spec.rb
 - spec/motion/reactor/eventable_spec.rb
 - spec/motion/reactor/thread_aware_deferrable_spec.rb
 - spec/motion/reactor_spec.rb
@@ -280,6 +282,7 @@ files:
 - motion/reactor.rb
 - motion/reactor/default_deferrable.rb
 - motion/reactor/deferrable.rb
+- motion/reactor/dependent_deferrable.rb
 - motion/reactor/eventable.rb
 - motion/reactor/future.rb
 - motion/reactor/periodic_timer.rb
@@ -386,6 +389,7 @@ files:
 - spec/motion/motion/core_motion_spec.rb
 - spec/motion/network-indicator/network_indicator_spec.rb
 - spec/motion/reactor/deferrable_spec.rb
+- spec/motion/reactor/dependent_deferrable_spec.rb
 - spec/motion/reactor/eventable_spec.rb
 - spec/motion/reactor/thread_aware_deferrable_spec.rb
 - spec/motion/reactor_spec.rb
@@ -459,6 +463,7 @@ test_files:
 - spec/motion/motion/core_motion_spec.rb
 - spec/motion/network-indicator/network_indicator_spec.rb
 - spec/motion/reactor/deferrable_spec.rb
+- spec/motion/reactor/dependent_deferrable_spec.rb
 - spec/motion/reactor/eventable_spec.rb
 - spec/motion/reactor/thread_aware_deferrable_spec.rb
 - spec/motion/reactor_spec.rb