barney 0.1.0

data/lib/barney/share.rb

@@ -0,0 +1,83 @@
+module Barney
+
+  class Share
+
+    @mutex = Mutex.new
+
+    class << self
+      # Serves as a temporary holder for the latest value read from the child process. 
+      #
+      # @api    private   
+      # @return [void]
+      attr_accessor :value
+
+      # Serves as a lock when {Barney::Share.value} is being accessed by {Barney::Share#synchronize}
+      #
+      # @api    private
+      # @return [Mutex] 
+      def mutex
+        @mutex
+      end
+    end
+
+    # @return [Barney::Share] Returns an instance of Barney::Share.
+    def initialize
+      @shared        = []
+      @communicators = nil
+      @context       = nil
+    end
+
+    # The share method marks a variable or constant to be shared between two processes. 
+    #  
+    # @param  [Symbol]        Variable   Accepts a variable amount of Symbol objects.
+    # @return [Array<Symbol>]            Returns a list of all variables that are being shared.
+    def share(*variables)
+      @shared = @shared | variables
+    end
+
+    # This method will spawn a new child process.  
+    # It can be treated like the Kernel.fork method, but a block or Proc object is a 
+    # required argument.
+    # 
+    # @param  [Proc]  Proc    Accepts a block or Proc object that will be executed in a child 
+    #                         process.
+    # 
+    # @raise  [ArgumentError] It will raise an ArgumentError if a block or Proc object isn't 
+    #                         supplied as an argument. 
+    #                         
+    # @return [Fixnum]        Returns the Process ID(PID) of the spawned child process.  
+    def fork(&blk)
+      raise(ArgumentError, "A block or Proc object is expected") unless block_given?
+
+      @communicators = Array.new(@shared.size) { IO.pipe }  
+      @context       = blk.binding
+      process_id     = Kernel.fork do
+        blk.call
+        @communicators.each_with_index do |pipes, i|
+          pipes[0].close  
+          pipes[1].write(Marshal.dump(eval("#{@shared[i]}", @context)))
+          pipes[1].close
+        end
+      end
+      process_id
+    end
+
+    # This method synchronizes data between the parent and child process.  
+    # This method will block until the spawned child process has exited. 
+    # @return [void]
+    def synchronize 
+      @communicators.each_with_index do |pipes,i|
+        Barney::Share.mutex.synchronize do
+          pipes[1].close
+          Barney::Share.value = Marshal.load(pipes[0].read)
+          pipes[0].close
+          eval("#{@shared[i]} = Barney::Share.value", @context)
+        end
+      end
+    end
+
+  end
+
+end
+
+

data/lib/barney.rb

@@ -0,0 +1,8 @@
+require('barney/share')
+
+module Barney 
+
+  VERSION = '0.1.0'
+
+end
+

metadata

@@ -0,0 +1,67 @@
+--- !ruby/object:Gem::Specification 
+name: barney
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Robert Gleeson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-10-04 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: Barney tries to make the sharing of data between processes as easy and natural as possible.
+email: rob@flowof.info
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/barney.rb
+- lib/barney/share.rb
+has_rdoc: true
+homepage: http://github.com/robgleeson/barney
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
+      version: 1.3.6
+requirements: []
+
+rubyforge_project: "[none]"
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Barney tries to make the sharing of data between processes as easy and natural as possible.
+test_files: []
+