bkoski-better_backticks 0.5.0

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:patch: 0
+:major: 0
+:minor: 5

data/lib/better_backticks.rb

@@ -0,0 +1,2 @@
+require 'kernel'
+require 'open4'

data/lib/kernel.rb

@@ -0,0 +1,30 @@
+module Kernel
+  
+  # Override raises an error if _cmd_ returns a non-zero exit status.
+  # Returns stdout + stderr if _cmd_ succeeds.  Note that these are simply concatenated; STDERR is not inline.
+  def ` cmd
+    stdout, stderr = ''
+    
+    begin
+      status = Open4::popen4(cmd) do |pid, stdin_stream, stdout_stream, stderr_stream|
+        stdout = stdout_stream.read
+        stderr = stderr_stream.read
+      end
+      raise stderr.strip if !status.success?
+    rescue Exception => e
+      raise "'#{cmd}' failed with: '#{e.message}'"
+    end
+    
+    return stdout + stderr
+  end
+  
+  alias_method :system!, :system
+  
+  # Override raises an error if _cmd_ returns non-zero exit status.
+  # Returns true if _cmd_ succeeds. system!() preserves standard subshell handling (no exceptions; returns false on fail)
+  def system cmd
+    `#{cmd}`
+    return true
+  end
+  
+end

data/test/test_helper.rb

@@ -0,0 +1,10 @@
+require 'rubygems'
+require 'test/unit'
+require 'shoulda'
+require 'mocha'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'better_backticks'
+
+class Test::Unit::TestCase
+end

data/test/test_kernel.rb

@@ -0,0 +1,69 @@
+require File.dirname(__FILE__) + '/test_helper'
+
+class TestKernel < Test::Unit::TestCase
+
+  context "backticks" do
+    should "raise a runtime error with contents of stderr if command does not succeed" do
+      exception = assert_raises(RuntimeError) do
+        `echo "error text on stderr" >&2; exit -1;`
+      end
+      
+      assert_match "failed with: 'error text on stderr'", exception.message
+    end
+    
+    should "raise runtime error with contents of stderr if command is not found" do
+      exception = assert_raises(RuntimeError) do
+        `bad-cmd`
+      end
+      
+      assert_match "failed with: 'No such file or directory - bad-cmd'", exception.message
+    end
+  
+    should "return the contents of stdout + stderr if command succeeds" do
+      assert_match "std out\nstd err output\n", `echo "std out"; echo "std err output" >&2; exit 0;`
+    end
+  end
+  
+  context "%x{} syntax" do
+    should "raise a runtime error with contents of stderr if command does not succeed" do
+      exception = assert_raises(RuntimeError) do
+        %x{echo "error text on stderr" >&2; exit -1;}
+      end
+      
+      assert_match "failed with: 'error text on stderr'", exception.message
+    end
+  
+    should "return the contents of stdout + stderr if command succeeds" do
+      assert_match "std out\nstd err output\n", %x{echo "std out"; echo "std err output" >&2; exit 0;}
+    end
+  end
+  
+  context "system" do
+    should "raise a runtime error with contents of stderr if command does not succeed" do
+      exception = assert_raises(RuntimeError) do
+        system %{echo "error text on stderr" >&2; exit -1;}
+      end
+      
+      assert_match "failed with: 'error text on stderr'", exception.message
+    end
+    
+    should "return true if command succeeds" do
+      assert_kind_of TrueClass, system("echo 'hi!';")
+    end
+  end
+
+  context "system!" do
+    should "not raise an exception, even when command fails" do
+      assert_nothing_raised {system!("exit -1;")}
+    end
+    
+    should "return false when command fails" do
+      assert_kind_of FalseClass, system!("exit -1;")
+    end
+    
+    should "return true if command succeeds" do
+      assert_kind_of TrueClass, system!("echo 'hi!';")
+    end
+  end
+
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: bkoski-better_backticks
+version: !ruby/object:Gem::Version 
+  version: 0.5.0
+platform: ruby
+authors: 
+- Ben Koski
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-28 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: TODO
+email: gems@benkoski.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- VERSION.yml
+- lib/better_backticks.rb
+- lib/kernel.rb
+- test/test_helper.rb
+- test/test_kernel.rb
+has_rdoc: true
+homepage: http://benkoski.com/better_backticks
+post_install_message: 
+rdoc_options: 
+- --inline-source
+- --charset=UTF-8
+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.2.0
+signing_key: 
+specification_version: 2
+summary: TODO
+test_files: []
+