sfl 1.0

data/README.md

@@ -0,0 +1,28 @@
+# Spawn for Legacy
+
+Kernel.spawn in ruby 1.9 solves all issues on asynchronous executions.[1](http://ujihisa.blogspot.com/2010/03/how-to-run-external-command.html)[2](http://ujihisa.blogspot.com/2010/03/all-about-spawn.html)
+But ruby 1.8, the legacy version of MRI, is still used on many environments.
+
+This library provides `spawn()` which is almost perfectly compatible with ruby 1.9's.
+
+## Install
+
+    gem install sfl
+
+## How to use
+
+    require 'rubygems'
+    require 'sfl'
+    
+    spawn 'ls'
+
+If your ruby is 1.9, `require 'sfl'` doesn't do anything. If your ruby is 1.8, that defines `spawn`.
+
+## How compatible the spawn is?
+
+(I'll put the coverage here later)
+
+## Misc.
+
+* At first I tried to use the name `spawn` as this gem library name, but the name was already used. The `spawn` gem library does not mean ruby 1.9's `spawn` at all.
+* Ruby 1.9's `open3` library, based on `spawn`, is very useful. I would like to port `open3` to ruby 1.8 in my future.

data/lib/sfl.rb

@@ -0,0 +1,108 @@
+class SFL
+  attr_reader :command, :environment, :argument, :option
+
+  def initialize(*cmdandarg)
+    raise ArgumentError if cmdandarg.size == 0
+    cmdandarg = cmdandarg.dup
+
+    tmp = cmdandarg.shift
+    if Hash === tmp
+      @environment = tmp
+      tmp = cmdandarg.shift
+    else
+      @environment = {}
+    end
+
+    if String === tmp
+      @command = [tmp, tmp]
+    else
+      @command = tmp
+    end
+
+    if Hash === cmdandarg.last
+      @option = cmdandarg.pop
+    else
+      @option = {}
+    end
+
+    @argument = cmdandarg
+  end
+
+  def run
+    fork {
+      @environment.each do |k, v|
+        ENV[k] = v
+      end
+      self.class.option_parser(@option).each do |ast|
+        self.class.eval_ast ast
+      end
+      exec(@command, *@argument)
+    }
+  end
+
+  def ==(o) # Mostly for rspec
+    instance_variables.all? do |i|
+      i = i[1..-1] # '@a' -> 'a'
+      eval "self.#{i} == o.#{i}"
+    end
+  end
+
+  class << self
+    def option_parser(hash)
+      mapping = {
+        :out => STDOUT,
+        :err => STDERR,
+      }
+      result = []
+      chdir = hash.delete(:chdir)
+      if chdir
+        result[0] = [Dir, :chdir, chdir]
+      end
+      result += hash.map {|k, v|
+        right =
+          case v
+          when Symbol # :out or :err
+            mapping[v]
+          when String # filename
+            [File, :open, v, 'w']
+          when Array # filename with option
+            [File, :open, v[0], v[1]]
+          when IO
+            v
+          end
+
+        if Symbol === k
+          [[mapping[k], :reopen, right]]
+        else
+          # assuming k is like [:out, :err]
+          raise if k.size > 2
+          left1, left2 = *k.map {|i| mapping[i] }
+          [
+            [left1, :reopen, right],
+            [left2, :reopen, left1],
+          ]
+        end
+      }.flatten(1)
+      result
+    end
+
+    def eval_ast(ast)
+      case ast
+      when Array
+        if ast.size > 2
+          eval_ast(ast[0]).send(ast[1], *ast[2..-1].map {|i| eval_ast(i) })
+        else
+          eval_ast(ast[0]).send(ast[1])
+        end
+      else
+        ast
+      end
+    end
+  end
+end
+
+if RUBY_VERSION < '1.9'
+  def spawn(*x)
+    SFL.new(*x).run
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: sfl
+version: !ruby/object:Gem::Version 
+  version: "1.0"
+platform: ruby
+authors: 
+- ujihisa
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-03-07 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Spawn For Ruby 1.8
+email: ujihisa at gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- lib/sfl.rb
+- README.md
+has_rdoc: true
+homepage: https://github.com/ujihisa/spawn-for-legacy
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+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: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Spawn For Ruby 1.8
+test_files: []
+