subprocess 0.16 → 1.0.0

data/lib/subprocess.rb

@@ -1,6 +1,8 @@
 require 'thread'
 require 'set'
 
+require 'subprocess/version'
+
 # A Ruby clone of Python's subprocess module.
 #
 # @see http://docs.python.org/2/library/subprocess.html
@@ -86,6 +88,59 @@ module Subprocess
     output
   end
 
+  # Print a human readable interpretation of a process exit status.
+  #
+  # @param [::Process::Status] status The status returned by `waitpid2`.
+  # @param [Boolean] convert_high_exit Whether to convert exit statuses greater
+  #   than 128 into the usual convention for exiting after trapping a signal.
+  #   (e.g. many programs will exit with status 130 after receiving a SIGINT /
+  #   signal 2.)
+  # @return [String] Text interpretation
+  #
+  def self.status_to_s(status, convert_high_exit=true)
+
+    # use an array just in case we somehow get a status with all the bits set
+    parts = []
+    if status.exited?
+      parts << "exited with status #{status.exitstatus}"
+      if convert_high_exit && status.exitstatus > 128
+        # convert high exit statuses into what the original signal may have
+        # been according to the usual exit status convention
+        sig_num = status.exitstatus - 128
+
+        # sigh, why is ruby so silly
+        begin
+          # ruby 2.0 way
+          sig_name = Signal.signame(sig_num)
+        rescue NoMethodError
+          begin
+            # ruby 1.9 way
+            sig_name = Signal.list.key(sig_num)
+          rescue NoMethodError
+            # ruby 1.8 way
+            sig_name = Signal.list.index(sig_num)
+          end
+        end
+
+        if sig_name
+          parts << "(maybe SIG#{sig_name})"
+        end
+      end
+    end
+    if status.signaled?
+      parts << "killed by signal #{status.termsig}"
+    end
+    if status.stopped?
+      parts << "stopped by signal #{status.stopsig}"
+    end
+
+    if parts.empty?
+      raise ArgumentError.new("Don't know how to interpret #{status.inspect}")
+    end
+
+    parts.join(', ')
+  end
+
   # Error class representing a process's abnormal exit.
   class NonZeroExit < StandardError
     # @!attribute [r] command

data/lib/subprocess/version.rb

@@ -0,0 +1,3 @@
+module Subprocess
+  VERSION = '1.0.0'
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: subprocess
 version: !ruby/object:Gem::Version
-  version: '0.16'
+  version: 1.0.0
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-09-30 00:00:00.000000000 Z
+date: 2013-10-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
@@ -31,6 +31,38 @@ dependencies:
     - - ~>
       - !ruby/object:Gem::Version
         version: '5.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: 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'
 description: Control and communicate with spawned processes
 email:
 - carl@stripe.com
@@ -43,6 +75,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - lib/subprocess.rb
+- lib/subprocess/version.rb
 - README.md
 homepage: https://github.com/stripe/subprocess
 licenses:
@@ -57,12 +90,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 84211792966870882
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
+      segments:
+      - 0
+      hash: 84211792966870882
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.23
@@ -70,4 +109,3 @@ signing_key:
 specification_version: 3
 summary: A port of Python's subprocess module to Ruby
 test_files: []
-has_rdoc: