Exit_0 1.3.0

data/.gitignore

@@ -0,0 +1,8 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+
+coverage
+rdoc
+.yardoc

data/Exit_0.gemspec

@@ -0,0 +1,32 @@
+# -*- encoding: utf-8 -*-
+
+$:.push File.expand_path("../lib", __FILE__)
+require "Exit_0/version"
+
+Gem::Specification.new do |s|
+  s.name        = "Exit_0"
+  s.version     = Exit_0::VERSION
+  s.authors     = ["da99"]
+  s.email       = ["i-hate-spam-45671204@mailinator.com"]
+  s.homepage    = "https://github.com/da99/Exit_0"
+  s.summary     = %q{Make sure your last child process exited with 0.}
+  s.description = %q{
+    A simple method that runs a child process and raises
+    Exit_Zero::Non_Zero if $?.exitstatus is not zero.
+  }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency 'bacon'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'Bacon_Colored'
+  s.add_development_dependency 'pry'
+  
+  # Specify any dependencies here; for example:
+  s.add_runtime_dependency 'posix-spawn'
+  s.add_runtime_dependency 'Split_Lines'
+  s.add_runtime_dependency 'open4'
+end

data/Gemfile

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in Bob.gemspec
+gemspec

data/README.md

@@ -0,0 +1,85 @@
+
+Exit\_0
+=========
+
+A simple method that raises Exit\_0::Non\_0 
+if $?.exitstatus is not 0. 
+
+Don't like Exit\_0? Try:
+
+* [posix-spawn](https://github.com/rtomayko/posix-spawn).
+That is the easiest way to handle child processes 
+(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\_0 runs your command through bash:
+
+    Exit_0 "
+      cd ~/
+      pwd
+    "
+
+    # --> Your command is processed as:
+    str = str.split("\n").map(:strip).map(&:reject).join('&&')
+    "bash -lc #{str.inspect}"
+
+Exit\_0 lives in one file. So if you have any questions, [here
+it is](https://github.com/da99/Exit\_0/blob/master/lib/Exit\_0.rb).
+
+
+Installation
+------------
+
+    gem install Exit_0
+
+Usage
+------
+
+    require "Exit_0"
+    
+    Exit_0 'uptime'
+    Exit_0 'ls', :input=>' /some/dir '
+    Exit_0 { system "uptime" }
+    
+    # The following raises an error.
+    Exit_0 'uptimeSS'
+    Exit_0 { `uptimeSSS` }
+
+    # Exit_0 and Exit_0 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
+---------
+
+    git clone git@github.com:da99/Exit_0.git
+    cd Exit_0
+    bundle update
+    bundle exec bacon spec/main.rb
+
+"I hate writing."
+-----------------------------
+
+If you know of existing software that makes the above redundant,
+please tell me. The last thing I want to do is maintain code.
+
+

data/Rakefile

@@ -0,0 +1,3 @@
+#!/usr/bin/env ruby
+
+require "bundler/gem_tasks"

data/lib/Exit_0/version.rb

@@ -0,0 +1,3 @@
+class Exit_0
+  VERSION = "1.3.0"
+end

data/lib/Exit_0.rb

@@ -0,0 +1,90 @@
+require 'Exit_0/version'
+require 'Split_Lines'
+require 'posix/spawn'
+
+def Exit_0 *cmd, &blok
+  
+  both = !cmd.empty? && block_given?
+  raise ArgumentError, "Both command and block are not allowed." if both
+
+  if block_given?
+    cmd = blok
+    r = p = blok.call
+    msg = cmd
+  else
+    r = p = Exit_0::Child.new(*cmd)
+    msg = p.err.strip.empty? ? p.cmd : p.err
+    msg << " (command: #{cmd})"
+  end
+
+
+  (r = r.status) if r.respond_to?(:status)
+  raise(Exit_0::Unknown_Exit, msg.inspect) unless r.respond_to?(:exitstatus)
+  raise(Exit_0::Non_0, "#{r.exitstatus} => #{msg}") if r.exitstatus != 0
+
+  p
+end # === Exit_0
+
+def Exit_Zero *cmd, &blok
+  Exit_0 *cmd, &blok
+end
+
+class Exit_0
+  
+  Non_0      = Class.new(RuntimeError)
+  Unknown_Exit  = Class.new(RuntimeError)
+  
+  module Class_Methods
+  end # === Class_Methods
+  
+  extend Class_Methods
+  
+  class Child
+    module Base
+      
+      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
+
+      def split_lines
+        Split_Lines(child.out)
+      end
+
+      %w{ out err }.each { |m|
+        eval %~
+          def raw_#{m}
+            child.#{m}
+          end
+
+          def #{m}
+            child.#{m}.strip
+          end
+        ~
+      }
+
+      def status
+        child.status
+      end
+
+    end # === Base
+    include Base
+  end # === Child
+  
+end # === class Exit_0

data/spec/helper.rb

@@ -0,0 +1,15 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.print e.message, "\n"
+  $stderr.print "Run `bundle install` to install missing gems\n"
+  exit e.status_code
+end
+require 'bacon'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+
+Bacon.summary_on_exit

data/spec/main.rb

@@ -0,0 +1,15 @@
+
+require File.expand_path('spec/helper')
+require 'Exit_0'
+require 'Bacon_Colored'
+require 'pry'
+
+
+# ======== Include the tests.
+if ARGV.size > 1 && ARGV[1, ARGV.size - 1].detect { |a| File.exists?(a) }
+  # Do nothing. Bacon grabs the file.
+else
+  Dir.glob('spec/tests/*.rb').each { |file|
+    require File.expand_path(file.sub('.rb', '')) if File.file?(file)
+  }
+end

data/spec/tests/Child.rb

@@ -0,0 +1,31 @@
+describe "Child.new" do
+  
+  it 'executes given string' do
+    Exit_0::Child.new("pwd").raw_out.should == `pwd`
+  end
+  
+end # === Exit_0::Child
+
+describe "Child#split_lines" do
+  
+  it "returns split lines of output through :split_lines" do
+    r = Exit_0::Child.new('ls -Al')
+    r.split_lines.should == `ls -Al`.strip.split("\n")
+  end
+  
+end # === Child#split_lines
+
+describe "Child delegate methods" 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_0::Child.new(cmd)
+      .send(m).should == target.send(o_m)
+    end
+  }
+  
+end # === Child delegate methods
+

data/spec/tests/Exit_0.rb

@@ -0,0 +1,100 @@
+
+describe "Exit_0 *cmd" do
+
+  it "accepts the same arguments as POSIX::Spawn::Child" do
+    Exit_0("dc", :input=>'4 4 + p').out
+    .should == "8"
+  end
+
+  it "raises Exit_0::Non_0 if command exits with non-0" do
+    lambda {
+      Exit_0 'uptimes'
+    }.should.raise(Exit_0::Non_0)
+    .message.should.match %r!127 => bash: uptimes: command not found!
+  end
+
+  it "returns a Exit_0::Child" do
+    Exit_0('whoami').class.should.be == Exit_0::Child
+  end
+
+  it "executes valid command" do
+    Exit_0('pwd').out.should == `pwd`.strip
+  end
+
+  it "raises ArgumentError if both a cmd and block are given" do
+    lambda { Exit_0('uptime') {} }
+    .should.raise(ArgumentError)
+    .message.should.match %r!are not allowed!i
+  end
+
+  it "combines a multi-line string into one string, joined by \"&&\"" do
+    Exit_0(%!
+      cd ~/
+      pwd
+    !)
+    .out.should == `cd ~/ && pwd`.strip
+  end
+
+  it "ignores empty lines in a multi-line string" do
+    Exit_0(%!
+      cd ~/
+
+      pwd
+    !).out.should == `cd ~/ && pwd`.strip
+  end
+
+end # === Exit_0 'cmd'
+
+describe "Exit_0 { }" do
+  
+  it "returns last value of the block" do
+    Exit_0{ POSIX::Spawn::Child.new("ls ~") }
+    .out.should. == `ls ~`
+  end
+
+  it "raises Exit_0::Non_0 if return value has exitstatus != 0" do
+    b = lambda { POSIX::Spawn::Child.new("something_not_found") }
+    lambda {
+      Exit_0(&b)
+    }.should.raise(Exit_0::Non_0)
+    .message.should == "127 => #{b.inspect}"
+  end
+  
+  it "raise Unknown_Exit if block return value does not respond to :status and :exitstatus" do
+    target = lambda { :a }
+    lambda {
+      Exit_0(&target)
+    }.should.raise(Exit_0::Unknown_Exit)
+    .message.should.match %r!#{Regexp.escape target.inspect}!
+  end
+  
+end # === Exit_0 { }
+
+describe "Exit_0::Child" do
+
+    # ---- :out
+  
+    it "returns stripped :out" do
+      Exit_0::Child.new("pwd").out
+      .should == `pwd`.strip
+    end
+
+    it "returns raw output for :raw_out" do
+      Exit_0::Child.new("pwd").raw_out
+      .should == `pwd`
+    end
+    
+    # ---- :err 
+    
+    it "returns stripped :err" do
+      Exit_0::Child.new("pwdssssss").err
+      .should == `bash -lc "pwdssssss" 2>&1`.strip
+    end
+
+    it "returns raw output for :raw_out" do
+      Exit_0::Child.new("no_exist").err
+      .should.match %r!no_exist: command not found!
+    end
+  
+end # === Exit_0::Child
+

data/spec/tests/Exit_Zero.rb

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

data/spec/tests/bin.rb

@@ -0,0 +1,10 @@
+
+describe "permissions of bin/" do
+  
+  it "should be 750" do
+    `stat -c %a bin`.strip
+    .should.be == "750"
+  end
+  
+end # === permissions of bin/
+

metadata

@@ -0,0 +1,171 @@
+--- !ruby/object:Gem::Specification
+name: Exit_0
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+  prerelease: 
+platform: ruby
+authors:
+- da99
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bacon
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: Bacon_Colored
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: posix-spawn
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: Split_Lines
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: open4
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! "\n    A simple method that runs a child process and raises\n    Exit_Zero::Non_Zero
+  if $?.exitstatus is not zero.\n  "
+email:
+- i-hate-spam-45671204@mailinator.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Exit_0.gemspec
+- Gemfile
+- README.md
+- Rakefile
+- lib/Exit_0.rb
+- lib/Exit_0/version.rb
+- 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_0
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: Make sure your last child process exited with 0.
+test_files: []