abundance 1.1.1 → 1.1.2

data/lib/abundance.rb

@@ -1,41 +1,37 @@
 # This class provides a mean to parallelize the execution of your program processes.
-# It is a process queue, named the Garden, with concurrent workers, named Rows, all this getting orchestrated by a Gardener.
+# Based on the low maintenance Gardener,Garden,Seed natural design pattern.
 # 
-# Its characteristics are:
-# * concurrent
-# * non-blocking
-# * simple
-# * pure ruby
-# * serialization friendly 
-# 
-# It:
-# * scales to multi core
-# * is intended for batch processing or other parallel ready operations
-# * can boost you program's performance
+# Its for:
+# * forking otherwise blocking loops in a non-blocking fashion
+# * a simple abstraction for loopback communication with a forked execution
+# * concurrent batch processing
+# * scaling process intensive computations to multi-core parallel execution
 # 
 # And not:
 # * a replacement for Thread.new invocations
 # * a replacement for Thread friendly programming languages like Erlang
 # 
+# Its initial implementation uses:
+# * pure ruby
+# * standard forks as mean to parallel non-blocking execution
+# * fast UDP loopback sockets for process fork communication.
+# * serialization friendly communication with process forks
+# * a tier queuing fork, as a packet control middle man between process forks and the non-blocking process client
+# * an elemental namespace: a process queue, named the Garden, with concurrent workers, named Rows, all this getting orchestrated by a Gardener.
 # 
-# Based on Gardener,Garden,Seed natural design patern
-# 
-# While there should be no use for this kind of class in most programs, there are some occasions where processes
-# cannot live inside serialized execution without blocking.  The built in threading model can save your execution in many occasions, but in many case green threading is not enough, or simply just won't work.
-# For a nice explanation on the subject of ruby green threading, you can refer to: http://www.igvita.com/2008/11/13/concurrency-is-a-myth-in-ruby/
+# ///////////////////////////////////////////////////////////////////////////////////////
 # 
-# Abundance is by no mean intended to equal or compete with the tools mentionned in the article, its rather a different
-# approach on the same problem.  I hope it will inspire some of you to hack out something that works even better,
-# and hopefully, eventually this tool will become obsolete because Ruby will get concurency built in.
-#  
-# So, the approach here is really simple, you require abundance in your program.
-# Then ask the Abundance.gardener class method to build you a garden built with a garden patch block you provide as part of the invocation.
-# This garden patch block includes an initialization block, which may be empty,
-# and the invocation of the Abundance.grow class method, the perpetual seed ready patch garden.
-# It becomes the threaded looping object, growing concurently on garden patch row forks.
+# Quick Start:
 # 
-# The gardener objected is then available to seeds and harvest the multiple garden patch row forks,
-# allowing you to cultivate parallel garden rows where your seeds sprout till fruitful harvest time comes.
+# 1. gem install abundance
+# 2. require abundance
+# 3. use the Abundance.gardener method to define your forking process.  Its attached block IS THE FORK.  Its return value IS YOUR CLIENT INSTANCE.
+# 4. Abundance.gardener has simple commodities:
+# * infinite loop inside Abundance.grow method's block
+# * initialisation before Abundance.grow invocation, just put it there... you can use Abundance.init_status if you need init confirmation from the forks, otherwise don't bother.
+# * reader and sender for socket communication with your client.  seed.sprout reads, seed.crop sends.
+# 5. use the client to communicate with forks: client.seed sends, client.harvest reads.
+# 6. for detailed client docs: http://abundance.rubyforge.org/ruby-doc/classes/Gardener.html , and full docs: http://abundance.rubyforge.org/ruby-doc/
 # 
 # Author:: lp (mailto:lp@spiralix.org)
 # Copyright:: 2008 Louis-Philippe Perron - Released under the terms of the MIT license
@@ -55,7 +51,7 @@ class Abundance
   # * :rows = garden rows number, the number of concurent threads
   # * :init_timeout = allow to pause execution to allow for larger gardens to initialize
   # === Example
-  #  gardener = Abundance.gardener( :block_size => 8192, :rows => 2, :init_timeout => 2) do
+  #  gardener = Abundance.gardener( :wheelbarrow => 8192, :rows => 2, :init_timeout => 2) do
   # 
   #   processor = SpecialProcess.new
   #   if processor.started_successfully?

data/lib/toolshed.rb

@@ -20,15 +20,9 @@ module Toolshed
   def Toolshed.available_port
     port = @@start_port + 1
     catch :scan_port do
+      stat = `netstat`
       loop do
-        begin
-          socket = UDPSocket.new
-          socket.connect(UDP_HOST,port)
-          socket.send('',0)
-          response,address = socket.recvfrom(1024)
-        rescue Errno::ECONNREFUSED
-          throw :scan_port
-        end
+        throw :scan_port unless stat =~ /localhost\.#{port}/
         port += 1
       end
     end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: abundance
 version: !ruby/object:Gem::Version 
-  version: 1.1.1
+  version: 1.1.2
 platform: ruby
 authors: 
 - Louis-Philippe Perron
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-12-23 00:00:00 -05:00
+date: 2009-01-10 00:00:00 -05:00
 default_executable: 
 dependencies: []