ifuture 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 946e1245c8cb89d65297ee5cbef0f93032a33d19
-  data.tar.gz: 80e16960e46696fa06b0b7ba1466174f13ba135c
+  metadata.gz: 60ffc81f189968c879d63579d39c587a12e87564
+  data.tar.gz: 56d0f225dc48bedef690a761242bb6ee5b091a90
 SHA512:
-  metadata.gz: 5d5039914e0b78eeae732930f024c0f41d4c4119ba713d4418f893c034dacf3c837cf7e8d1e7cc4cf119fdab686d4666fe5a232f19a737a0c3adf3db4bb066a6
-  data.tar.gz: eb87345eb4f01c11cb50d2393e0e5f85c18bff397975dfc29730ee0e423afa8ba0195643413893884a5c7f5a1f78163aec70459d58a8a308f783710e528eccf0
+  metadata.gz: 1aec4f8af199b38dd48d7ee6782f5f6a1597921f6ac398c527633a1d19e42cda93e206bc859285d5d4ec278ad8b4c7792061042f63aadb26de8658581748f7d9
+  data.tar.gz: 5bcf5518f45c538a93d4656e3078410e6904d435f7f3fe6523b94e1fa0741824bffcffc4a2781adc1c3e66d4d43ba1e385717ddbaa6af9796bd7a220cc443b1d

data/README.md

@@ -18,33 +18,17 @@ The Redis gem is required as well if you opt to use Redis instead of the default
 
 ```ruby
 require 'ifuture'
-
-future = IFuture.new do
-  3.downto 0 do |n|
-    sleep 1
-    puts "#{n}..."
-  end
-
-  'Sekret!!'
+future = IFuture.unix Marshal do
+  sleep 2
+  'Put that in your unix socket and smoke it'
 end
 
-future.ready?
-#=> false
-
-sleep 5
-#=> 5
-
-# 3...
-# 2...
-# 1...
-# 0...
-
-future.ready?
-#=> true
-
-future.value
-#=> "Sekret!!"
+future.ready? # => false
+sleep 2
+future.ready? # => true
+future.value # => "Put that in your unix socket and smoke it"
 ```
+
 ### Code Serialization Format
 
 The default serialization format is Marshal, but you can use JSON, YAML or other formats that implement the methods #load and #dump.
@@ -52,10 +36,9 @@ The default serialization format is Marshal, but you can use JSON, YAML or other
 ```ruby
 require 'ifuture'
 require 'json'
-
-future = IFuture.new JSON do
-  sleep 5
-  :human_readable
+future = IFuture.unix JSON do
+  sleep 2
+  {ok: true}
 end
 ```
 
@@ -65,11 +48,11 @@ By default iFuture uses IChannel with unix sockets for transferring serialized c
 
 ```ruby
 require 'ifuture'
-
-future = IFuture.new(Marshal, :redis, {host: 'localhost', key: 'readme'}) do
+future = IFuture.redis Marshal, {host: 'localhost', key: 'readme'} do
   sleep 5
-  :over_the_wire
+  42
 end
+future.value # => 42
 ```
 
 ## Contributing

data/ifuture.gemspec

@@ -8,16 +8,16 @@ Gem::Specification.new do |gem|
   gem.version       = IFuture::VERSION
   gem.authors       = ['Shannon Skipper']
   gem.email         = ['shannonskipper@gmail.com']
-  gem.description   = %q{Concurrent Futures with Processes}
+  gem.description   = %q{Process-based Futures for Ruby.}
   gem.summary       = %q{Futures implemented on top of IChannel for interprocess communication.}
   gem.homepage      = 'https://github.com/havenwood#readme'
   gem.license       = 'MIT'
   gem.files         = `git ls-files`.split($/)
   gem.require_paths = ['lib']
   
-  gem.add_development_dependency 'ichannel', '~> 7.1.0'
+  gem.add_development_dependency 'ichannel', '~> 8.0.0'
   gem.add_development_dependency 'minitest'
   gem.add_development_dependency 'rake'
   
-  gem.add_runtime_dependency 'ichannel', '~> 7.1.0'
+  gem.add_runtime_dependency 'ichannel', '~> 8.0.0'
 end

data/lib/ifuture/version.rb

@@ -1,3 +1,3 @@
 class IFuture
-  VERSION = '0.2.2'
+  VERSION = '0.3.0'
 end

data/lib/ifuture.rb

@@ -1,12 +1,25 @@
 require 'ichannel'
-require 'ifuture/version'
+require_relative 'ifuture/version'
 
 class IFuture
-  def initialize serializer = Marshal, transport = :unix, options = nil
-    @channel = IChannel.send transport, serializer, options
-    @thread = Process.detach fork { @channel.put yield }
+  def self.unix(serializer = Marshal, options = {}, &block)
+    allocate.tap do |obj|
+      obj.send :initialize, IChannel.unix(serializer, options), block
+    end
   end
-  
+
+  def self.redis(serializer = Marshal, options = {}, &block)
+    allocate.tap do |obj|
+      obj.send :initialize, IChannel.redis(serializer, options), block
+    end
+  end
+
+  def initialize(channel, block)
+    @channel = channel
+    @pid = fork { @channel.put(block.call) }
+  end
+  private_class_method :new
+
   def ready?
     if defined? @value
       true
@@ -19,7 +32,7 @@ class IFuture
     if defined? @value
       @value
     else
-      @thread.join
+      Process.wait @pid
       @value = @channel.get
     end
   end

data/test/helper.rb

@@ -1,3 +1,3 @@
 require 'minitest/autorun'
 require 'minitest/pride'
-require 'ifuture'
+require_relative '../lib/ifuture'

data/test/ifuture_test.rb

@@ -2,7 +2,7 @@ require_relative 'helper.rb'
 
 describe IFuture do
   before do
-    @future = IFuture.new { sleep 0.25; 'peppermint' }
+    @future = IFuture.unix { sleep 0.25; 'peppermint' }
   end
   
   describe 'before the value is ready' do

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ifuture
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - Shannon Skipper
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-08-10 00:00:00.000000000 Z
+date: 2013-08-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ichannel
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 7.1.0
+        version: 8.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 7.1.0
+        version: 8.0.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -58,15 +58,15 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 7.1.0
+        version: 8.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 7.1.0
-description: Concurrent Futures with Processes
+        version: 8.0.0
+description: Process-based Futures for Ruby.
 email:
 - shannonskipper@gmail.com
 executables: []
@@ -104,7 +104,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.6
+rubygems_version: 2.0.7
 signing_key: 
 specification_version: 4
 summary: Futures implemented on top of IChannel for interprocess communication.