philiprehberger-task_runner 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1e264781c1fb8c863a53e85b4d6b80f4bc1644a27bbeb17446473719d5efc10c
-  data.tar.gz: d7b4719dab1483d43ec494ac3aa00718ecfd6d408b9241c21cbbd7695e4bce2d
+  metadata.gz: 81a304bf73bc20e70f8bb340125ed6cbc3add80df788e746909341cdbcac85a4
+  data.tar.gz: 46e8d6a93c2f3501142a9a4c330a8686e0d91edfd2c3bcd2674508075d563c34
 SHA512:
-  metadata.gz: 8ea18413fb9724653c6621d57f24af1384567aa5361ea3ae4d9ba165f97d5685644d8b45c2ad2cc9e2537db2e9e19f223b4983c94bd2514640c325c8422a46dd
-  data.tar.gz: bd148577cae30e1bb877622f60cdfda40887bee65653a5568c6b6faa420f37cf38bfe95d6d8317508a7a6502c3c67395a242218f6731d16227d338266131c862
+  metadata.gz: 83345dc31740a6618be9d21078c0b0640ba04bb54b08d457e67fc0df37786e2c8f86b316355ffd558bf1470967e71aa54575a4f98a2b75acaf8731059b8fbf52
+  data.tar.gz: 304a3c5de5afd3a41e61dd9e127dc8fabecf546743a22900df0486ad95a768f7112f3713f8f4de9747080a31a0e0563a2c3d67b547a3cd6eefbc9f32b0e9ea83

data/CHANGELOG.md

@@ -7,6 +7,11 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-04-28
+
+### Added
+- `TaskRunner.which(cmd)` — absolute path of an executable on `PATH`, or `nil` when not found. Honors `ENV['PATHEXT']` on Windows. Raises `ArgumentError` for nil/empty input.
+
 ## [0.5.0] - 2026-04-21
 
 ### Added

data/README.md

@@ -60,6 +60,22 @@ if Philiprehberger::TaskRunner.run?('which', 'git')
 end
 ```
 
+### Which
+
+Locate an executable on `PATH` (like the `which` shell builtin). Returns the
+absolute path or `nil` when not found:
+
+```ruby
+Philiprehberger::TaskRunner.which("git")
+# => "/usr/bin/git"
+
+Philiprehberger::TaskRunner.which("definitely-not-installed")
+# => nil
+```
+
+On Windows, candidate suffixes from `ENV["PATHEXT"]` (`.COM`, `.EXE`,
+`.BAT`, `.CMD`) are tried automatically.
+
 ### Timeout
 
 ```ruby
@@ -125,6 +141,7 @@ end
 | `.run(cmd, *args, timeout:, env:, chdir:, signal:, kill_after:, stdin:)` | Run a command and return a Result |
 | `.run!(cmd, *args, **opts)` | Same as `run`, raises `CommandError` on non-zero exit |
 | `.run?(cmd, *args, **opts)` | Boolean shortcut — true only when exit code is 0; timeouts return false |
+| `.which(cmd)` | Absolute path of `cmd` on PATH (or `nil`); honors `PATHEXT` on Windows |
 | `CommandError#result` | The failed `Result` object |
 | `.run(cmd) { \|line\| ... }` | Run with line-by-line stdout streaming |
 | `.run(cmd) { \|line, stream\| ... }` | Run with stdout and stderr streaming |

data/lib/philiprehberger/task_runner/version.rb

@@ -2,6 +2,6 @@
 
 module Philiprehberger
   module TaskRunner
-    VERSION = '0.5.0'
+    VERSION = '0.6.0'
   end
 end

data/lib/philiprehberger/task_runner.rb

@@ -81,6 +81,37 @@ module Philiprehberger
       false
     end
 
+    # Find the absolute path of an executable on PATH.
+    #
+    # Behaves like the `which` shell builtin: walks each entry in
+    # `ENV['PATH']` and returns the first directory that contains an
+    # executable file matching `cmd`. On Windows, also tries each suffix in
+    # `ENV['PATHEXT']`. Returns `nil` when nothing is found.
+    #
+    # @param cmd [String] the executable name to search for
+    # @return [String, nil] the absolute path, or nil when not found
+    # @raise [ArgumentError] if `cmd` is nil or empty
+    def self.which(cmd)
+      raise ArgumentError, 'cmd cannot be nil or empty' if cmd.nil? || cmd.to_s.empty?
+
+      exts = if Gem.win_platform?
+               (ENV['PATHEXT'] || '.COM;.EXE;.BAT;.CMD').split(';')
+             else
+               ['']
+             end
+
+      ENV.fetch('PATH', '').split(File::PATH_SEPARATOR).each do |dir|
+        next if dir.empty?
+
+        exts.each do |ext|
+          candidate = File.join(dir, "#{cmd}#{ext}")
+          return File.expand_path(candidate) if File.file?(candidate) && File.executable?(candidate)
+        end
+      end
+
+      nil
+    end
+
     # @api private
     def self.run_capture(env_hash, full_cmd, spawn_opts, timeout, start_time, signal, kill_after, stdin_data)
       stdout_buf = +''

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-task_runner
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-21 00:00:00.000000000 Z
+date: 2026-04-29 00:00:00.000000000 Z
 dependencies: []
 description: Run shell commands with captured stdout/stderr, exit code, duration measurement,
   configurable timeout, environment variables, line-by-line streaming, graceful signal