iprocess 3.2.0 → 4.0.0

data/.travis.yml

@@ -1,9 +1,9 @@
 rvm: 
   - 1.9.2
   - 1.9.3
-  - rbx-19mode
   - ruby-head
-
+  # Rubinius does not implement UNIXSocket#recvmsg, yet.
+  # - rbx-19mode
 notifications:
   irc: "irc.freenode.org#ruby-bridge"
   email: false

data/README.md

@@ -11,18 +11,20 @@ __OVERVIEW__
 
 __DESCRIPTION__
 
-Provides a number of  abstractions on top of spawning subprocesses and 
-interprocess  communication. It has a simple and easy to use API that 
-supports synchronous and asynchronous method calls plus one or two other 
-useful features shown in the examples below.
+Provides a number of abstractions on top of spawning subprocesses and 
+interprocess communication. The API is simple, easy to use & supports
+both synchronous and asynchronous(non-blocking) dispatch of subprocesses.
+It also supports implicit interprocess communication that can be easily 
+configured to use the serializer of your choice(default is the 
+[Marshal](http://rdoc.info/stdlib/core/Marshal) module) if needs be.
 
 __EXAMPLES__
 
 __1.__
 
-Three subprocesses are spawned. The return value of the block, even though 
-executed in a subprocess, is returned to the parent process as long as it may 
-be serialized  by Marshal(or the serializer of your choice, this is 
+In this example three subprocesses are spawned. The return value of the block,
+even though executed in a subprocess, is returned to the parent process as long 
+as it may be serialized  by Marshal(or the serializer of your choice, this is 
 configurable):
   
     messages = IProcess.spawn(3) { {msg: "hello"} }
@@ -91,19 +93,26 @@ __PLATFORM SUPPORT__
 
 _supported_
 
-  * Rubinius (1.9 mode) 
-  * CRuby (1.9)
+  * CRuby (1.9+)
 
 _unsupported_
   
   * CRuby 1.8
   * MacRuby
   * JRuby
-
-__LICENSE__
-
-MIT. See LICENSE.txt.
+  * Rubinius (support for Rubinius will come sometime in the future).
 
 __INSTALL__
 
     $ gem install iprocess
+
+__SEE ALSO__
+
+ - [XPool](https://github.com/robgleeson/xpool)  
+ XPool is a UNIX process pool that was born inside IProcess but later extracted 
+ into its own project. It might be interesting to you if you're interested in 
+ concurrency and/or interprocess communication.
+
+__LICENSE__
+
+MIT. See LICENSE.txt.

data/iprocess.gemspec

@@ -17,10 +17,11 @@ Gem::Specification.new do |s|
   s.require_path              = 'lib'
   s.rubyforge_project         = '[none]'
   s.required_rubygems_version = '>= 1.3.6'
-  s.required_ruby_version     = '~> 1.9.1'
+  s.required_ruby_version     = '>= 1.9.2'
 
+  s.add_runtime_dependency 'ichannel', '~> 1.0.0'
   s.add_development_dependency 'yard'     , '~> 0.7'
+  s.add_development_dependency 'minitest', '~> 2.6'
+  s.add_development_dependency 'rake', '~> 0.9.2'
   s.add_development_dependency 'kramdown' 
-  s.add_development_dependency 'minitest' , '~> 2.6'
-  s.add_development_dependency 'rake'     , '~> 0.9.2'
 end

data/lib/iprocess/version.rb

@@ -1,3 +1,3 @@
 class IProcess
-  VERSION = '3.2.0'
+  VERSION = '4.0.0'
 end

data/lib/iprocess.rb

@@ -1,6 +1,6 @@
 class IProcess
+  require 'ichannel'
   require_relative 'iprocess/version'
-  require_relative 'iprocess/channel'
   #
   # @return [#load,#dump]
   #   Returns the serializer used by IProcess.
@@ -106,8 +106,8 @@ class IProcess
   #   The process ID of the spawned subprocess.
   #
   def execute
-    @channel = IProcess::Channel.new
-    @pid = fork { @channel.write(@worker.call) }
+    @channel = IChannel.new IProcess.serializer
+    @pid = fork { @channel.put(@worker.call) }
   end
 
   #
@@ -116,6 +116,6 @@ class IProcess
   #
   def result
     Process.wait(@pid)
-    @channel.recv
+    @channel.get
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: iprocess
 version: !ruby/object:Gem::Version
-  version: 3.2.0
+  version: 4.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,40 +9,40 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-05 00:00:00.000000000 Z
+date: 2012-11-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: yard
+  name: ichannel
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.7'
-  type: :development
+        version: 1.0.0
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
-  name: kramdown
+  name: yard
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.7'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
@@ -75,6 +75,22 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: 0.9.2
+- !ruby/object:Gem::Dependency
+  name: kramdown
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: IProcess makes InterProcess Communication(IPC) easy.
 email: rob@flowof.info
 executables: []
@@ -92,7 +108,6 @@ files:
 - Rakefile
 - iprocess.gemspec
 - lib/iprocess.rb
-- lib/iprocess/channel.rb
 - lib/iprocess/version.rb
 - test/setup.rb
 - test/test_IProcess_class.rb
@@ -105,9 +120,9 @@ require_paths:
 required_ruby_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
-  - - ~>
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.9.1
+      version: 1.9.2
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:

data/lib/iprocess/channel.rb

@@ -1,72 +0,0 @@
-require 'socket'
-class IProcess::Channel
-  #
-  # @param [#dump,#load}] serializer
-  #   Any object that implements dump, & load.
-  #   Defaults to {IProcess.serializer}.
-  #
-  # @yieldparam [IProcess::Channel] _self
-  #   Yields self.
-  #
-  def initialize(serializer = IProcess.serializer) 
-    @reader, @writer = UNIXSocket.pair :DGRAM
-    @serializer = serializer 
-    if block_given?
-      yield self
-    end
-  end
-
-  #
-  # Close the channel.
-  #
-  # @return [void]
-  #
-  def close
-    [@reader.close,@writer.close]
-  end
-
-  #
-  # @return [Boolean]
-  #   Returns true if the channel is closed.
-  #
-  def closed?
-    @reader.closed? && @writer.closed?
-  end
-
-  #
-  # @return [Boolean]
-  #   Returns true if the channel is open.
-  #
-  def open?
-    !closed?
-  end
-
-  #
-  # Add an object to the channel.
-  #
-  # @param [Object] object
-  #   An object to add to the channel.
-  #
-  def write object
-    _, writable, _ = IO.select [], [@writer], [], 0.1
-    if writable
-      @writer.send @serializer.dump(object), 0
-    end
-  end
-  alias_method :put, :write
-
-  #
-  # Receive a object from the channel.
-  #
-  # @return [Object]
-  #   The object added to the channel.
-  #
-  def recv
-    readable, _ = IO.select [@reader], [], [], 0.1
-    if readable
-      msg, _ = @reader.recvmsg
-      @serializer.load msg
-    end
-  end
-  alias_method :get, :recv
-end