hiiro 0.1.343 → 0.1.344

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e0b4a52f12f6b8206e79bc9c467c11523d8b6c09592e83ee88617133112ee60a
-  data.tar.gz: 3190f9942e4f705fb7b4de299ed992d0b0123e5d57c5e375a3476f0b018b4867
+  metadata.gz: dfbd49f6a3303a03b9568647851914d4a1c30e7c81a6f9aa8ef5d9808728769d
+  data.tar.gz: 1245ec1dcc474ff962d48405c357ac315734c30a2cc573697e5c28ee3b35057f
 SHA512:
-  metadata.gz: a6ce0e2c104da7509260220b5fc02162dde679457bc56012b704b17cb02ede55e51cd0e47f06b626ac40fd129b8f84991c0043e19523513e7012e11b4d8942b8
-  data.tar.gz: c1b053c3f8cac1f4af5433a64e217dfdc79c93dcf017eab287efbfeb1f2e90ea696012bb37da1a599aab43c069e309b6488c3cab530cdefbd7cfc0cf6c69dde7
+  metadata.gz: dfaa031a3b826d422c64f8378108278cc845d4ec09a26da1f37fa85da34edb3c326c919d612873c1213331883cead770cd684d688ab521d38ec77dd50645d273
+  data.tar.gz: 1d0eb4479c705c13f898da37389b65d60104830d5daae7e9af38dba289cf871feeef60d8b6efd7fe9461cdfa490ba00a6fa53303520f4214b7d28ff0868a3faa

data/lib/hiiro/shell.rb

@@ -22,5 +22,119 @@ 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.
+    ANSI_PATTERN = /\e(?:\[[0-?]*[ -/]*[@-~]|[^[])/
+
+    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.344"
 end

metadata

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