awesome_spawn 1.0.0

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0

data/.yardopts

@@ -0,0 +1 @@
+--markup markdown

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in awesome_spawn.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Red Hat, Inc.
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,41 @@
+# AwesomeSpawn
+
+[![Gem Version](https://badge.fury.io/rb/awesome_spawn.png)](http://badge.fury.io/rb/awesome_spawn)
+[![Build Status](https://travis-ci.org/ManageIQ/awesome_spawn.png)](https://travis-ci.org/ManageIQ/awesome_spawn)
+[![Code Climate](https://codeclimate.com/github/ManageIQ/awesome_spawn.png)](https://codeclimate.com/github/ManageIQ/awesome_spawn)
+[![Coverage Status](https://coveralls.io/repos/ManageIQ/awesome_spawn/badge.png?branch=master)](https://coveralls.io/r/ManageIQ/awesome_spawn)
+[![Dependency Status](https://gemnasium.com/ManageIQ/awesome_spawn.png)](https://gemnasium.com/ManageIQ/awesome_spawn)
+
+AwesomeSpawn is a module that provides some useful features over Ruby's Kernel.spawn.
+
+Some additional features include...
+
+- Parameter passing as a Hash or associative Array sanitizing them to prevent command line injection.
+- Results returned as an object giving access to the output stream, error stream, and exit status.
+- Optionally raising an exception when exit status is not 0.
+
+## Usage
+
+See the [YARD documentation](http://rubydoc.info/gems/awesome_spawn)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'awesome_spawn'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install awesome_spawn
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+task :test => :spec
+task :default => :spec

data/awesome_spawn.gemspec

@@ -0,0 +1,34 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'awesome_spawn/version'
+
+Gem::Specification.new do |spec|
+  authors = {
+    "Jason Frey"     => "jfrey@redhat.com",
+    "Brandon Dunne"  => "bdunne@redhat.com",
+    "Joe Rafaniello" => "jrafanie@redhat.com",
+    "Mo Morsi"       => "mmorsi@redhat.com"
+  }
+
+  spec.name          = "awesome_spawn"
+  spec.version       = AwesomeSpawn::VERSION
+  spec.authors       = authors.keys
+  spec.email         = authors.values
+  spec.description   = %q{AwesomeSpawn is a module that provides some useful features over Ruby's Kernel.spawn.}
+  spec.summary       = spec.description
+  spec.homepage      = "https://github.com/ManageIQ/awesome_spawn"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "coveralls"
+  spec.add_development_dependency "yard"
+  spec.add_development_dependency "redcarpet"
+end

data/lib/awesome_spawn.rb

@@ -0,0 +1,174 @@
+require "awesome_spawn/version"
+require "awesome_spawn/command_result"
+require "awesome_spawn/command_result_error"
+require "awesome_spawn/no_such_file_error"
+
+require "shellwords"
+
+module AwesomeSpawn
+  extend self
+
+  # Execute `command` synchronously via Kernel.spawn and gather the output
+  #   stream, error stream, and exit status in a {CommandResult}.
+  #
+  # @example With normal output
+  #   result = AwesomeSpawn.run('echo Hi')
+  #   # => #<AwesomeSpawn::CommandResult:0x007f9d1d197320 @exit_status=0>
+  #   result.output       # => "Hi\n"
+  #   result.error        # => ""
+  #   result.exit_status  # => 0
+  #
+  # @example With error output as well
+  #   result = AwesomeSpawn.run('echo Hi; echo "Hi2" 1>&2')
+  #   # => <AwesomeSpawn::CommandResult:0x007ff64b98d930 @exit_status=0>
+  #   result.output       # => "Hi\n"
+  #   result.error        # => "Hi2\n"
+  #   result.exit_status  # => 0
+  #
+  # @example With exit status that is not 0
+  #   result = AwesomeSpawn.run('false')
+  #   #<AwesomeSpawn::CommandResult:0x007ff64b971410 @exit_status=1>
+  #   result.exit_status  # => 1
+  #
+  # @example With parameters sanitized
+  #   result = AwesomeSpawn.run('echo', :params => {"--out" => "; rm /some/file"})
+  #   # => #<AwesomeSpawn::CommandResult:0x007ff64baa6650 @exit_status=0>
+  #   result.command_line
+  #   # => "echo --out \\;\\ rm\\ /some/file"
+  #
+  # @param [String] command The command to run
+  # @param [Hash] options The options for running the command
+  # @option options [Hash,Array] :params The command line parameters. See
+  #   {#build_command_line} for how to specify params. Alternate key
+  #   `:parameters`.
+  # @option options [String] :chdir see the `:chdir` parameter for Kernel.spawn
+  #
+  # @raise [NoSuchFileError] if the `command` is not found
+  # @return [CommandResult] the output stream, error stream, and exit status
+  # @see http://ruby-doc.org/core/Kernel.html#method-i-spawn Kernel.spawn
+  def run(command, options = {})
+    params = options[:params] || options[:parameters]
+
+    launch_params = {}
+    launch_params[:chdir] = options[:chdir] if options[:chdir]
+
+    output        = ""
+    error         = ""
+    status        = nil
+    command_line  = build_command_line(command, params)
+
+    begin
+      output, error = launch(command_line, launch_params)
+      status = exitstatus
+    ensure
+      output ||= ""
+      error  ||= ""
+      self.exitstatus = nil
+    end
+  rescue Errno::ENOENT => err
+    raise NoSuchFileError.new(err.message) if NoSuchFileError.detected?(err.message)
+    raise
+  else
+    CommandResult.new(command_line, output, error, status)
+  end
+
+  # Same as {#run}, additionally raising a {CommandResultError} if the exit
+  #   status is not 0.
+  #
+  # @example With exit status that is not 0
+  #   error = AwesomeSpawn.run!('false') rescue $!
+  #   # => #<AwesomeSpawn::CommandResultError: false exit code: 1>
+  #   error.message # => false exit code: 1
+  #   error.result  # => #<AwesomeSpawn::CommandResult:0x007ff64ba08018 @exit_status=1>
+  #
+  # @raise [CommandResultError] if the exit status is not 0.
+  # @return (see #run)
+  def run!(command, options = {})
+    command_result = run(command, options)
+
+    if command_result.exit_status != 0
+      message = "#{command} exit code: #{command_result.exit_status}"
+      raise CommandResultError.new(message, command_result)
+    end
+
+    command_result
+  end
+
+  # Build the full command line.
+  #
+  # @param [String] command The command to run
+  # @param [Hash,Array] params Optional command line parameters. They can
+  #   be passed as a Hash or associative Array. The values are sanitized to
+  #   prevent command line injection.
+  #
+  #   - `{"--key" => "value"}`         generates `--key value`
+  #   - `{"--key=" => "value"}`        generates `--key=value`
+  #   - `{"--key" => nil}`             generates `--key`
+  #   - `{"-f" => ["file1", "file2"]}` generates `-f file1 file2`
+  #   - `{nil => ["file1", "file2"]}`  generates `file1 file2`
+  #
+  # @return [String] The full command line
+  def build_command_line(command, params = nil)
+    return command.to_s if params.nil? || params.empty?
+    "#{command} #{assemble_params(sanitize(params))}"
+  end
+
+  private
+
+  def sanitize(params)
+    return [] if params.nil? || params.empty?
+    params.collect do |k, v|
+      v = case v
+          when Array;    v.collect {|i| i.to_s.shellescape}
+          when NilClass; v
+          else           v.to_s.shellescape
+          end
+      [k, v]
+    end
+  end
+
+  def assemble_params(sanitized_params)
+    sanitized_params.collect do |pair|
+      pair_joiner = pair.first.to_s.end_with?("=") ? "" : " "
+      pair.flatten.compact.join(pair_joiner)
+    end.join(" ")
+  end
+
+  # IO pipes have a maximum size of 64k before blocking,
+  # so we need to read and write synchronously.
+  # http://stackoverflow.com/questions/13829830/ruby-process-spawn-stdout-pipe-buffer-size-limit/13846146#13846146
+  THREAD_SYNC_KEY = "#{self.name}-exitstatus"
+
+  def launch(command, spawn_options = {})
+    out_r, out_w = IO.pipe
+    err_r, err_w = IO.pipe
+    pid = Kernel.spawn(command, {:err => err_w, :out => out_w}.merge(spawn_options))
+    wait_for_process(pid, out_w, err_w)
+    wait_for_pipes(out_r, err_r)
+  end
+
+  def wait_for_process(pid, out_w, err_w)
+    self.exitstatus = :not_done
+    Thread.new(Thread.current) do |parent_thread|
+      _, status = Process.wait2(pid)
+      out_w.close
+      err_w.close
+      parent_thread[THREAD_SYNC_KEY] = status.exitstatus
+    end
+  end
+
+  def wait_for_pipes(out_r, err_r)
+    out = out_r.read
+    err = err_r.read
+    sleep(0.1) while exitstatus == :not_done
+    return out, err
+  end
+
+  def exitstatus
+    Thread.current[THREAD_SYNC_KEY]
+  end
+
+  def exitstatus=(value)
+    Thread.current[THREAD_SYNC_KEY] = value
+  end
+end

data/lib/awesome_spawn/command_result.rb

@@ -0,0 +1,16 @@
+module AwesomeSpawn
+  class CommandResult
+    attr_reader :command_line, :output, :error, :exit_status
+
+    def initialize(command_line, output, error, exit_status)
+      @command_line = command_line
+      @output       = output
+      @error        = error
+      @exit_status  = exit_status
+    end
+
+    def inspect
+      "#{to_s.chop} @exit_status=#{@exit_status}>"
+    end
+  end
+end

data/lib/awesome_spawn/command_result_error.rb

@@ -0,0 +1,11 @@
+module AwesomeSpawn
+  class CommandResultError < StandardError
+    # @return [CommandResult] The command that caused the error
+    attr_reader :result
+
+    def initialize(message, result)
+      super(message)
+      @result = result
+    end
+  end
+end

data/lib/awesome_spawn/no_such_file_error.rb

@@ -0,0 +1,11 @@
+module AwesomeSpawn
+  class NoSuchFileError < Errno::ENOENT
+    def initialize(message)
+      super(message.split("No such file or directory -").last.split(" ").first)
+    end
+
+    def self.detected?(message)
+      message.start_with?("No such file or directory -")
+    end
+  end
+end

data/lib/awesome_spawn/version.rb

@@ -0,0 +1,3 @@
+module AwesomeSpawn
+  VERSION = "1.0.0"
+end

data/spec/awesome_spawn_spec.rb

@@ -0,0 +1,159 @@
+require 'spec_helper'
+require 'pathname' # For Pathname specific specs
+
+describe AwesomeSpawn do
+  subject { described_class }
+
+  let(:params) do
+    {
+      "--user"  => "bob",
+      "--pass"  => "P@$sw0^& |<>/-+*d%",
+      "--db"    => nil,
+      "--desc=" => "Some Description",
+      nil       => ["pkg1", "some pkg"]
+    }
+  end
+
+  let (:modified_params) do
+    params.to_a + [123, 456].collect {|pool| ["--pool", pool]}
+  end
+
+  shared_examples_for "run" do
+    context "parameters" do
+      before do
+        subject.stub(:exitstatus => 0)
+      end
+
+      it "won't modify caller params" do
+        orig_params = params.dup
+        subject.stub(:launch)
+        subject.send(run_method, "true", :params => params)
+        expect(orig_params).to eq(params)
+      end
+
+      it "supports spawn's chdir option" do
+        subject.should_receive(:launch).once.with("true", {:chdir => ".."})
+        subject.send(run_method, "true", :chdir => "..")
+      end
+    end
+
+    context "with real execution" do
+      before do
+        # Re-enable actual spawning just for these specs.
+        Kernel.stub(:spawn).and_call_original
+      end
+
+      it "command ok exit ok" do
+        expect(subject.send(run_method, "true")).to be_kind_of AwesomeSpawn::CommandResult
+      end
+
+      it "command ok exit bad" do
+        if run_method == "run!"
+          error = nil
+
+          # raise_error with do/end block notation is broken in rspec-expectations 2.14.x
+          # and has been fixed in master but not yet released.
+          # See: https://github.com/rspec/rspec-expectations/commit/b0df827f4c12870aa4df2f20a817a8b01721a6af
+          expect { subject.send(run_method, "false") }.to raise_error {|e| error = e }
+          expect(error).to be_kind_of AwesomeSpawn::CommandResultError
+          expect(error.result).to be_kind_of AwesomeSpawn::CommandResult
+        else
+          expect { subject.send(run_method, "false") }.to_not raise_error
+        end
+      end
+
+      it "command bad" do
+        expect { subject.send(run_method, "XXXXX --user=bob") }.to raise_error(Errno::ENOENT, "No such file or directory - XXXXX")
+      end
+
+      context "#exit_status" do
+        it "command ok exit ok" do
+          expect(subject.send(run_method, "true").exit_status).to eq(0)
+        end
+
+        it "command ok exit bad" do
+          expect(subject.send(run_method, "false").exit_status).to eq(1) if run_method == "run"
+        end
+      end
+
+      context "#output" do
+        it "command ok exit ok" do
+          expect(subject.send(run_method, "echo \"Hello World\"").output).to eq("Hello World\n")
+        end
+
+        it "command ok exit bad" do
+          expect(subject.send(run_method, "echo 'bad' && false").output).to eq("bad\n") if run_method == "run"
+        end
+      end
+
+      context "#error" do
+        it "command ok exit ok" do
+          expect(subject.send(run_method, "echo \"Hello World\" >&2").error).to eq("Hello World\n")
+        end
+
+        it "command ok exit bad" do
+          expect(subject.send(run_method, "echo 'bad' >&2 && false").error).to eq("bad\n") if run_method == "run"
+        end
+      end
+    end
+  end
+
+  context ".run" do
+    include_examples "run" do
+      let(:run_method) {"run"}
+    end
+  end
+
+  context ".run!" do
+    include_examples "run" do
+      let(:run_method) {"run!"}
+    end
+  end
+
+  context ".build_command_line" do
+    it "sanitizes crazy params" do
+      cl = subject.build_command_line("true", modified_params)
+      expect(cl).to eq "true --user bob --pass P@\\$sw0\\^\\&\\ \\|\\<\\>/-\\+\\*d\\% --db --desc=Some\\ Description pkg1 some\\ pkg --pool 123 --pool 456"
+    end
+
+    it "sanitizes Fixnum array param value" do
+      cl = subject.build_command_line("true", nil => [1])
+      expect(cl).to eq "true 1"
+    end
+
+    it "sanitizes Pathname param value" do
+      cl = subject.build_command_line("true", nil => [Pathname.new("/usr/bin/ruby")])
+      expect(cl).to eq "true /usr/bin/ruby"
+    end
+
+    it "sanitizes Pathname param key" do
+      cl = subject.build_command_line("true", Pathname.new("/usr/bin/ruby") => nil)
+      expect(cl).to eq "true /usr/bin/ruby"
+    end
+
+    it "with params as empty Hash" do
+      cl = subject.build_command_line("true", {})
+      expect(cl).to eq "true"
+    end
+
+    it "with params as nil" do
+      cl = subject.build_command_line("true", nil)
+      expect(cl).to eq "true"
+    end
+
+    it "without params" do
+      cl = subject.build_command_line("true")
+      expect(cl).to eq "true"
+    end
+
+    it "with Pathname command" do
+      cl = subject.build_command_line(Pathname.new("/usr/bin/ruby"))
+      expect(cl).to eq "/usr/bin/ruby"
+    end
+
+    it "with Pathname command and params" do
+      cl = subject.build_command_line(Pathname.new("/usr/bin/ruby"), "-v" => nil)
+      expect(cl).to eq "/usr/bin/ruby -v"
+    end
+  end
+end

data/spec/command_result_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe AwesomeSpawn::CommandResult do
+  context "#inspect" do
+    it "will not display sensitive information" do
+      str = described_class.new("aaa", "bbb", "ccc", 0).inspect
+
+      expect(str.include?("aaa")).to be_false
+      expect(str.include?("bbb")).to be_false
+      expect(str.include?("ccc")).to be_false
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,26 @@
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# Require this file using `require "spec_helper"` to ensure that it is only
+# loaded once.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+  config.run_all_when_everything_filtered = true
+  config.filter_run :focus
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = 'random'
+
+  config.before do
+    Kernel.stub(:spawn).and_raise("Spawning is not permitted in specs.  Please change your spec to use expectations/stubs.")
+  end
+end
+
+require 'coveralls'
+Coveralls.wear!
+
+require 'awesome_spawn'

metadata

@@ -0,0 +1,176 @@
+--- !ruby/object:Gem::Specification
+name: awesome_spawn
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Jason Frey
+- Brandon Dunne
+- Joe Rafaniello
+- Mo Morsi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !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: rspec
+  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: coveralls
+  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: yard
+  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: redcarpet
+  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'
+description: AwesomeSpawn is a module that provides some useful features over Ruby's
+  Kernel.spawn.
+email:
+- jfrey@redhat.com
+- bdunne@redhat.com
+- jrafanie@redhat.com
+- mmorsi@redhat.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- awesome_spawn.gemspec
+- lib/awesome_spawn.rb
+- lib/awesome_spawn/command_result.rb
+- lib/awesome_spawn/command_result_error.rb
+- lib/awesome_spawn/no_such_file_error.rb
+- lib/awesome_spawn/version.rb
+- spec/awesome_spawn_spec.rb
+- spec/command_result_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/ManageIQ/awesome_spawn
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1223152174146401530
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1223152174146401530
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: AwesomeSpawn is a module that provides some useful features over Ruby's Kernel.spawn.
+test_files:
+- spec/awesome_spawn_spec.rb
+- spec/command_result_spec.rb
+- spec/spec_helper.rb
+has_rdoc: