philiprehberger-task_runner 0.6.0 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 81a304bf73bc20e70f8bb340125ed6cbc3add80df788e746909341cdbcac85a4
-  data.tar.gz: 46e8d6a93c2f3501142a9a4c330a8686e0d91edfd2c3bcd2674508075d563c34
+  metadata.gz: dddebb2a9f61387b45cc9650f3d695c07be69388f6d2b988f551326b5cfba973
+  data.tar.gz: 2d53404bcb1eb3fbbb941091d8c7b4a4e68515fe224c6891b0473c9a609d0773
 SHA512:
-  metadata.gz: 83345dc31740a6618be9d21078c0b0640ba04bb54b08d457e67fc0df37786e2c8f86b316355ffd558bf1470967e71aa54575a4f98a2b75acaf8731059b8fbf52
-  data.tar.gz: 304a3c5de5afd3a41e61dd9e127dc8fabecf546743a22900df0486ad95a768f7112f3713f8f4de9747080a31a0e0563a2c3d67b547a3cd6eefbc9f32b0e9ea83
+  metadata.gz: b8d1d3691823020fdd69b5d7642fe61d26415c654f6d26d3069755aa4ee95e09a8fa3f7bd34ffc9fb004d67366c7806a297aa4a7890251a7cce421c9e70ae3f4
+  data.tar.gz: 5a0123b5b514d3d07b1d9ade8e02137a92773564253f2fc7331531de844190ff3f921e732c794fd0b5d8c86c1d393baed9281d0d4fe8342c7716d8c00333fd71

data/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-05-20
+
+### Added
+- `Result#parse_json` — parse stdout as JSON, raising `Philiprehberger::TaskRunner::ParseError` (new) when stdout is empty or not valid JSON
+- `Result#json?` — predicate for safely probing whether stdout is parseable JSON
+- Card image reference in the README for registry-side rendering
+
 ## [0.6.0] - 2026-04-28
 
 ### Added

data/README.md

@@ -4,6 +4,8 @@
 [![Gem Version](https://badge.fury.io/rb/philiprehberger-task_runner.svg)](https://rubygems.org/gems/philiprehberger-task_runner)
 [![Last updated](https://img.shields.io/github/last-commit/philiprehberger/rb-task-runner)](https://github.com/philiprehberger/rb-task-runner/commits/main)
 
+![philiprehberger-task_runner](https://raw.githubusercontent.com/philiprehberger/rb-task-runner/main/package-card.webp)
+
 Shell command runner with output capture, timeout, streaming, signal handling, and stdin piping
 
 ## Requirements
@@ -134,6 +136,24 @@ Philiprehberger::TaskRunner.run('make', 'build') do |line, stream|
 end
 ```
 
+### Parsing JSON Output
+
+```ruby
+result = Philiprehberger::TaskRunner.run('kubectl', 'get', 'pod', 'web', '-o', 'json')
+
+if result.json?
+  doc = result.parse_json
+  doc['status']['phase']  # => "Running"
+end
+
+# parse_json raises ParseError when stdout isn't valid JSON
+begin
+  result.parse_json
+rescue Philiprehberger::TaskRunner::ParseError => e
+  warn "command did not return JSON: #{e.message}"
+end
+```
+
 ## API
 
 | Method / Class | Description |
@@ -153,6 +173,8 @@ end
 | `Result#duration` | Execution time in seconds |
 | `Result#signal` | Signal that killed the process (:TERM, :KILL, or nil) |
 | `Result#timed_out?` | Whether the process was killed for exceeding its timeout |
+| `Result#json?` | Whether stdout contains a parseable JSON document |
+| `Result#parse_json` | Parse stdout as JSON; raises `ParseError` on invalid or empty stdout |
 | `Result#to_h` | Hash representation of the result (includes `:success` and `:timed_out`) |
 
 ## Development

data/lib/philiprehberger/task_runner/result.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'json'
+
 module Philiprehberger
   module TaskRunner
     # Represents the result of a shell command execution.
@@ -55,6 +57,31 @@ module Philiprehberger
         %i[TERM KILL].include?(@signal)
       end
 
+      # Whether stdout contains a parseable JSON document.
+      # Empty stdout is treated as non-JSON.
+      #
+      # @return [Boolean]
+      def json?
+        return false if @stdout.nil? || @stdout.strip.empty?
+
+        JSON.parse(@stdout)
+        true
+      rescue JSON::ParserError
+        false
+      end
+
+      # Parse stdout as JSON.
+      #
+      # @return [Object] the parsed JSON document (Hash, Array, String, Numeric, true, false, or nil)
+      # @raise [ParseError] if stdout is empty or not valid JSON
+      def parse_json
+        raise ParseError, 'stdout is empty' if @stdout.nil? || @stdout.strip.empty?
+
+        JSON.parse(@stdout)
+      rescue JSON::ParserError => e
+        raise ParseError, "stdout is not valid JSON: #{e.message}"
+      end
+
       # Hash representation of the result.
       #
       # @return [Hash]

data/lib/philiprehberger/task_runner/version.rb

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

data/lib/philiprehberger/task_runner.rb

@@ -11,6 +11,9 @@ module Philiprehberger
     class Error < StandardError; end
     class TimeoutError < Error; end
 
+    # Raised by Result#parse_json when the stdout cannot be parsed as JSON.
+    class ParseError < Error; end
+
     # Raised by run! when the command exits with a non-zero status.
     class CommandError < Error
       # @return [Result] the failed command result

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: philiprehberger-task_runner
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - Philip Rehberger
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-04-29 00:00:00.000000000 Z
+date: 2026-05-20 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