open4 0.9.6 → 1.0.1

data/README

@@ -8,162 +8,6 @@ SYNOPSIS
   open child process with handles on pid, stdin, stdout, and stderr: manage
   child processes and their io handles easily.
 
-HISTORY
-
-  0.9.5:
-    - another patch from Corey Jewett, this time dealing with ruby's handling
-      of chdir and threads.  basically the 'cwd' keyword to open4 cannot work
-      with multiple threads (aka background) because ruby cannot cause green
-      threads to have an actuall different working dir.  the moral is that the
-      :cwd/'cwd' keyword to spawn will work with 0 or 1 threads in effect.
-  
-  0.9.4:
-    - patch to #background from Corey Jewett
-
-
-  0.9.3:
-    - removed some debugging output accidentally left in 0.9.2.  arggh!
-
-  0.9.2:
-    - fixed a descriptor leak.  thanks Andre Nathan.
-
-  0.9.1:
-    - fixed warning with '-w' : @cid not initialized.  thanks blaise tarr.
-
-  0.9.0:
-    - added the ability for open4.spawn to take either an array of arguments
-      or multiple arguments in order to specify the argv for the command run.
-      for example
-
-        open4.spawn ['touch', 'difficult to "quote"'], :stdout=>STDOUT
-
-      same thing
-
-        open4.spawn 'touch', 'difficult to "quote"', :stdout=>STDOUT
-
-      thanks to jordan breeding for this suggestion
-
-
-    - added 'cwd'/:cwd keyword.  usage is pretty obivous
-
-        open4.spawn 'pwd', 1=>STDOUT, :cwd=>'/tmp'   #=> /tmp
-
-      this one also from jordan
-
-  0.8.0:
-
-    - fixed a critical bug whereby a process producing tons of stdout, but for
-      which the stdout was not handled, would cause the child process to
-      become blocked/hung writing to the pipe.  eg, this command would cause a
-      hang
-
-        include Open4
-
-        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "'
-
-      whereas this one would not
-
-        include Open4
-
-        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "', :stdout=>StringIO.new
-
-      this version handles the former by spawning a 'null' thread which reads,
-      but does not process stdout/stderr.  that way commands which generate
-      tons of output will never become blocked.
-
-  0.7.0:
-    - merged functionality of exitstatus/status keywords:
-
-        include Open4
-
-        spawn 'ruby -e "exit 42"'                 # raises 
-        spawn 'ruby -e "exit 42"', :status=>true  # ok, returns status
-        spawn 'ruby -e "exit 42"', :status=>42    # raises if status != 42
-        spawn 'ruby -e "exit 42"', :status=>0,42  # raises if status != 0||42
-
-    - the 0.6.0 was broken on rubyforge... this release fixes that (somehow!?)
-
-  0.6.0:
-    - added feature for exitstatus to be list of acceptable exit statuses
-
-        Open4.spawn 'ruby -e "exit 42"'                      # raises
-        Open4.spawn 'ruby -e "exit 42"', :exitstatus=>[0,42] # ok
-
-    - added :status switch, which will always simply return the status (no
-      error thrown for failure)
-
-        Open4.spawn 'ruby -e "exit 42"'                          # raises 
-        status = Open4.spawn 'ruby -e "exit 42"', :status=>true  # ok 
-
-      note, however, that any SpawnError does in fact contain the failed
-      status so, even when they are thrown, error status can be retrieved:
-
-        include Open4
-
-        status =
-          begin
-            spawn 'ruby -e "exit 42"'
-          rescue SpawnError => e
-            warn{ e }
-            e.status
-          end
-
-  0.5.1:
-    - fixes a __critical__ but in ThreadEnsemble class that had a race
-      condition that could cause thread deadlock.  sorry bout that folks.
-
-  0.5.0:
-    - on the suggestion of tim pease (thanks tim!), i added timeout features
-      to open4.  the command run may have an overall timeout and individual
-      timeouts set for each of the io handles.  for example
-
-        cmd = 'command_that_produce_out_at_one_second_intervals'
-
-        open4.spawn cmd, :stdout_timeout => 2 
-
-      or 
-
-        cmd = 'command_that_should_complete_in_about_one_minute'
-
-        open4.spawn cmd, :timeout => 60
-
-      or
-
-        cmd = 'consumes_input_at_one_line_per_second_rate'
-
-        input = %w( 42 forty-two 42.0 )
-
-        open4.spawn cmd, :stdin=>input, :stdin_timeout=>1
-
-    - added 'open4' alias so one can write
-
-        open4.spawn  vs Open4.spawn
-
-      or even
-
-        open4(cmd) do |pid,i,o,e|
-        end
-
-    - added signal info to SpawnError
-
-  0.4.0:
-    - improved error handling contributed by jordan breeding.
-    - introduction of background/bg method
-
-  0.3.0 :
-    - bug fix from jordan breeding.  general clean up.  added spawn method.
-
-  0.2.0 :
-    - added exception marshaled from child -> parent when exec fails.  thanks
-      to jordan breeding for a patch (yay!) and paul brannan for this most
-      excellent idea.
-
-  0.1.0 :
-    - fixed docs to correctly show return value of popen4 (pid first not last).
-      thanks Stefanie Tellex <stefie10@alum.mit.edu> for catching this. 
-  0.0.0 :
-    - initial version
-
 INSTALL
 
   ~> gem install open4
@@ -349,9 +193,172 @@ SAMPLES
     42
     /dmsp/reference/ruby-1.8.1//lib/ruby/1.8/timeout.rb:42:in `relay': execution expired (Timeout::Error)
 
+HISTORY
+  1.0.0
+    - added ability for spawn to take a proc (respond_to?(:call))
+
+      cmd = ' ruby -e" 42.times{ puts 0b101010 } " '
+      include Open4
+      spawn cmd, :stdout => lambda{|buf| puts buf} 
+
+
+  0.9.5:
+    - another patch from Corey Jewett, this time dealing with ruby's handling
+      of chdir and threads.  basically the 'cwd' keyword to open4 cannot work
+      with multiple threads (aka background) because ruby cannot cause green
+      threads to have an actuall different working dir.  the moral is that the
+      :cwd/'cwd' keyword to spawn will work with 0 or 1 threads in effect.
+  
+  0.9.4:
+    - patch to #background from Corey Jewett
+
+
+  0.9.3:
+    - removed some debugging output accidentally left in 0.9.2.  arggh!
+
+  0.9.2:
+    - fixed a descriptor leak.  thanks Andre Nathan.
+
+  0.9.1:
+    - fixed warning with '-w' : @cid not initialized.  thanks blaise tarr.
+
+  0.9.0:
+    - added the ability for open4.spawn to take either an array of arguments
+      or multiple arguments in order to specify the argv for the command run.
+      for example
+
+        open4.spawn ['touch', 'difficult to "quote"'], :stdout=>STDOUT
+
+      same thing
+
+        open4.spawn 'touch', 'difficult to "quote"', :stdout=>STDOUT
+
+      thanks to jordan breeding for this suggestion
+
+
+    - added 'cwd'/:cwd keyword.  usage is pretty obivous
+
+        open4.spawn 'pwd', 1=>STDOUT, :cwd=>'/tmp'   #=> /tmp
+
+      this one also from jordan
+
+  0.8.0:
+
+    - fixed a critical bug whereby a process producing tons of stdout, but for
+      which the stdout was not handled, would cause the child process to
+      become blocked/hung writing to the pipe.  eg, this command would cause a
+      hang
+
+        include Open4
+
+        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "'
+
+      whereas this one would not
+
+        include Open4
+
+        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "', :stdout=>StringIO.new
+
+      this version handles the former by spawning a 'null' thread which reads,
+      but does not process stdout/stderr.  that way commands which generate
+      tons of output will never become blocked.
+
+  0.7.0:
+    - merged functionality of exitstatus/status keywords:
+
+        include Open4
+
+        spawn 'ruby -e "exit 42"'                 # raises 
+        spawn 'ruby -e "exit 42"', :status=>true  # ok, returns status
+        spawn 'ruby -e "exit 42"', :status=>42    # raises if status != 42
+        spawn 'ruby -e "exit 42"', :status=>0,42  # raises if status != 0||42
+
+    - the 0.6.0 was broken on rubyforge... this release fixes that (somehow!?)
+
+  0.6.0:
+    - added feature for exitstatus to be list of acceptable exit statuses
+
+        Open4.spawn 'ruby -e "exit 42"'                      # raises
+        Open4.spawn 'ruby -e "exit 42"', :exitstatus=>[0,42] # ok
+
+    - added :status switch, which will always simply return the status (no
+      error thrown for failure)
+
+        Open4.spawn 'ruby -e "exit 42"'                          # raises 
+        status = Open4.spawn 'ruby -e "exit 42"', :status=>true  # ok 
+
+      note, however, that any SpawnError does in fact contain the failed
+      status so, even when they are thrown, error status can be retrieved:
+
+        include Open4
+
+        status =
+          begin
+            spawn 'ruby -e "exit 42"'
+          rescue SpawnError => e
+            warn{ e }
+            e.status
+          end
+
+  0.5.1:
+    - fixes a __critical__ but in ThreadEnsemble class that had a race
+      condition that could cause thread deadlock.  sorry bout that folks.
+
+  0.5.0:
+    - on the suggestion of tim pease (thanks tim!), i added timeout features
+      to open4.  the command run may have an overall timeout and individual
+      timeouts set for each of the io handles.  for example
+
+        cmd = 'command_that_produce_out_at_one_second_intervals'
+
+        open4.spawn cmd, :stdout_timeout => 2 
+
+      or 
+
+        cmd = 'command_that_should_complete_in_about_one_minute'
+
+        open4.spawn cmd, :timeout => 60
+
+      or
+
+        cmd = 'consumes_input_at_one_line_per_second_rate'
+
+        input = %w( 42 forty-two 42.0 )
+
+        open4.spawn cmd, :stdin=>input, :stdin_timeout=>1
+
+    - added 'open4' alias so one can write
+
+        open4.spawn  vs Open4.spawn
+
+      or even
+
+        open4(cmd) do |pid,i,o,e|
+        end
+
+    - added signal info to SpawnError
+
+  0.4.0:
+    - improved error handling contributed by jordan breeding.
+    - introduction of background/bg method
+
+  0.3.0 :
+    - bug fix from jordan breeding.  general clean up.  added spawn method.
+
+  0.2.0 :
+    - added exception marshaled from child -> parent when exec fails.  thanks
+      to jordan breeding for a patch (yay!) and paul brannan for this most
+      excellent idea.
+
+  0.1.0 :
+    - fixed docs to correctly show return value of popen4 (pid first not last).
+      thanks Stefanie Tellex <stefie10@alum.mit.edu> for catching this. 
+  0.0.0 :
+    - initial version
+
 AUTHOR
 
-  ara.t.howard@noaa.gov
+  ara.t.howard@gmail.com
 
 LICENSE
 

data/README.erb

@@ -0,0 +1,365 @@
+URIS
+
+  http://rubyforge.org/projects/codeforpeople/
+  http://www.codeforpeople.com/lib/ruby/
+
+SYNOPSIS
+
+  open child process with handles on pid, stdin, stdout, and stderr: manage
+  child processes and their io handles easily.
+
+INSTALL
+
+  ~> gem install open4
+
+SAMPLES
+
+  ----------------------------------------------------------------------------
+  simple usage
+  ----------------------------------------------------------------------------
+
+    harp: > cat sample/simple.rb
+    require "open4"
+
+    pid, stdin, stdout, stderr = Open4::popen4 "sh"
+
+    stdin.puts "echo 42.out"
+    stdin.puts "echo 42.err 1>&2"
+    stdin.close
+
+    ignored, status = Process::waitpid2 pid
+
+    puts "pid        : #{ pid }"
+    puts "stdout     : #{ stdout.read.strip }"
+    puts "stderr     : #{ stderr.read.strip }"
+    puts "status     : #{ status.inspect }"
+    puts "exitstatus : #{ status.exitstatus }"
+
+
+    harp: > ruby sample/simple.rb
+    pid        : 17273
+    stdout     : 42.out
+    stderr     : 42.err
+    status     : #<Process::Status: pid=17273,exited(0)>
+    exitstatus : 0
+
+
+  ----------------------------------------------------------------------------
+  in block form - the child process is automatically waited for
+  ----------------------------------------------------------------------------
+
+    harp: > cat sample/block.rb
+    require 'open4'
+
+    status =
+      Open4::popen4("sh") do |pid, stdin, stdout, stderr|
+        stdin.puts "echo 42.out"
+        stdin.puts "echo 42.err 1>&2"
+        stdin.close
+
+        puts "pid        : #{ pid }"
+        puts "stdout     : #{ stdout.read.strip }"
+        puts "stderr     : #{ stderr.read.strip }"
+      end
+
+        puts "status     : #{ status.inspect }"
+        puts "exitstatus : #{ status.exitstatus }"
+
+
+    harp: > ruby sample/block.rb
+    pid        : 17295
+    stdout     : 42.out
+    stderr     : 42.err
+    status     : #<Process::Status: pid=17295,exited(0)>
+    exitstatus : 0
+
+  ----------------------------------------------------------------------------
+  exceptions are marshaled from child to parent if fork/exec fails
+  ----------------------------------------------------------------------------
+
+    harp: > cat sample/exception.rb
+    require "open4"
+    Open4::popen4 "noexist"
+
+
+    harp: > ruby sample/exception.rb
+    /dmsp/reference/ruby-1.8.1//lib/ruby/site_ruby/open4.rb:100:in `popen4': No such file or directory - noexist (Errno::ENOENT)
+            from sample/exception.rb:3
+
+  ----------------------------------------------------------------------------
+  the spawn method provides and even more convenient method of running a
+  process, allowing any object that supports 'each', 'read', or 'to_s' to be
+  given as stdin and any objects that support '<<' to be given as
+  stdout/stderr.  an exception is thrown if the exec'd cmd fails (nonzero
+  exitstatus) unless the option 'raise'=>false is given
+  ----------------------------------------------------------------------------
+  
+    harp: > cat sample/spawn.rb
+    require 'open4'
+    include Open4
+
+    cat = '  ruby -e"  ARGF.each{|line| STDOUT << line}  "  '
+
+    stdout, stderr = '', ''
+    status = spawn cat, 'stdin' => '42', 'stdout' => stdout, 'stderr' => stderr
+    p status
+    p stdout
+    p stderr
+
+    stdout, stderr = '', ''
+    status = spawn cat, 0=>'42', 1=>stdout, 2=>stderr
+    p status
+    p stdout
+    p stderr
+
+
+    harp: > RUBYLIB=lib ruby sample/spawn.rb
+    0
+    "42"
+    ""
+    0
+    "42"
+    ""
+
+
+  ----------------------------------------------------------------------------
+  the bg/background method is similar to spawn, but the process is
+  automatically set running in a thread.  the returned thread has several
+  methods added dynamically which return the pid and blocking calls to the
+  exitstatus.
+  ----------------------------------------------------------------------------
+
+    harp: > cat sample/bg.rb
+    require 'yaml'
+    require 'open4'
+    include Open4
+
+    stdin = '42'
+    stdout = ''
+    stderr = ''
+
+    t = bg 'ruby -e"sleep 4; puts ARGF.read"', 0=>stdin, 1=>stdout, 2=>stderr
+
+    waiter = Thread.new{ y t.pid => t.exitstatus } # t.exitstatus is a blocking call!
+
+    while((status = t.status))
+      y "status" => status
+      sleep 1
+    end
+
+    waiter.join
+
+    y "stdout" => stdout
+
+
+    harp: > ruby sample/bg.rb
+    ---
+    status: run
+    ---
+    status: sleep
+    ---
+    status: sleep
+    ---
+    status: sleep
+    ---
+    21357: 0
+    ---
+    stdout: "42\n"
+
+  ----------------------------------------------------------------------------
+  the timeout methods can be used to ensure execution is preceding at the
+  desired interval.  note also how to setup a 'pipeline'
+  ----------------------------------------------------------------------------
+
+    harp: > cat sample/stdin_timeout.rb
+    require 'open4'
+
+    producer = 'ruby -e" STDOUT.sync = true; loop{sleep(rand+rand) and puts 42} "'
+
+    consumer = 'ruby -e" STDOUT.sync = true; STDIN.each{|line| puts line} "'
+
+    open4(producer) do |pid, i, o, e|
+
+      open4.spawn consumer, :stdin=>o, :stdout=>STDOUT, :stdin_timeout => 1.4
+
+    end
+
+
+    harp: > ruby sample/stdin_timeout.rb
+    42
+    42
+    42
+    42
+    42
+    /dmsp/reference/ruby-1.8.1//lib/ruby/1.8/timeout.rb:42:in `relay': execution expired (Timeout::Error)
+
+HISTORY
+  1.0.0
+    - added ability for spawn to take a proc (respond_to?(:call))
+
+      cmd = ' ruby -e" 42.times{ puts 0b101010 } " '
+      include Open4
+      spawn cmd, :stdout => lambda{|buf| puts buf} 
+
+
+  0.9.5:
+    - another patch from Corey Jewett, this time dealing with ruby's handling
+      of chdir and threads.  basically the 'cwd' keyword to open4 cannot work
+      with multiple threads (aka background) because ruby cannot cause green
+      threads to have an actuall different working dir.  the moral is that the
+      :cwd/'cwd' keyword to spawn will work with 0 or 1 threads in effect.
+  
+  0.9.4:
+    - patch to #background from Corey Jewett
+
+
+  0.9.3:
+    - removed some debugging output accidentally left in 0.9.2.  arggh!
+
+  0.9.2:
+    - fixed a descriptor leak.  thanks Andre Nathan.
+
+  0.9.1:
+    - fixed warning with '-w' : @cid not initialized.  thanks blaise tarr.
+
+  0.9.0:
+    - added the ability for open4.spawn to take either an array of arguments
+      or multiple arguments in order to specify the argv for the command run.
+      for example
+
+        open4.spawn ['touch', 'difficult to "quote"'], :stdout=>STDOUT
+
+      same thing
+
+        open4.spawn 'touch', 'difficult to "quote"', :stdout=>STDOUT
+
+      thanks to jordan breeding for this suggestion
+
+
+    - added 'cwd'/:cwd keyword.  usage is pretty obivous
+
+        open4.spawn 'pwd', 1=>STDOUT, :cwd=>'/tmp'   #=> /tmp
+
+      this one also from jordan
+
+  0.8.0:
+
+    - fixed a critical bug whereby a process producing tons of stdout, but for
+      which the stdout was not handled, would cause the child process to
+      become blocked/hung writing to the pipe.  eg, this command would cause a
+      hang
+
+        include Open4
+
+        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "'
+
+      whereas this one would not
+
+        include Open4
+
+        spawn 'ruby -e"  puts Array.new(65536){ 42 }  "', :stdout=>StringIO.new
+
+      this version handles the former by spawning a 'null' thread which reads,
+      but does not process stdout/stderr.  that way commands which generate
+      tons of output will never become blocked.
+
+  0.7.0:
+    - merged functionality of exitstatus/status keywords:
+
+        include Open4
+
+        spawn 'ruby -e "exit 42"'                 # raises 
+        spawn 'ruby -e "exit 42"', :status=>true  # ok, returns status
+        spawn 'ruby -e "exit 42"', :status=>42    # raises if status != 42
+        spawn 'ruby -e "exit 42"', :status=>0,42  # raises if status != 0||42
+
+    - the 0.6.0 was broken on rubyforge... this release fixes that (somehow!?)
+
+  0.6.0:
+    - added feature for exitstatus to be list of acceptable exit statuses
+
+        Open4.spawn 'ruby -e "exit 42"'                      # raises
+        Open4.spawn 'ruby -e "exit 42"', :exitstatus=>[0,42] # ok
+
+    - added :status switch, which will always simply return the status (no
+      error thrown for failure)
+
+        Open4.spawn 'ruby -e "exit 42"'                          # raises 
+        status = Open4.spawn 'ruby -e "exit 42"', :status=>true  # ok 
+
+      note, however, that any SpawnError does in fact contain the failed
+      status so, even when they are thrown, error status can be retrieved:
+
+        include Open4
+
+        status =
+          begin
+            spawn 'ruby -e "exit 42"'
+          rescue SpawnError => e
+            warn{ e }
+            e.status
+          end
+
+  0.5.1:
+    - fixes a __critical__ but in ThreadEnsemble class that had a race
+      condition that could cause thread deadlock.  sorry bout that folks.
+
+  0.5.0:
+    - on the suggestion of tim pease (thanks tim!), i added timeout features
+      to open4.  the command run may have an overall timeout and individual
+      timeouts set for each of the io handles.  for example
+
+        cmd = 'command_that_produce_out_at_one_second_intervals'
+
+        open4.spawn cmd, :stdout_timeout => 2 
+
+      or 
+
+        cmd = 'command_that_should_complete_in_about_one_minute'
+
+        open4.spawn cmd, :timeout => 60
+
+      or
+
+        cmd = 'consumes_input_at_one_line_per_second_rate'
+
+        input = %w( 42 forty-two 42.0 )
+
+        open4.spawn cmd, :stdin=>input, :stdin_timeout=>1
+
+    - added 'open4' alias so one can write
+
+        open4.spawn  vs Open4.spawn
+
+      or even
+
+        open4(cmd) do |pid,i,o,e|
+        end
+
+    - added signal info to SpawnError
+
+  0.4.0:
+    - improved error handling contributed by jordan breeding.
+    - introduction of background/bg method
+
+  0.3.0 :
+    - bug fix from jordan breeding.  general clean up.  added spawn method.
+
+  0.2.0 :
+    - added exception marshaled from child -> parent when exec fails.  thanks
+      to jordan breeding for a patch (yay!) and paul brannan for this most
+      excellent idea.
+
+  0.1.0 :
+    - fixed docs to correctly show return value of popen4 (pid first not last).
+      thanks Stefanie Tellex <stefie10@alum.mit.edu> for catching this. 
+  0.0.0 :
+    - initial version
+
+AUTHOR
+
+  ara.t.howard@gmail.com
+
+LICENSE
+
+  ruby's

data/Rakefile

@@ -0,0 +1,225 @@
+
+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.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+
+            spec.description = "manage child processes and their io handles easily"
+
+            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/lib/open4.rb

@@ -5,7 +5,7 @@ require 'thread'
 
 module Open4
 #--{{{
-  VERSION = '0.9.6'
+  VERSION = '1.0.1'
   def self.version() VERSION end
 
   class Error < ::StandardError; end
@@ -17,6 +17,7 @@ module Open4
     verbose = $VERBOSE
     begin
       $VERBOSE = nil
+      ps.first.fcntl(Fcntl::F_SETFD, Fcntl::FD_CLOEXEC)
       ps.last.fcntl(Fcntl::F_SETFD, Fcntl::FD_CLOEXEC)
 
       cid = fork {
@@ -196,10 +197,17 @@ module Open4
 
   def relay src, dst = nil, t = nil
 #--{{{
+    send_dst =
+      if dst.respond_to?(:call)
+        lambda{|buf| dst.call(buf)}
+      else
+        lambda{|buf| dst << buf}
+      end
+
     unless src.nil?
       if src.respond_to? :gets
         while buf = to(t){ src.gets }
-          dst << buf if dst
+          send_dst[buf]
         end
 
       elsif src.respond_to? :each
@@ -218,7 +226,7 @@ module Open4
         begin
           src.each do |buf|
             timer_cancel[t]
-            dst << buf if dst
+            send_dst[buf]
             timer_set[t]
           end
         ensure
@@ -227,11 +235,11 @@ module Open4
 
       elsif src.respond_to? :read
         buf = to(t){ src.read }
-        dst << buf if dst 
+        send_dst[buf]
 
       else
         buf = to(t){ src.to_s }
-        dst << buf if dst 
+        send_dst[buf]
       end
     end
 #--}}}

data/open4.gemspec

@@ -0,0 +1,28 @@
+## open4.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "open4"
+  spec.version = "1.0.1"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "open4"
+
+  spec.description = "manage child processes and their io handles easily"
+
+  spec.files = ["lib", "lib/open4.rb", "open4.gemspec", "Rakefile", "README", "README.erb", "samples", "samples/bg.rb", "samples/block.rb", "samples/exception.rb", "samples/simple.rb", "samples/spawn.rb", "samples/stdin_timeout.rb", "samples/timeout.rb", "white_box", "white_box/leak.rb"]
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.has_rdoc = true
+  spec.test_files = nil
+  #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/open4/tree/master"
+end

metadata

@@ -1,60 +1,67 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.2
-specification_version: 1
 name: open4
 version: !ruby/object:Gem::Version 
-  version: 0.9.6
-date: 2007-07-18 00:00:00 -06:00
-summary: open4
-require_paths: 
-- lib
-email: ara.t.howard@noaa.gov
-homepage: http://codeforpeople.com/lib/ruby/open4/
-rubyforge_project: 
-description: 
-autorequire: open4
-default_executable: 
-bindir: bin
-has_rdoc: false
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">"
-    - !ruby/object:Gem::Version 
-      version: 0.0.0
-  version: 
+  version: 1.0.1
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - Ara T. Howard
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-18 00:00:00 -06:00
+default_executable: 
+dependencies: []
+
+description: manage child processes and their io handles easily
+email: ara.t.howard@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
 files: 
-- gemspec.rb
-- install.rb
-- lib
 - lib/open4.rb
+- open4.gemspec
+- Rakefile
 - README
-- sample
-- sample/bg.rb
-- sample/block.rb
-- sample/exception.rb
-- sample/simple.rb
-- sample/spawn.rb
-- sample/stdin_timeout.rb
-- sample/timeout.rb
-- white_box
+- README.erb
+- samples/bg.rb
+- samples/block.rb
+- samples/exception.rb
+- samples/simple.rb
+- samples/spawn.rb
+- samples/stdin_timeout.rb
+- samples/timeout.rb
 - white_box/leak.rb
-test_files: []
+has_rdoc: true
+homepage: http://github.com/ahoward/open4/tree/master
+licenses: []
 
+post_install_message: 
 rdoc_options: []
 
-extra_rdoc_files: []
-
-executables: []
-
-extensions: []
-
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: []
+rubyforge_project: codeforpeople
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: open4
+test_files: []
 

data/gemspec.rb

@@ -1,23 +0,0 @@
-lib, version = File::basename(File::dirname(File::expand_path(__FILE__))).split %r/-/, 2
-
-require 'rubygems'
-
-Gem::Specification::new do |spec|
-  spec.name = lib 
-  spec.version = version 
-  spec.platform = Gem::Platform::RUBY
-  spec.summary = lib 
-
-  spec.files = Dir::glob "**/**"
-  spec.executables = Dir::glob("bin/*").map{|exe| File::basename exe}
-  
-  spec.require_path = "lib" 
-  spec.autorequire = lib
-
-  spec.has_rdoc = File::exist? "doc" 
-  spec.test_suite_file = "test/#{ lib }.rb" if File::directory? "test"
-
-  spec.author = "Ara T. Howard"
-  spec.email = "ara.t.howard@noaa.gov"
-  spec.homepage = "http://codeforpeople.com/lib/ruby/#{ lib }/"
-end

data/install.rb

@@ -1,201 +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 f =~ %r/\.lnk/
-    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
-    -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 '-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
-
-unless no_linkify
-  linked = linkify('lib') + linkify('bin')
-end
-
-install_rb(LIBDIR, libdir, LIBDIR_MODE)
-install_rb(BINDIR, bindir, BINDIR_MODE, bin=true)
-
-if linked
-  linked.each{|path| File::rm_f path}
-end