piper 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1,2 @@
+--colour
+

data/Gemfile

@@ -0,0 +1,9 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in piper.gemspec
+gemspec
+
+group :test do
+  gem "rspec"
+end
+

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/lib/piper/version.rb

@@ -0,0 +1,4 @@
+class Piper
+  VERSION = "0.0.1"
+end
+

data/lib/piper.rb

@@ -0,0 +1,119 @@
+
+class Piper
+  DestinyNotYetChosenException = Class.new(Exception)
+  CannotWriteToReaderException = Class.new(Exception)
+  CannotReadFromWriterException = Class.new(Exception)
+
+  def initialize
+    @readpipe, @writepipe = IO.pipe
+  end
+
+  def destiny_chosen?
+    !(@writer.nil? && @reader.nil?)
+  end
+
+  def writer!
+    if !destiny_chosen?
+      @writer = true
+      @readpipe.close
+    end
+  end
+
+  def reader!
+    if !destiny_chosen?
+      @reader = true
+      @writepipe.close
+    end
+  end
+
+  def writer?
+    !!@writer
+  end
+
+  def reader?
+    !!@reader
+  end
+
+  def <<(obj)
+    raise CannotWriteToReader if reader?
+
+    # Force writer
+    writer!
+
+    dump wrap(obj)
+  end
+
+  def close
+    dump :close => true if writer?
+  end
+
+  def load
+    raise CannotReadFromWriterException if writer?
+
+    # Force reader
+    reader!
+
+    Marshal.load(@readpipe)
+  end
+
+  def raw
+    raise DestinyNotYetChosenException if !destiny_chosen?
+
+    reader? ? @readpipe : @writepipe
+  end
+
+  protected
+
+  def dump(obj)
+    Marshal.dump(obj, @writepipe)
+  end
+
+  def wrap(obj)
+    {:object => obj}
+  end
+
+  class << self
+    def receive(*pipes)
+      open_pipes = [*pipes]
+
+      # Force all pipes to be readers
+      open_pipes.each {|p| p.reader! }
+
+      pipes_by_raw_read_pipe = {}
+      open_pipes.each do |p|
+        pipes_by_raw_read_pipe[p.raw] = p
+      end
+
+      loop do
+        ready = IO.select(open_pipes.map {|p| p.raw }, nil, nil, nil)
+
+        # Should always be ready, but if not, somehow it
+        # timed out. Throw error
+        if !ready
+          raise Exception
+        else
+          ready_pipes = ready[0].select {|p|
+            !p.eof?
+          }.map {|raw_pipe|
+            pipes_by_raw_read_pipe[raw_pipe]
+          }
+
+          ready_pipes.each do |pipe|
+            wrapper = pipe.load
+
+            if wrapper[:close]
+              pipes_by_raw_read_pipe.delete(pipe.raw)
+
+              open_pipes.delete(pipe)
+              return if open_pipes.empty?
+            else
+              object = wrapper.delete :object
+              yield(object)
+            end
+          end
+        end
+      end
+    end
+  end
+end
+

data/piper.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "piper/version"
+
+Gem::Specification.new do |s|
+  s.name        = "piper"
+  s.version     = Piper::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Justin Camerer"]
+  s.email       = ["iamjwc@gmail.com"]
+  s.homepage    = "http://github.com/iamjwc/piper"
+  s.summary     = %q{Wrapper around IO.pipe to allow easier communication between multiple processes.}
+  s.description = %q{Check the summary.}
+
+  s.rubyforge_project = "piper"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/lib/piper_spec.rb

@@ -0,0 +1,32 @@
+require File.expand_path("../../spec_helper", __FILE__)
+
+describe Piper do
+  it "should be able to send a message between two processes" do
+    send_to_child("hi").should == "hi"
+  end
+
+  it "should be able to send all different types of objects" do
+    send_to_child(:hey).should == :hey
+    send_to_child(1).should == 1
+    send_to_child(1.3).should == 1.3
+    send_to_child([1,2,3]).should == [1,2,3]
+  end
+
+  it "should use a special message when sending" do
+    send_to_child(:close).should == :close
+  end
+
+  def send_to_child(message)
+    p = Piper.new
+
+    if fork
+      m = nil
+      Piper.receive(p) {|message| m = message }
+      m
+    else
+      p << message
+      p.close
+      exit!
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,5 @@
+Bundler.setup(:test)
+require 'rspec'
+
+require File.expand_path(File.dirname(__FILE__)+'/../lib/piper')
+

metadata

@@ -0,0 +1,77 @@
+--- !ruby/object:Gem::Specification 
+name: piper
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: 
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Justin Camerer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-12 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Check the summary.
+email: 
+- iamjwc@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- Gemfile
+- Rakefile
+- lib/piper.rb
+- lib/piper/version.rb
+- piper.gemspec
+- spec/lib/piper_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/iamjwc/piper
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: piper
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: Wrapper around IO.pipe to allow easier communication between multiple processes.
+test_files: 
+- spec/lib/piper_spec.rb
+- spec/spec_helper.rb