abstractivator 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f0f97f449a6f91eaac8ae39f200348648279e81e
-  data.tar.gz: 13f4f30033ab6cd63d57d837cbea7250ae5e183d
+  metadata.gz: 6544ed986ae721bbafe6a7ca12bd302808b64497
+  data.tar.gz: 826dbb6f5c26ef72f77c9117d6bc26c10492ad31
 SHA512:
-  metadata.gz: 3b9565dcf535296a0c0434e3fadc2409a82ca5b8991193b6f5dfec81d3e0c17bb420c59546bedbb6df1ded02ba731e310eaefdcfdd49bb9d5c331c5435d42293
-  data.tar.gz: 642b58f09048ce0c2897c8b6a43dd4ed28db10380e6d9754c1cbf14792351f78e7ae536e459d82aa7c707385713bfd3268a960046bb35f74ec493eddde624047
+  metadata.gz: 69486ac9eb226283b82b1bbdfcd1dc296a73d50079a3da84fc7a601220dc688eabe12b23980ef702aa644da18bc3b8ebb3cd9feae8c8263decdc557514641271
+  data.tar.gz: 7e921ab9be7d6cc07effa8e5b9311494f4d266ee10f8d02f658026a66762b80caec81db52256b8ce496bcdc0e019941aeaa52821080c5da6b452321d6731c3d5

data/lib/abstractivator/fiber_defer.rb

@@ -0,0 +1,37 @@
+require 'fiber'
+
+begin
+  require 'eventmachine'
+rescue => e
+  raise 'Abstractivator::FiberDefer requires eventmachine but it is unavailable.'
+end
+
+module Abstractivator
+  module FiberDefer
+    ROOT_FIBER = Fiber.current
+
+    def with_fiber_defer(&block)
+      raise 'this method requires an eventmachine reactor to be running' unless EM.reactor_running?
+      Fiber.new{block.call}.resume if block
+    end
+
+    def fiber_defer(&action)
+      f = Fiber.current
+      raise 'fiber_defer must be passed an action to defer (the block)' unless action
+      raise 'fiber_defer must be called within a with_fiber_defer block' if f == ROOT_FIBER
+
+      safe_action = proc do
+        begin
+          [action.call, nil]
+        rescue Exception => e
+          [nil, e]
+        end
+      end
+
+      EM.defer(safe_action, proc { |result, error| f.resume([result, error]) })
+      result, error = Fiber.yield
+      raise error if error
+      result
+    end
+  end
+end

data/lib/abstractivator/version.rb

@@ -1,3 +1,3 @@
 module Abstractivator
-  VERSION = '0.1.1'
+  VERSION = '0.2.0'
 end

data/spec/lib/abstractivator/fiber_defer_spec.rb

@@ -0,0 +1,74 @@
+require 'rspec'
+require 'abstractivator/fiber_defer'
+require 'eventmachine'
+
+describe Abstractivator::FiberDefer do
+  include Abstractivator::FiberDefer
+
+  describe '#with_fiber_defer' do
+    context 'when an eventmachine reactor is not running' do
+      it 'raises an error' do
+        expect{with_fiber_defer}.to raise_error /reactor/
+      end
+    end
+    context 'when an eventmachine reactor is running' do
+      it 'calls the block' do
+        EM.run do
+          expect{|b| with_fiber_defer(&b)}.to yield_control
+          EM.stop
+        end
+      end
+      context 'when no block is provided' do
+        it 'does nothing' do
+          EM.run do
+            with_fiber_defer
+            EM.stop
+          end
+        end
+      end
+    end
+  end
+
+  describe '#fiber_defer' do
+    context 'when it is called outside a with_fiber_defer block' do
+      it 'raises an error' do
+        expect{fiber_defer{}}.to raise_error /with_fiber_defer/
+      end
+    end
+    context 'when it is not passed a block' do
+      it 'raises an error' do
+        expect{fiber_defer}.to raise_error /must be passed an action/
+      end
+    end
+    it 'executes the block on a background thread' do
+      EM.run do
+        with_fiber_defer do
+          main_thread = Thread.current
+          executed = false
+          fiber_defer do
+            expect(Thread.current).to_not eql main_thread
+            executed = true
+          end
+          expect(executed).to be true
+          EM.stop
+        end
+      end
+    end
+    it 'returns the value of its block' do
+      EM.run do
+        with_fiber_defer do
+          expect(fiber_defer{42}).to eql 42
+          EM.stop
+        end
+      end
+    end
+    it 'raises an error raised by its block' do
+      EM.run do
+        with_fiber_defer do
+          expect{fiber_defer{raise 'oops'}}.to raise_error 'oops'
+          EM.stop
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: abstractivator
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Peter Winton
@@ -101,6 +101,7 @@ files:
 - lib/abstractivator/enum.rb
 - lib/abstractivator/enumerable_ext.rb
 - lib/abstractivator/event.rb
+- lib/abstractivator/fiber_defer.rb
 - lib/abstractivator/proc_ext.rb
 - lib/abstractivator/schedule.rb
 - lib/abstractivator/schedule/schedule.rb
@@ -118,6 +119,7 @@ files:
 - spec/lib/abstractivator/enum_spec.rb
 - spec/lib/abstractivator/enumerable_ext_spec.rb
 - spec/lib/abstractivator/event_spec.rb
+- spec/lib/abstractivator/fiber_defer_spec.rb
 - spec/lib/abstractivator/proc_ext_spec.rb
 - spec/lib/abstractivator/schedule/em_util.rb
 - spec/lib/abstractivator/schedule/schedule_runner_spec.rb
@@ -157,6 +159,7 @@ test_files:
 - spec/lib/abstractivator/enum_spec.rb
 - spec/lib/abstractivator/enumerable_ext_spec.rb
 - spec/lib/abstractivator/event_spec.rb
+- spec/lib/abstractivator/fiber_defer_spec.rb
 - spec/lib/abstractivator/proc_ext_spec.rb
 - spec/lib/abstractivator/schedule/em_util.rb
 - spec/lib/abstractivator/schedule/schedule_runner_spec.rb