process_executer 1.0.2 → 1.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05077fa5757c373b7587a35c2f32aaa3deeaa5708845ec5db485fccb4f29bc5c
-  data.tar.gz: 9b1fda5d3669f6f09100e2b4b47ec8905d8448632cbd1998af0e606d724967cf
+  metadata.gz: 5d476a9c88bc9491b887b5a5507dd2288f1aadf1b4735c8c15b790dbbfa423f9
+  data.tar.gz: 763c100ce03c3f625e323fefcdafe3788300c51429296110a5aa9222eb05d039
 SHA512:
-  metadata.gz: 6f48795cd44788c27a9931a1960e9d5f83d72ab794fd37d5d24b0a3110a1582211f80cdeef4e8cd171183f3ef9ccfec615f60fda46dd480cdaed10856d69a373
-  data.tar.gz: 54b9a282d8dc8d0ebca8e5e2b1368a0040ec140c5a793d438fe4891363d74574b31541d9d22aea566f09f8b3284cb7d12c49f071f9dca3cd29bbcd8df9babfbe
+  metadata.gz: f27eebdee1a46bac93ecfa8c78d29feba3ebb2c833d53dda7cd3213ee43c441994f50e0317592898a31d0eff42ca3a83cc3e3ad201d746fd641c7de9d3d9d762
+  data.tar.gz: 1e303f09b81b1605cfef527b41fbfc52f8e247a10c5ad3af1bed944bab2d6cf839eac9850b1b1c6038d73549abd1e7d0cef18de3dc081930f8d764512a3adc43

data/.tool-versions

@@ -1 +1 @@
-ruby 3.0.5
+ruby 3.3.5

data/CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to the process_executer gem will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## v1.1.1 (2024-09-25)
+
+[Full Changelog](https://github.com/main-branch/process_executer/compare/v1.1.0..v1.1.1)
+
+Changes since v1.1.0:
+
+* c3f063a Use a later version of ruby for development
+* d4eeb1e Use latest version of the actions/checkout to v4
+* eb4dad7 Fix flakey test on  JRuby
+* ac9417a Update CI build to run on v1.x branch
+* 014e70f Remove unused require for 'forwardable' and 'ostruct' (for v1.x)
+
+## v1.1.0 (2024-02-02)
+
+[Full Changelog](https://github.com/main-branch/process_executer/compare/v1.0.2..v1.1.0)
+
+Changes since v1.0.2:
+
+* a473281 ProcessExecuter.spawn should indicate if the subprocess timed out or not (#43)
+
 ## v1.0.2 (2024-02-01)
 
 [Full Changelog](https://github.com/main-branch/process_executer/compare/v1.0.1..v1.0.2)

data/README.md

@@ -77,7 +77,15 @@ important behaviorial differences:
 2. A timeout can be specified using the `:timeout` option
 
 If the command does not terminate before the timeout, the process is killed by
-sending it the SIGKILL signal.
+sending it the SIGKILL signal. The returned status object's `timeout?` attribute will
+return `true`. For example:
+
+```ruby
+status = ProcessExecuter.spawn('sleep 10', timeout: 0.01)
+status.signaled? #=> true
+status.termsig #=> 9
+status.timeout? #=> true
+```
 
 ## Installation
 

data/lib/process_executer/options.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'forwardable'
-require 'ostruct'
 require 'pp'
 
 module ProcessExecuter

data/lib/process_executer/status.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require 'delegate'
+
+module ProcessExecuter
+  # A simple delegator for Process::Status that adds a `timeout?` attribute
+  #
+  # @api public
+  #
+  class Status < SimpleDelegator
+    extend Forwardable
+
+    # Create a new Status object from a Process::Status and timeout flag
+    #
+    # @param status [Process::Status] the status to delegate to
+    # @param timeout [Boolean] true if the process timed out
+    #
+    # @example
+    #   status = Process.wait2(pid).last
+    #   timeout = false
+    #   ProcessExecuter::Status.new(status, timeout)
+    #
+    # @api public
+    #
+    def initialize(status, timeout)
+      super(status)
+      @timeout = timeout
+    end
+
+    # @!attribute [r] timeout?
+    #
+    # True if the process timed out and was sent the SIGKILL signal
+    #
+    # @example
+    #   status = ProcessExecuter.spawn('sleep 10', timeout: 0.01)
+    #   status.timeout? # => true
+    #
+    # @return [Boolean]
+    #
+    # @api public
+    #
+    def timeout? = @timeout
+  end
+end

data/lib/process_executer/version.rb

@@ -2,5 +2,5 @@
 
 module ProcessExecuter
   # The current Gem version
-  VERSION = '1.0.2'
+  VERSION = '1.1.1'
 end

data/lib/process_executer.rb

@@ -2,6 +2,7 @@
 
 require 'process_executer/monitored_pipe'
 require 'process_executer/options'
+require 'process_executer/status'
 
 require 'timeout'
 
@@ -59,16 +60,16 @@ module ProcessExecuter
   # @param pid [Integer] the process id
   # @param options [ProcessExecuter::Options] the options used
   #
-  # @return [Process::Status] the status of the process
+  # @return [ProcessExecuter::Status] the status of the process
   #
   # @api private
   #
   private_class_method def self.wait_for_process(pid, options)
     Timeout.timeout(options.timeout) do
-      Process.wait2(pid).last
+      ProcessExecuter::Status.new(Process.wait2(pid).last, false)
     end
   rescue Timeout::Error
     Process.kill('KILL', pid)
-    Process.wait2(pid).last
+    ProcessExecuter::Status.new(Process.wait2(pid).last, true)
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: process_executer
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.1
 platform: ruby
 authors:
 - James Couball
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-02-02 00:00:00.000000000 Z
+date: 2024-09-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler-audit
@@ -190,6 +190,7 @@ files:
 - lib/process_executer.rb
 - lib/process_executer/monitored_pipe.rb
 - lib/process_executer/options.rb
+- lib/process_executer/status.rb
 - lib/process_executer/version.rb
 - process_executer.gemspec
 homepage: https://github.com/main-branch/process_executer
@@ -199,8 +200,8 @@ metadata:
   allowed_push_host: https://rubygems.org
   homepage_uri: https://github.com/main-branch/process_executer
   source_code_uri: https://github.com/main-branch/process_executer
-  changelog_uri: https://rubydoc.info/gems/process_executer/1.0.2/file/CHANGELOG.md
-  documentation_uri: https://rubydoc.info/gems/process_executer/1.0.2
+  changelog_uri: https://rubydoc.info/gems/process_executer/1.1.1/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/process_executer/1.1.1
   rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
@@ -217,7 +218,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.33
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: An API for executing commands in a subprocess