forkoff 0.0.4 → 1.1.0

data/README

@@ -9,6 +9,7 @@ SYNOPSIS
 URI
 
   http://rubyforge.org/projects/codeforpeople
+  http://github.com/ahoward/forkoff
 
 INSTALL
 
@@ -20,48 +21,9 @@ DESCRIPTION
   child process and collecting the results.  forkoff can limit the number of
   child processes which is, by default, 2.
 
-HISTORY
-  0.0.4
-    - code re-org
-    - add :strategy option
-    - default number of processes is 2, not 8
-
-  0.0.1
-
-    - updated to use producer threds pushing onto a SizedQueue for each consumer
-      channel.  in this way the producers do not build up a massize parllel data
-      structure but provide data to the consumers only as fast as they can fork
-      and proccess it.  basically for a 4 process run you'll end up with 4
-      channels of size 1 between 4 produces and 4 consumers, each consumer is a
-      thread popping of jobs, forking, and yielding results.
-
-    - removed use of Queue for capturing the output.  now it's simply an array
-      of arrays which removed some sync overhead.
-
-    - you can configure the number of processes globally with
-
-        Forkoff.default['proccess'] = 4
-
-    - you can now pass either an options hash
-
-        forkoff( :processes => 2 ) ...
-
-      or plain vanilla number
-
-        forkoff( 2 ) ...
-
-      to the forkoff call
-
-    - default number of processes is 8, not 2
-        
-
-  0.0.0
-
-    initial version
-
-
 SAMPLES
 
+  
   <========< samples/a.rb >========>
 
   ~ > cat samples/a.rb
@@ -76,8 +38,8 @@ SAMPLES
 
   ~ > ruby samples/a.rb
 
-    hey from 1032
-    you from 1033
+    hey from 7907
+    you from 7908
 
 
   <========< samples/b.rb >========>
@@ -107,7 +69,7 @@ SAMPLES
 
   ~ > ruby samples/b.rb
 
-    elapsed: 4.25545883178711
+    elapsed: 4.19184589385986
     results: [0, 1, 4, 9, 16, 25, 36, 49]
 
 
@@ -151,71 +113,70 @@ SAMPLES
   ~ > ruby samples/c.rb
 
     
-    pid: 1048
-    elapsed: 3.14415812492371
+    pid: 7922
+    elapsed: 3.37899208068848
     
     --- 
     a: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01049 ahoward ruby -Ilib samples/c.rb
-       |-+- 01050 ahoward ruby -Ilib samples/c.rb
-       \-+- 01051 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07923 ahoward ruby -Ilib samples/c.rb
+       |-+- 07924 ahoward (ruby)
+       \-+- 07925 ahoward ruby -Ilib samples/c.rb
     
     --- 
     b: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01049 ahoward (ruby)
-       |-+- 01050 ahoward ruby -Ilib samples/c.rb
-       \-+- 01051 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07923 ahoward ruby -Ilib samples/c.rb
+       |-+- 07924 ahoward ruby -Ilib samples/c.rb
+       \-+- 07925 ahoward ruby -Ilib samples/c.rb
     
     --- 
     c: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01049 ahoward ruby -Ilib samples/c.rb
-       |-+- 01050 ahoward ruby -Ilib samples/c.rb
-       \-+- 01051 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07923 ahoward ruby -Ilib samples/c.rb
+       |-+- 07924 ahoward (ruby)
+       \-+- 07925 ahoward ruby -Ilib samples/c.rb
     
     --- 
     d: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01061 ahoward ruby -Ilib samples/c.rb
-       |-+- 01062 ahoward ruby -Ilib samples/c.rb
-       \-+- 01063 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07932 ahoward ruby -Ilib samples/c.rb
+       |--- 07933 ahoward ruby -Ilib samples/c.rb
+       \--- 07934 ahoward ruby -Ilib samples/c.rb
     
     --- 
     e: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01061 ahoward (ruby)
-       |-+- 01062 ahoward ruby -Ilib samples/c.rb
-       \-+- 01063 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |--- 07932 ahoward (ruby)
+       |-+- 07933 ahoward ruby -Ilib samples/c.rb
+       \-+- 07934 ahoward (ruby)
     
     --- 
     f: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01061 ahoward ruby -Ilib samples/c.rb
-       |-+- 01062 ahoward ruby -Ilib samples/c.rb
-       \-+- 01063 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |--- 07932 ahoward (ruby)
+       |-+- 07933 ahoward ruby -Ilib samples/c.rb
+       \-+- 07934 ahoward ruby -Ilib samples/c.rb
     
     --- 
     g: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01090 ahoward ruby -Ilib samples/c.rb
-       |-+- 01091 ahoward ruby -Ilib samples/c.rb
-       \-+- 01092 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07941 ahoward ruby -Ilib samples/c.rb
+       |--- 07942 ahoward ruby -Ilib samples/c.rb
+       \--- 07943 ahoward ruby -Ilib samples/c.rb
     
     --- 
     h: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01090 ahoward ruby -Ilib samples/c.rb
-       |-+- 01091 ahoward ruby -Ilib samples/c.rb
-       \-+- 01092 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |-+- 07941 ahoward (ruby)
+       |-+- 07942 ahoward ruby -Ilib samples/c.rb
+       \--- 07943 ahoward ruby -Ilib samples/c.rb
     
     --- 
     i: |
-      -+- 01048 ahoward ruby -Ilib samples/c.rb
-       |-+- 01090 ahoward ruby -Ilib samples/c.rb
-       |-+- 01091 ahoward ruby -Ilib samples/c.rb
-       \-+- 01092 ahoward ruby -Ilib samples/c.rb
+      -+- 07922 ahoward ruby -Ilib samples/c.rb
+       |--- 07942 ahoward (ruby)
+       \-+- 07943 ahoward ruby -Ilib samples/c.rb
     
 
 
@@ -236,7 +197,58 @@ SAMPLES
 
   ~ > ruby samples/d.rb
 
-    hey from 1102
-    you from 1103
-    guys from 1104
+    hey from 7953
+    you from 7954
+    guys from 7955
+
 
+
+HISTORY
+  1.1.0 
+    - move to a model with one work queue and signals sent from consumers to
+    producer to noitify ready state.  this let's smaller jobs race through a
+    single process even while a larger job may have one sub-process bound up.
+    incorporates a fix from http://github.com/fredrikj/forkoff which meant
+    some processes would lag behind when jobs didn't have similar execution
+    times.
+
+  1.0.0
+    - move to github
+
+  0.0.4
+    - code re-org
+    - add :strategy option
+    - default number of processes is 2, not 8
+
+  0.0.1
+
+    - updated to use producer threds pushing onto a SizedQueue for each consumer
+      channel.  in this way the producers do not build up a massize parllel data
+      structure but provide data to the consumers only as fast as they can fork
+      and proccess it.  basically for a 4 process run you'll end up with 4
+      channels of size 1 between 4 produces and 4 consumers, each consumer is a
+      thread popping of jobs, forking, and yielding results.
+
+    - removed use of Queue for capturing the output.  now it's simply an array
+      of arrays which removed some sync overhead.
+
+    - you can configure the number of processes globally with
+
+        Forkoff.default['proccess'] = 4
+
+    - you can now pass either an options hash
+
+        forkoff( :processes => 2 ) ...
+
+      or plain vanilla number
+
+        forkoff( 2 ) ...
+
+      to the forkoff call
+
+    - default number of processes is 8, not 2
+        
+
+  0.0.0
+
+    initial version

data/forkoff.gemspec

@@ -0,0 +1,27 @@
+## forkoff.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "forkoff"
+  spec.description = 'brain-dead simple parallel processing for ruby' 
+  spec.version = "1.1.0"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "forkoff"
+
+  spec.files = ["forkoff.gemspec", "lib", "lib/forkoff.rb", "rakefile", "README", "readme.erb", "samples", "samples/a.rb", "samples/b.rb", "samples/c.rb", "samples/d.rb", "test", "test/forkoff.rb"]
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.has_rdoc = true
+  spec.test_files = "test/forkoff.rb"
+  #spec.add_dependency 'lib', '>= version'
+  #spec.add_dependency 'fattr'
+
+  spec.extensions.push(*[])
+
+  spec.rubyforge_project = "codeforpeople"
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@gmail.com"
+  spec.homepage = "http://github.com/ahoward/forkoff/tree/master"
+end

data/lib/forkoff.rb

@@ -2,13 +2,17 @@ require 'thread'
 
 module Forkoff
   def version
-    '0.0.4'
+    '1.1.0'
   end
 
   def done
     @done ||= Object.new
   end
 
+  def ready
+    @ready ||= Object.new
+  end
+
   def default
     @default ||= { 'processes' => 2 }
   end
@@ -137,7 +141,8 @@ module Enumerable
     options = { 'processes' => Integer(options) } unless Hash === options
     n = Integer( options['processes'] || options[:processes] || Forkoff.default['processes'] )
     strategy = options['strategy'] || options[:strategy] || 'pipe'
-    qs = Array.new(n){ SizedQueue.new 1 }
+    p2c = Queue.new
+    c2p = Queue.new
     results = Array.new(n){ [] }
 
     #
@@ -151,7 +156,8 @@ module Enumerable
             Thread.current.abort_on_exception = true
 
             loop do
-              value = qs[i].pop
+              c2p.push( Forkoff.ready )
+              value = p2c.pop
               break if value == Forkoff.done
               args, index = value
 
@@ -177,22 +183,18 @@ module Enumerable
     #
     # producers
     #
-      producers = []
-
-      n.times do |i|
-        thread = Thread.new do
+      producer = 
+        Thread.new do
           Thread.current.abort_on_exception = true
-          each_with_index do |args, j|
-            every_nth = j.modulo(n) == i
-            next unless every_nth
-            qs[ j.modulo(n) ].push( [args, j] )
+          each_with_index do |args, i|
+            ready = c2p.pop
+            p2c.push( [args, i] )
+          end
+          n.times do |i|
+            p2c.push( Forkoff.done )
           end
-          qs[ i ].push( Forkoff.done )
         end
 
-        producers << thread
-      end
-
     #
     # wait for all consumers to complete
     #

data/rakefile

@@ -0,0 +1,223 @@
+
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "http://github.com/ahoward/#{ This.lib }/tree/master"
+
+
+task :default do
+  puts(Rake::Task.tasks.map{|task| task.name} - ['default'])
+end
+
+
+task :gemspec do
+  ignore_extensions = 'git', 'svn', 'tmp', /sw./, 'bak', 'gem'
+  ignore_directories = 'pkg'
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+    end
+
+  lib         = This.lib
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  has_rdoc    = true #File.exist?('doc')
+  test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+
+  extensions = This.extensions
+  if extensions.nil?
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## #{ lib }.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = #{ lib.inspect }
+            spec.description = 'brain-dead simple parallel processing for ruby' 
+            spec.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+
+            spec.files = #{ files.inspect }
+            spec.executables = #{ executables.inspect }
+            
+            spec.require_path = "lib"
+
+            spec.has_rdoc = #{ has_rdoc.inspect }
+            spec.test_files = #{ test_files.inspect }
+            #spec.add_dependency 'lib', '>= version'
+            #spec.add_dependency 'fattr'
+
+            spec.extensions.push(*#{ extensions.inspect })
+
+            spec.rubyforge_project = #{ This.rubyforge_project.inspect }
+            spec.author = #{ This.author.inspect }
+            spec.email = #{ This.email.inspect }
+            spec.homepage = #{ This.homepage.inspect }
+          end
+        __
+      }
+    end
+
+  open("#{ lib }.gemspec", "w"){|fd| fd.puts template}
+  This.gemspec = "#{ lib }.gemspec"
+end
+
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p This.pkgdir
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv gem, This.pkgdir
+  This.gem = File.basename(gem)
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -Ilib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.pkgdir }/#{ This.gem }"
+  puts cmd
+  system cmd
+end
+
+
+
+
+
+BEGIN {
+  $VERBOSE = nil
+
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+
+  Fu = FileUtils
+
+  This = OpenStruct.new
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd)
+  end
+  This.lib = lib
+
+  version = ENV['VERSION']
+  unless version
+    name = lib.capitalize
+    require "./lib/#{ lib }"
+    version = eval(name).send(:version)
+  end
+  This.version = version
+
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result(b||@block)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+
+  Dir.chdir(This.dir)
+}

data/readme.erb

@@ -0,0 +1,76 @@
+NAME
+
+  forkoff
+
+SYNOPSIS
+
+  brain-dead simple parallel processing for ruby
+
+URI
+
+  http://rubyforge.org/projects/codeforpeople
+  http://github.com/ahoward/forkoff
+
+INSTALL
+
+  gem install forkoff
+
+DESCRIPTION
+
+  forkoff works for any enumerable object, iterating a code block to run in a
+  child process and collecting the results.  forkoff can limit the number of
+  child processes which is, by default, 2.
+
+SAMPLES
+
+  <%= samples %>
+
+HISTORY
+  1.1.0 
+    - move to a model with one work queue and signals sent from consumers to
+    producer to noitify ready state.  this let's smaller jobs race through a
+    single process even while a larger job may have one sub-process bound up.
+    incorporates a fix from http://github.com/fredrikj/forkoff which meant
+    some processes would lag behind when jobs didn't have similar execution
+    times.
+
+  1.0.0
+    - move to github
+
+  0.0.4
+    - code re-org
+    - add :strategy option
+    - default number of processes is 2, not 8
+
+  0.0.1
+
+    - updated to use producer threds pushing onto a SizedQueue for each consumer
+      channel.  in this way the producers do not build up a massize parllel data
+      structure but provide data to the consumers only as fast as they can fork
+      and proccess it.  basically for a 4 process run you'll end up with 4
+      channels of size 1 between 4 produces and 4 consumers, each consumer is a
+      thread popping of jobs, forking, and yielding results.
+
+    - removed use of Queue for capturing the output.  now it's simply an array
+      of arrays which removed some sync overhead.
+
+    - you can configure the number of processes globally with
+
+        Forkoff.default['proccess'] = 4
+
+    - you can now pass either an options hash
+
+        forkoff( :processes => 2 ) ...
+
+      or plain vanilla number
+
+        forkoff( 2 ) ...
+
+      to the forkoff call
+
+    - default number of processes is 8, not 2
+        
+
+  0.0.0
+
+    initial version

data/test/forkoff.rb

@@ -0,0 +1,54 @@
+$:.unshift('.')
+$:.unshift('./lib')
+$:.unshift('..')
+$:.unshift('../lib')
+
+require('test/unit')
+require('forkoff')
+
+
+class T < Test::Unit::TestCase
+
+# simple usage
+#
+
+  def test_0010
+    results = [0,1,2].forkoff!{|n| [n, Process.pid]}
+    assert_equal(results, results.uniq, 'all ran in a different process')
+  end
+
+# it's faster
+#
+  def test_0020
+    n = 4
+    strategies = :forkoff, :each
+
+    4.times do
+      result = {}
+
+      strategies.each do |strategy|
+        a = Time.now.to_f
+        (0..4).send(strategy){|i| sleep 0.2}
+        b = Time.now.to_f
+        elapsed = b - a
+        result[strategy] = elapsed
+      end
+
+      assert result[:forkoff] < result[:each], 'forkoff is faster than each for long running tasks'
+    end
+  end
+
+# in case of different execution times for different processes
+#
+  def test_0030
+    a = Time.now.to_f
+    (0...4).forkoff(2) do |i|
+      sleep i.modulo(2)
+    end
+    b = Time.now.to_f
+    elapsed = b - a
+    assert elapsed < 2
+  end
+
+
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: forkoff
 version: !ruby/object:Gem::Version 
-  version: 0.0.4
+  version: 1.1.0
 platform: ruby
 authors: 
 - Ara T. Howard
@@ -9,11 +9,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-09-13 00:00:00 -06:00
+date: 2009-10-11 00:00:00 -06:00
 default_executable: 
 dependencies: []
 
-description: 
+description: brain-dead simple parallel processing for ruby
 email: ara.t.howard@gmail.com
 executables: []
 
@@ -22,19 +22,20 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- gemspec.rb
-- gen_readme.rb
-- install.rb
-- lib
+- forkoff.gemspec
 - lib/forkoff.rb
+- rakefile
 - README
-- samples
+- readme.erb
 - samples/a.rb
 - samples/b.rb
 - samples/c.rb
 - samples/d.rb
-has_rdoc: false
-homepage: http://codeforpeople.com/lib/ruby/forkoff/
+- test/forkoff.rb
+has_rdoc: true
+homepage: http://github.com/ahoward/forkoff/tree/master
+licenses: []
+
 post_install_message: 
 rdoc_options: []
 
@@ -55,9 +56,9 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: codeforpeople
-rubygems_version: 1.2.0
+rubygems_version: 1.3.5
 signing_key: 
-specification_version: 2
+specification_version: 3
 summary: forkoff
-test_files: []
-
+test_files: 
+- test/forkoff.rb

data/gemspec.rb

@@ -1,35 +0,0 @@
-lib, version = File::basename(File::dirname(File::expand_path(__FILE__))).split %r/-/, 2
-
-require 'rubygems'
-
-Gem::Specification::new do |spec|
-  $VERBOSE = nil
-
-  shiteless = lambda do |list|
-    list.delete_if do |file|
-      file =~ %r/\.svn/ or
-      file =~ %r/\.tmp/
-    end
-  end
-
-  spec.name = lib 
-  spec.version = version 
-  spec.platform = Gem::Platform::RUBY
-  spec.summary = lib 
-
-  spec.files = shiteless[Dir::glob("**/**")]
-  spec.executables = shiteless[Dir::glob("bin/*")].map{|exe| File::basename exe}
-  
-  spec.require_path = "lib" 
-
-  spec.has_rdoc = File::exist? "doc" 
-  spec.test_suite_file = "test/#{ lib }.rb" if File::directory? "test"
-  #spec.add_dependency 'lib', '>= version'
-
-  spec.extensions << "extconf.rb" if File::exists? "extconf.rb"
-
-  spec.author = "Ara T. Howard"
-  spec.email = "ara.t.howard@gmail.com"
-  spec.homepage = "http://codeforpeople.com/lib/ruby/#{ lib }/"
-  spec.rubyforge_project = 'codeforpeople'
-end

data/gen_readme.rb

@@ -1,32 +0,0 @@
-require 'pathname'
-
-$VERBOSE=nil
-
-def indent s, n = 2
-  ws = ' ' * n
-  s.gsub %r/^/, ws 
-end
-
-template = IO::read 'README.tmpl'
-
-samples = ''
-prompt = '~ > '
-
-Dir['sample*/*'].sort.each do |sample|
-  samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
-
-  cmd = "cat #{ sample }" 
-  samples << indent(prompt + cmd, 2) << "\n\n" 
-  samples << indent(`#{ cmd }`, 4) << "\n" 
-
-  cmd = "ruby #{ sample }" 
-  samples << indent(prompt + cmd, 2) << "\n\n" 
-
-  cmd = "ruby -Ilib #{ sample }" 
-  samples << indent(`#{ cmd } 2>&1`, 4) << "\n" 
-end
-
-#samples.gsub! %r/^/, '  '
-
-readme  = template.gsub %r/^\s*@samples\s*$/, samples
-print readme 

data/install.rb

@@ -1,214 +0,0 @@
-#!/usr/bin/env ruby
-require 'rbconfig'
-require 'find'
-require 'ftools'
-require 'tempfile'
-include Config
-
-LIBDIR      = "lib"
-LIBDIR_MODE = 0644
-
-BINDIR      = "bin"
-BINDIR_MODE = 0755
-
-
-$srcdir            = CONFIG["srcdir"]
-$version           = CONFIG["MAJOR"]+"."+CONFIG["MINOR"]
-$libdir            = File.join(CONFIG["libdir"], "ruby", $version)
-$archdir           = File.join($libdir, CONFIG["arch"])
-$site_libdir       = $:.find {|x| x =~ /site_ruby$/}
-$bindir            = CONFIG["bindir"] || CONFIG['BINDIR']
-$ruby_install_name = CONFIG['ruby_install_name'] || CONFIG['RUBY_INSTALL_NAME'] || 'ruby'
-$ruby_ext          = CONFIG['EXEEXT'] || ''
-$ruby              = File.join($bindir, ($ruby_install_name + $ruby_ext))
-
-if !$site_libdir
-  $site_libdir = File.join($libdir, "site_ruby")
-elsif $site_libdir !~ %r/#{Regexp.quote($version)}/
-  $site_libdir = File.join($site_libdir, $version)
-end
-
-def install_rb(srcdir=nil, destdir=nil, mode=nil, bin=nil)
-#{{{
-  path   = []
-  dir    = []
-  Find.find(srcdir) do |f|
-    next unless FileTest.file?(f)
-    next if (f = f[srcdir.length+1..-1]) == nil
-    next if (/CVS$/ =~ File.dirname(f))
-    next if (/\.svn/ =~ File.dirname(f))
-    next if f =~ %r/\.lnk/
-    next if f =~ %r/\.svn/
-    next if f =~ %r/\.swp/
-    next if f =~ %r/\.svn/
-    path.push f
-    dir |= [File.dirname(f)]
-  end
-  for f in dir
-    next if f == "."
-    next if f == "CVS"
-    File::makedirs(File.join(destdir, f))
-  end
-  for f in path
-    next if (/\~$/ =~ f)
-    next if (/^\./ =~ File.basename(f))
-    unless bin
-      File::install(File.join(srcdir, f), File.join(destdir, f), mode, true)
-    else
-      from = File.join(srcdir, f)
-      to = File.join(destdir, f)
-      shebangify(from) do |sf|
-        $deferr.print from, " -> ", File::catname(from, to), "\n"
-        $deferr.printf "chmod %04o %s\n", mode, to 
-        File::install(sf, to, mode, false)
-      end
-    end
-  end
-#}}}
-end
-def shebangify f
-#{{{
-  open(f) do |fd|
-    buf = fd.read 42 
-    if buf =~ %r/^\s*#\s*!.*ruby/o
-      ftmp = Tempfile::new("#{ $$ }_#{ File::basename(f) }")
-      begin
-        fd.rewind
-        ftmp.puts "#!#{ $ruby  }"
-        while((buf = fd.read(8192)))
-          ftmp.write buf
-        end
-        ftmp.close
-        yield ftmp.path
-      ensure
-        ftmp.close!
-      end
-    else
-      yield f
-    end
-  end
-#}}}
-end
-def ARGV.switch
-#{{{
-  return nil if self.empty?
-  arg = self.shift
-  return nil if arg == '--'
-  if arg =~ /^-(.)(.*)/
-    return arg if $1 == '-'
-    raise 'unknown switch "-"' if $2.index('-')
-    self.unshift "-#{$2}" if $2.size > 0
-    "-#{$1}"
-  else
-    self.unshift arg
-    nil
-  end
-#}}}
-end
-def ARGV.req_arg
-#{{{
-  self.shift || raise('missing argument')
-#}}}
-end
-def linkify d, linked = []
-#--{{{
-  if test ?d, d
-    versioned = Dir[ File::join(d, "*-[0-9].[0-9].[0-9].rb") ]
-    versioned.each do |v| 
-      src, dst = v, v.gsub(%r/\-[\d\.]+\.rb$/, '.rb')
-      lnk = nil
-      begin
-        if test ?l, dst
-          lnk = "#{ dst }.lnk"
-          puts "#{ dst } -> #{ lnk }"
-          File::rename dst, lnk
-        end
-        unless test ?e, dst
-          puts "#{ src } -> #{ dst }"
-          File::copy src, dst 
-          linked << dst
-        end
-      ensure
-        if lnk
-          at_exit do
-            puts "#{ lnk } -> #{ dst }"
-            File::rename lnk, dst
-          end
-        end
-      end
-    end
-  end
-  linked
-#--}}}
-end
-
-
-#
-# main program
-#
-
-libdir = $site_libdir
-bindir = $bindir
-no_linkify = false
-linked = nil
-help = false
-
-usage = <<-usage
-  #{ File::basename $0 }
-    -d, --destdir    <destdir>
-    -l, --libdir     <libdir>
-    -b, --bindir     <bindir>
-    -r, --ruby       <ruby>
-    -n, --no_linkify
-    -s, --sudo
-    -h, --help
-usage
-
-begin
-  while switch = ARGV.switch
-    case switch
-    when '-d', '--destdir'
-      libdir = ARGV.req_arg
-    when '-l', '--libdir'
-      libdir = ARGV.req_arg
-    when '-b', '--bindir'
-      bindir = ARGV.req_arg
-    when '-r', '--ruby'
-      $ruby = ARGV.req_arg
-    when '-n', '--no_linkify'
-      no_linkify = true
-    when '-s', '--sudo'
-      sudo = 'sudo' 
-    when '-h', '--help'
-      help = true
-    else
-      raise "unknown switch #{switch.dump}"
-    end
-  end
-rescue
-  STDERR.puts $!.to_s
-  STDERR.puts usage
-  exit 1
-end    
-
-if help
-  STDOUT.puts usage
-  exit
-end
-
-system "#{ sudo } #{ $ruby } pre-install.rb" if test(?s, 'pre-install.rb')
-
-unless no_linkify
-  linked = linkify('lib') + linkify('bin')
-end
-
-system "#{ $ruby } extconf.rb && make && #{ sudo } make install" if test(?s, 'extconf.rb')
-
-install_rb(LIBDIR, libdir, LIBDIR_MODE)
-install_rb(BINDIR, bindir, BINDIR_MODE, bin=true)
-
-if linked
-  linked.each{|path| File::rm_f path}
-end
-
-system "#{ sudo } #{ $ruby } post-install.rb" if test(?s, 'post-install.rb')