process_executer 4.0.1 → 4.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 687f18ede55ff847d1adf1bb95181187802991ae836ddb6523075a36e5d427d9
-  data.tar.gz: a2669455cb3a8bf7a1b5c9c585fba17b87e915005f1ff40dcd8057ce9e54ea39
+  metadata.gz: a033cd4abe84b2a664cb59bd5a3110302a478d871e096ecde3031fc76278f324
+  data.tar.gz: 5de784c728d11852efac17fb035e15e9e3c2f35ff36e402f260cf011a3ce55b8
 SHA512:
-  metadata.gz: 4502a3a3e144865a7f850541ebbf309b026f18410c740b1697cc5542a56e421e0ca4f513a40c992275d15e2a58599cfe8e8828102d7c3e49987f1ac403143eed
-  data.tar.gz: 40d2522f4ba8d09faf0b1faa421faaa6273aed44f0de40df8426d69d06a1e01d7565dd75367e28f904c49d948b7fe660848485b92224e6fdb7a61edad745ce32
+  metadata.gz: 0c5b2ae5438c7c263b1105b8e6a5d4ecf18b0836a5cc1a376b610fae3adbee123f851b8357b5113ff1bb35af5048af08f9a2d0b1ac50bc89a7234b2480727c9e
+  data.tar.gz: d29494c96b22e31e994a880d7a3c514c7e13d08d695e41794ed2609f76048dc2e4c8a995d48eb5babe8f5da27a9649dce5198baf09c35828a40547bba149c382

data/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "4.0.1"
+  ".": "4.0.2"
 }

data/CHANGELOG.md

@@ -5,6 +5,17 @@ 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).
 
+## [4.0.2](https://github.com/main-branch/process_executer/compare/v4.0.1...v4.0.2) (2026-01-03)
+
+
+### Other Changes
+
+* Bump actions/checkout@v5 and actions/setup-java@v5 ([07c6488](https://github.com/main-branch/process_executer/commit/07c6488b21305cbffb059c181e7720868781ddd4))
+* Fix process spawn workflow link ([316fdeb](https://github.com/main-branch/process_executer/commit/316fdebce530b2be5ceb5046e21ee848af52381a))
+* Run process-spawn specs under bash on Windows ([320ceb0](https://github.com/main-branch/process_executer/commit/320ceb0395c85bb40b1706efb0c6e71f50a20d06))
+* Run process-spawn tests from subdirectory ([ef8b968](https://github.com/main-branch/process_executer/commit/ef8b968b0cc8ff6b8d1ea051ff5836fcaf65ff7e))
+* Update Ruby version support policy ([0df371d](https://github.com/main-branch/process_executer/commit/0df371d004da62ed3bcb6685aba53d62d7061d02))
+
 ## [4.0.1](https://github.com/main-branch/process_executer/compare/v4.0.0...v4.0.1) (2025-12-29)
 
 

data/README.md

@@ -20,15 +20,8 @@ RubyGems.org. Go to the [process_executer page in
 RubyGems.org](https://rubygems.org/gems/process_executer), select your version, and
 then click the "Documentation" link.
 
-## Requirements
-
-- Ruby 3.1.0 or later
-- Compatible with MRI 3.1+, TruffleRuby 24+, and JRuby 9.4+
-- Works on Mac, Linux, and Windows platforms
-
 ## Table of contents
 
-- [Requirements](#requirements)
 - [Table of contents](#table-of-contents)
 - [Usage](#usage)
   - [Key methods](#key-methods)
@@ -36,6 +29,7 @@ then click the "Documentation" link.
   - [Encoding](#encoding)
     - [Encoding summary](#encoding-summary)
     - [Encoding details](#encoding-details)
+- [Ruby version support policy](#ruby-version-support-policy)
 - [Breaking Changes](#breaking-changes)
   - [2.x](#2x)
     - [`ProcessExecuter.spawn`](#processexecuterspawn)
@@ -199,6 +193,28 @@ These encoding options ONLY affect the internally captured stdout and stderr for
 will result in BINARY encoded strings and you will need to handle setting the right
 encoding or transcoding after collecting the output.
 
+## Ruby version support policy
+
+This gem will be expected to function correctly on:
+
+- All [non-EOL versions](https://www.ruby-lang.org/en/downloads/branches/) of the MRI
+  Ruby on Mac, Linux, and Windows
+- The latest version of JRuby 9.4+ on Linux
+- The latest version of TruffleRuby 24+ on Linux
+
+It is this project's intent to support the latest version of JRuby on Windows once
+Process.wait2 and Process.wait work correctly on this platform.
+
+Currently, JRuby on Windows does not capture and report the subprocess status via $?
+(or $CHILD_STATUS), Process.wait, or Process.wait2. These values always return `nil`
+for the status, preventing this gem from properly detecting command failures and
+timeouts.
+
+This repository includes a separate test suite in the `process_spawn_test/` directory
+that specifically validates JRuby's subprocess behavior. The [Process Spawn Test
+workflow](https://github.com/main-branch/process_executer/actions/workflows/process-spawn-test.yml)
+can be run manually to verify the status of this issue.
+
 ## Breaking Changes
 
 ### 2.x

data/lib/process_executer/version.rb

@@ -3,5 +3,5 @@
 module ProcessExecuter
   # The current Gem version
   # @return [String]
-  VERSION = '4.0.1'
+  VERSION = '4.0.2'
 end

data/process_spawn_test/.rspec

@@ -0,0 +1,3 @@
+--require spec_helper.rb
+--color
+--format documentation

data/process_spawn_test/README.md

@@ -0,0 +1,36 @@
+# Process Spawn Test
+
+These tests verify that `Process.spawn`, `Process.wait`, and `Process.wait2` work
+correctly across different Ruby implementations and operating systems.
+
+This test suite is particularly important for verifying JRuby behavior on Windows,
+where historically there have been issues with subprocess status reporting.
+
+## Tests
+
+The test suite includes:
+
+* Test that `Process#wait` sets the global `$CHILD_STATUS` variable
+* Test that `Process#wait2` returns a non-nil status
+
+## Running the Tests
+
+There is no Gemfile in `process_spawn_test/`, so bundler walks up to the repo root and uses the main project's Gemfile. From the repository root:
+
+```bash
+cd process_spawn_test && bundle exec rspec
+```
+
+Alternatively, you can stay at the root and run:
+
+```bash
+bundle exec rspec process_spawn_test/spec/test_spec.rb
+```
+
+## GitHub Actions Workflow
+
+The workflow file `.github/workflows/process-spawn-test.yml` can be manually triggered to run these tests on:
+- MRI Ruby and JRuby
+- Ubuntu (Linux) and Windows
+
+To run the workflow, go to the Actions tab in GitHub and select "Process.spawn Test" from the workflow list.

data/process_spawn_test/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'rspec'
+
+RSpec.configure do |config|
+  # Enable flags like --only-failures and --next-failure
+  config.example_status_persistence_file_path = '.rspec_status'
+
+  # Disable RSpec exposing methods globally on `Module` and `main`
+  config.disable_monkey_patching!
+
+  config.expect_with :rspec do |c|
+    c.syntax = :expect
+  end
+end

data/process_spawn_test/spec/test_spec.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require 'English'
+
+RSpec.describe 'Process#wait' do
+  it 'sets the global $CHILD_STATUS variable' do
+    pid = Process.spawn('ruby', '-e', 'exit 0')
+    Process.wait(pid)
+    expect($CHILD_STATUS).not_to be_nil
+    expect($CHILD_STATUS.pid).to eq(pid)
+  end
+end
+
+RSpec.describe 'Process#wait2' do
+  it 'returns a non-nil status' do
+    pid = Process.spawn('ruby', '-e', 'exit 0')
+    _pid, status = Process.wait2(pid)
+    expect(status).not_to be_nil
+    expect(status.pid).to eq(pid)
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: process_executer
 version: !ruby/object:Gem::Version
-  version: 4.0.1
+  version: 4.0.2
 platform: ruby
 authors:
 - James Couball
@@ -281,6 +281,10 @@ files:
 - lib/process_executer/version.rb
 - package.json
 - process_executer.gemspec
+- process_spawn_test/.rspec
+- process_spawn_test/README.md
+- process_spawn_test/spec/spec_helper.rb
+- process_spawn_test/spec/test_spec.rb
 - release-please-config.json
 homepage: https://github.com/main-branch/process_executer
 licenses:
@@ -289,8 +293,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
-  documentation_uri: https://rubydoc.info/gems/process_executer/4.0.1
-  changelog_uri: https://rubydoc.info/gems/process_executer/4.0.1/file/CHANGELOG.md
+  documentation_uri: https://rubydoc.info/gems/process_executer/4.0.2
+  changelog_uri: https://rubydoc.info/gems/process_executer/4.0.2/file/CHANGELOG.md
   rubygems_mfa_required: 'true'
 rdoc_options: []
 require_paths: