hiiro 0.1.343 → 0.1.345

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0b4a52f12f6b8206e79bc9c467c11523d8b6c09592e83ee88617133112ee60a
-  data.tar.gz: 3190f9942e4f705fb7b4de299ed992d0b0123e5d57c5e375a3476f0b018b4867
+  metadata.gz: e46cf30e0170d883a3b5dcf6e74e6cd922b344c71f58dd45d0b7d2ec05eefa41
+  data.tar.gz: 05db55a107104823401ce9b3a07a2437943d8250a5bdced2d0bfaa87c53cbd15
 SHA512:
-  metadata.gz: a6ce0e2c104da7509260220b5fc02162dde679457bc56012b704b17cb02ede55e51cd0e47f06b626ac40fd129b8f84991c0043e19523513e7012e11b4d8942b8
-  data.tar.gz: c1b053c3f8cac1f4af5433a64e217dfdc79c93dcf017eab287efbfeb1f2e90ea696012bb37da1a599aab43c069e309b6488c3cab530cdefbd7cfc0cf6c69dde7
+  metadata.gz: 576c57204f0e860d74068168bc8483af0a495e1afe7d562bb482142ea1af190c13c3958712978ffa1d0e36a5fdacca4c3bec201c9adbacec4918ba46679de2cd
+  data.tar.gz: 97a7acaf188780eef1ad9ca522e43111c19fde4ea17f1738fc7d54465617433a887c0b73b1390f481cd1606d41f9cac6c58dd42444afd56c66730206bd99fb00

data/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [0.1.345] - 2026-04-12
+
+### Fixed
+- ANSI escape sequence pattern now uses hex escapes (`\x20-\x2f`) instead of literal space-to-slash to avoid ambiguity with the `/` regex delimiter
+
 ## [0.1.343] - 2026-04-12
 
 ### Added

data/lib/hiiro/shell.rb

@@ -22,5 +22,120 @@ class Hiiro
 
       selected&.chomp
     end
+
+    def self.run(*command, **env)
+      env = env.transform_keys(&:to_s).transform_values(&:to_s)
+      stdout, status = Open3.capture2(env, *command)
+      Result.new(stdout, status)
+    end
+
+    def self.run_combined(*command, **env)
+      env = env.transform_keys(&:to_s).transform_values(&:to_s)
+      output, status = Open3.capture2e(env, *command)
+      Result.new(output, status)
+    end
+
+    def self.run3(*command, **env)
+      env = env.transform_keys(&:to_s).transform_values(&:to_s)
+      stdout, stderr, status = Open3.capture3(env, *command)
+      Result.new(stdout, status, stderr: stderr)
+    end
+
+    # Stream stdout live to $stdout as chunks arrive, buffering for Result.
+    # stderr passes through to the parent process (not captured).
+    #
+    # ~/bin/h-tds does this manually with popen2e for Chromatic:
+    #
+    #   Open3.popen2e('unbuffer pnpm chromatic') do |stdin, stdout_err, wait_thr|
+    #     stdin.close
+    #     loop do
+    #       chunk = stdout_err.readpartial(4096)
+    #       $stdout.write(chunk)
+    #       @output << chunk
+    #     rescue EOFError
+    #       break
+    #     end
+    #     @exit_status = wait_thr.value
+    #   end
+    #
+    # stream_combined replaces that pattern — stderr merged in, one Result back.
+    def self.stream(*command, tee: $stdout, **env)
+      env = env.transform_keys(&:to_s).transform_values(&:to_s)
+      Open3.popen2(env, *command) do |stdin, stdout, wait_thr|
+        stdin.close
+        return Result.collect_chunks(stdout, wait_thr, tee: tee)
+      end
+    end
+
+    def self.stream_combined(*command, tee: $stdout, **env)
+      env = env.transform_keys(&:to_s).transform_values(&:to_s)
+      Open3.popen2e(env, *command) do |stdin, stdout_err, wait_thr|
+        stdin.close
+        return Result.collect_chunks(stdout_err, wait_thr, tee: tee)
+      end
+    end
+  end
+
+  class Result
+    # Matches the full ANSI/VT100 escape sequence spec:
+    # cursor movement, erase, colors, SGR — everything a terminal interprets.
+    # [^[] catches all single-char Fe sequences (e.g. \eM, \eD); \[...] catches CSI.
+    # \x20-\x2f used instead of space-to-slash to avoid ambiguity with the / regex delimiter.
+    ANSI_PATTERN = /\e(?:\[[0-?]*[\x20-\x2f]*[@-~]|[^\[])/
+
+    attr_reader :stdout, :stderr, :status
+
+    def initialize(stdout, status, stderr: nil)
+      @stdout = stdout
+      @stderr = stderr
+      @status = status
+    end
+
+    def success?
+      status.success?
+    end
+
+    def failed?
+      !success?
+    end
+
+    def exit_code
+      status.exitstatus
+    end
+
+    # Replay buffered output to the terminal with ANSI sequences intact —
+    # colors, cursor movement, line clears all work as they did live.
+    # Returns self so you can chain: result.display.lines
+    def display(out: $stdout)
+      out.write(stdout)
+      out.flush
+      self
+    end
+
+    # Strip ANSI escape codes for text processing or filtering.
+    # Also strips bare \r (carriage-return-only, used by progress bars).
+    def plain_text
+      stdout.gsub(ANSI_PATTERN, '').gsub(/\r(?!\n)/, '')
+    end
+
+    # Plain text split into non-empty lines.
+    def lines
+      plain_text.split("\n").reject(&:empty?)
+    end
+
+    # Factory: reads chunks from an IO (popen handle), optionally tee-ing
+    # each chunk to `tee` as it arrives. Used by Shell.stream / stream_combined.
+    # Pass tee: nil to capture without printing.
+    def self.collect_chunks(io, wait_thr, tee: $stdout)
+      output = +""
+      loop do
+        chunk = io.readpartial(4096)
+        tee&.write(chunk)
+        output << chunk
+      rescue EOFError
+        break
+      end
+      new(output, wait_thr.value)
+    end
   end
 end

data/lib/hiiro/version.rb

@@ -1,3 +1,3 @@
 class Hiiro
-  VERSION = "0.1.343"
+  VERSION = "0.1.345"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: hiiro
 version: !ruby/object:Gem::Version
-  version: 0.1.343
+  version: 0.1.345
 platform: ruby
 authors:
 - Joshua Toyota