guns 0.1.0

data/README.md

@@ -0,0 +1,44 @@
+# Guns
+It has two pipes; got tickets to the show?
+
+A low overhead sh utility to replace [session](http://www.codeforpeople.com/lib/ruby/session/)
+
+
+## Install
+
+    gem install guns -s http://gemcutter.org
+
+## Flexing
+
+DISCLAIMER:  It's not recommended to use guns in place of you shell
+I'm purely using IRB for demonstration
+
+    $ irb -r rubygems -r guns
+    >> Guns.sh "ls not-a-dir"
+    => ["", "ls: not-a-dir: No such file or directory\n", 1]
+
+The `sh` method returns a tuple containing `stdout`, `stderr`, and `exitstatus`.
+
+### Die hard
+
+    >> Guns.sh! "ls not-a-dir"
+    Guns::Failure: ls: not-a-dir: No such file or directory
+
+        from ./lib/guns.rb:50:in `sh!'
+        from (irb):3
+`sh!` will raise an error on a non-zero exit status
+
+### Environment variables
+
+    >> Guns.sh "echo $FOO", "FOO" => "bar"
+    ["bar\n", "", 0]
+
+## Further Reading
+
+If you need more flexability and features, see [Rush](http://github.com/adamwiggins/rush)
+
+TODO:  Replace popen3
+
+## Thanks
+[Joe Ruscio](http://github.com/josephruscio) for helping me debug that nasty deadlock
+[Ryan Tomayko](http://www.tomayko.com) for Shotgun; where I got started with this

data/guns.gemspec

@@ -0,0 +1,26 @@
+Gem::Specification.new do |s|
+  s.specification_version = 2 if s.respond_to? :specification_version=
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+
+  s.name = 'guns'
+  s.version = '0.1.0'
+  s.date = '2009-10-30'
+
+  s.description = "Guns - It's got two pipes; got tickets to the show?"
+  s.summary     = s.description
+
+  s.authors = ["Blake Mizerany"]
+  s.email = "blake.mizerany@gmail.com"
+
+  s.files = %w[
+    README.md
+    guns.gemspec
+    lib/guns.rb
+  ]
+
+  s.extra_rdoc_files = %w[README.md]
+
+  s.homepage = "http://github.com/bmizerany/guns/"
+  s.require_paths = %w[lib]
+  s.rubygems_version = '1.1.1'
+end

data/lib/guns.rb

@@ -0,0 +1,56 @@
+module Guns
+
+  class Failure < Exception ; end
+
+  def sh(cmd, *args)
+    env = args.pop if args.last.kind_of?(Hash)
+
+    rout, wout = IO.pipe
+    rerr, werr = IO.pipe
+
+    # Disable GC before forking in an attempt to get some advantage
+    # out of COW.
+
+    GC.disable
+
+    if fork
+      # Parent
+      wout.close
+      werr.close
+
+      Process.wait
+
+      exitstatus = $?.exitstatus
+      out = rout.read
+      err = rerr.read
+
+      [out, err, exitstatus]
+    else
+      # Child
+
+      if env
+        env.each {|k,v| ENV[k] = v}
+      end
+
+      STDOUT.reopen(wout)
+      STDERR.reopen(werr)
+
+      $0 = "#$0 -> [guns] #{cmd}"
+
+      system(cmd, *args)
+
+      exit! $?.exitstatus
+    end
+
+  ensure
+    GC.enable
+  end
+  module_function :sh
+
+  def sh!(*args)
+    out, err, code = sh(*args)
+    raise Failure, err if code != 0
+  end
+  module_function :sh!
+
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification 
+name: guns
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Blake Mizerany
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-30 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Guns - It's got two pipes; got tickets to the show?
+email: blake.mizerany@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- README.md
+- guns.gemspec
+- lib/guns.rb
+has_rdoc: true
+homepage: http://github.com/bmizerany/guns/
+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: 2
+summary: Guns - It's got two pipes; got tickets to the show?
+test_files: []
+