Exit_Zero 1.1.3 → 1.2.0

data/README.md

@@ -5,33 +5,63 @@ Exit\_Zero
 A simple method that raises Exit\_Zero::Non\_Zero 
 if $?.exitstatus is not zero. 
 
-If you want other functionality, such as capturing 
-standard output/error, then you should use
-[posix-spawn](https://github.com/rtomayko/posix-spawn).
+Don't like Exit\_Zero? Try:
+
+* [posix-spawn](https://github.com/rtomayko/posix-spawn).
 That is the easiest way to handle child processes 
-(aka shelling out a command). 
-[Here are other alternatives](http://stackoverflow.com/questions/6338908/ruby-difference-between-exec-system-and-x-or-backticks).
+(aka shelling out). 
+* [POpen4](https://github.com/shairontoledo/popen4) Don't confuse it with regular popen4.
+* [Here are other alternatives](http://stackoverflow.com/questions/6338908/ruby-difference-between-exec-system-and-x-or-backticks).
+
+Windows
+------
+
+Use something else. Check the previous list above
+for other alternatives, 
+especialy [POpen4](https://github.com/shairontoledo/popen4),
+which is Windows and POSIX compatible.
+
+Implementation
+----
 
+Exit\_Zero runs your command through bash:
+
+    your command: uptime
+    Final result: POSIX::Spawn::Child.new "bash -lc #{cmd.inspect}"
+
+Exit\_Zero lives in one file. So if you have any questions, [here
+it is](https://github.com/da99/Exit\_Zero/blob/master/lib/Exit\_Zero.rb).
 
 
 Installation
 ------------
 
-    gem 'Exit_Zero'
+    gem install Exit_Zero
 
-Useage
+Usage
 ------
 
     require "Exit_Zero"
     
-    Exit_Zero( 'uptime' )
-    Exit_Zero( 'ls', :input=>' /some/dir ')
+    Exit_Zero 'uptime'
+    Exit_Zero 'ls', :input=>' /some/dir '
     Exit_Zero { system "uptime" }
     
     # The following raises an error.
-    Exit_Zero( 'uptimess' )
-    Exit_Zero { `uptimesss` }
+    Exit_Zero 'uptimeSS'
+    Exit_Zero { `uptimeSSS` }
+
+    # Exit_0 and Exit_Zero are the same.
+    Exit_0 'uptime'
+    Exit_0 'grep a', :input=>"a \n b \n c"
 
+    # Get results from standard output, standard error.
+    Exit_0('uptime').out      # String is stripped.
+    Exit_0('uptimeSS').err    # String is stripped.
+    
+    Exit_0('uptime').raw_out  # Raw string, no :strip used.
+    Exit_0('uptime').raw_err  # Raw string, no :strip used.
+    
 Run Tests
 ---------
 

data/lib/Exit_Zero.rb

@@ -25,6 +25,10 @@ def Exit_Zero *cmd, &blok
   p
 end # === Exit_Zero
 
+def Exit_0 *cmd, &blok
+  Exit_Zero *cmd, &blok
+end
+
 class Exit_Zero
   
   Non_Zero      = Class.new(RuntimeError)
@@ -40,6 +44,21 @@ class Exit_Zero
       
       attr_reader :cmd, :child
       def initialize *cmd
+        if cmd[0].is_a?(String)
+          
+          if cmd[0]["\n"]
+            cmd[0] = begin
+                       cmd[0]
+                       .split("\n")
+                       .map(&:strip)
+                       .reject(&:empty?)
+                       .join(" && ") 
+                     end
+          end
+          
+          cmd[0] = "bash -lc #{cmd[0].inspect}"
+          
+        end
         @child = POSIX::Spawn::Child.new(*cmd)
         @cmd = cmd.join(' ')
       end
@@ -48,14 +67,22 @@ class Exit_Zero
         Split_Lines(child.out)
       end
 
-      %w{ out err status }.each { |m|
+      %w{ out err }.each { |m|
         eval %~
-          def #{m}
+          def raw_#{m}
             child.#{m}
           end
+
+          def #{m}
+            child.#{m}.strip
+          end
         ~
       }
 
+      def status
+        child.status
+      end
+
     end # === Base
     include Base
   end # === Child

data/lib/Exit_Zero/version.rb

@@ -1,3 +1,3 @@
 class Exit_Zero
-  VERSION = "1.1.3"
+  VERSION = "1.2.0"
 end

data/spec/tests/Child.rb

@@ -1,7 +1,7 @@
 describe "Child.new" do
   
   it 'executes given string' do
-    Exit_Zero::Child.new("pwd").out.should == `pwd`
+    Exit_Zero::Child.new("pwd").raw_out.should == `pwd`
   end
   
 end # === Exit_Zero::Child
@@ -17,12 +17,13 @@ end # === Child#split_lines
 
 describe "Child delegate methods" do
   
-  %w{ out err status }.each { |m|
-    it "sets :#{m} equal to Child##{m}" do
+  %w{ raw_out raw_err status }.each { |m|
+    o_m = m.sub("raw_", '')
+    it "sets :#{m} equal to Child :#{o_m}" do
       cmd = %q! ruby -e "puts 'a'; warn 'b'; exit(127);"!
       target = POSIX::Spawn::Child.new(cmd)
       Exit_Zero::Child.new(cmd)
-      .send(m).should == target.send(m)
+      .send(m).should == target.send(o_m)
     end
   }
   

data/spec/tests/Exit_0.rb

@@ -0,0 +1,9 @@
+describe "Exit_0" do
+  
+  it "accepts the same arguments as Exit_Zero" do
+    Exit_0("grep a", :input=>"a\nb\nc")
+    .out.should == "a"
+  end
+  
+end # === Exit_0
+

data/spec/tests/Exit_Zero.rb

@@ -3,14 +3,14 @@ describe "Exit_Zero *cmd" do
 
   it "accepts the same arguments as POSIX::Spawn::Child" do
     Exit_Zero("dc", :input=>'4 4 + p').out
-    .should == "8\n"
+    .should == "8"
   end
-  
+
   it "raises Exit_Zero::Non_Zero if command exits with non-zero" do
     lambda {
       Exit_Zero 'uptimes'
     }.should.raise(Exit_Zero::Non_Zero)
-    .message.should.match %r!127 => uptimes!
+    .message.should.match %r!127 => bash: uptimes: command not found!
   end
 
   it "returns a Exit_Zero::Child" do
@@ -18,7 +18,7 @@ describe "Exit_Zero *cmd" do
   end
 
   it "executes valid command" do
-    Exit_Zero('pwd').out.should == `pwd`
+    Exit_Zero('pwd').out.should == `pwd`.strip
   end
 
   it "raises ArgumentError if both a cmd and block are given" do
@@ -27,6 +27,22 @@ describe "Exit_Zero *cmd" do
     .message.should.match %r!are not allowed!i
   end
 
+  it "combines a multi-line string into one string, joined by \"&&\"" do
+    Exit_Zero(%!
+      cd ~/
+      pwd
+    !)
+    .out.should == `cd ~/ && pwd`.strip
+  end
+
+  it "ignores empty lines in a multi-line string" do
+    Exit_Zero(%!
+      cd ~/
+
+      pwd
+    !).out.should == `cd ~/ && pwd`.strip
+  end
+
 end # === Exit_Zero 'cmd'
 
 describe "Exit_Zero { }" do
@@ -54,3 +70,33 @@ describe "Exit_Zero { }" do
   
 end # === Exit_Zero { }
 
+describe "Exit_Zero::Child" do
+
+    # ---- :out
+  
+    it "returns stripped :out" do
+      Exit_Zero::Child.new("pwd").out
+      .should == `pwd`.strip
+    end
+
+    it "returns raw output for :raw_out" do
+      Exit_Zero::Child.new("pwd").raw_out
+      .should == `pwd`
+    end
+    
+    # ---- :err 
+    
+    it "returns stripped :err" do
+      Exit_Zero::Child.new("pwdssssss").err
+      .should == `bash -lc "pwdssssss" 2>&1`.strip
+    end
+
+    it "returns raw output for :raw_out" do
+      Exit_Zero::Child.new("no_exist").err
+      .should.match %r!no_exist: command not found!
+    end
+  
+end # === Exit_Zero::Child
+
+
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: Exit_Zero
 version: !ruby/object:Gem::Version
-  version: 1.1.3
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-13 00:00:00.000000000 Z
+date: 2012-04-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bacon
@@ -125,6 +125,7 @@ files:
 - spec/helper.rb
 - spec/main.rb
 - spec/tests/Child.rb
+- spec/tests/Exit_0.rb
 - spec/tests/Exit_Zero.rb
 - spec/tests/bin.rb
 homepage: https://github.com/da99/Exit_Zero