tarazed 0.2.0 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9aca479c6fefe50cf31a19a4d9f2ee2e9ccda43c41737accfc7d4297fd68df34
-  data.tar.gz: e877aa139fc517da68b0214e3b76e9f0b87d7d8277cc096370c451153a8463ca
+  metadata.gz: e7770f7ce8eac23698c2c294317d339ac24135b86b9f8203ee43f63229c1c4d4
+  data.tar.gz: d3aecd412f31417f961d10e07b683c07d2feeea3d5596b8d6218fde0a01e117d
 SHA512:
-  metadata.gz: 264107d5d55ddb7f21f95c973c6211113eebe67e25b64c24c3c1b5810b31b93231b7e6297e9c5143fd39f3d3496f66e7539e8a43863e379cbdd0fefa4279fbf6
-  data.tar.gz: b6af96ac20098f3b52aa9642be6550aa35a4c0a37cc0ab9cf5775f86d0e717e819e3dcbb9dbb509f63fb324761ae1b4e2b4019ac9c7fb7a3717b0859b3104dbf
+  metadata.gz: 5c6164054701b25e94dac45e3cd5359126f591d450a9ad1c817b9e2537c3117f77286c23354cc9a1b5585d7e991ca919f29085f5fcbab1d414305e97358f0e2a
+  data.tar.gz: 660218a61bf1017d59d90219d9beb040847ccaa8154b2f5dabdca23a0dff72d30a92e4537619a32808dec6d9ea65d64b5c67281e618f389d7978d3ab9c38d7d5

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 0.2.1 - 2026-09-16
+
+- Report and cache natural Windows ConPTY process exit status through the cross-platform `PTY#status` API.
+
 ## 0.2.0 - 2026-09-16
 
 - Track OSC 133 command boundaries, input, output rows, exit status, and OSC 7 working directories in bounded history.

data/README.md

@@ -1,9 +1,40 @@
-# Tarazed
+<h1 align="center">Tarazed</h1>
+
+<p align="center">
+  <strong>Pure Ruby terminal emulator core</strong>
+</p>
+
+<p align="center">
+  <a href="https://rubygems.org/gems/tarazed"><img src="https://img.shields.io/gem/v/tarazed.svg?colorB=319e8c" alt="Gem Version"></a>
+  <a href="https://rubygems.org/gems/tarazed"><img src="https://img.shields.io/gem/dt/tarazed.svg" alt="Downloads"></a>
+  <img src="https://img.shields.io/badge/ruby-%3E%3D%203.1-ruby.svg" alt="Ruby Version">
+  <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"></a>
+</p>
+
+<p align="center">
+  <a href="#features">Features</a> ·
+  <a href="#installation">Installation</a> ·
+  <a href="#quick-start">Quick Start</a> ·
+  <a href="#pty-sessions">PTY Sessions</a> ·
+  <a href="#command-history">Command History</a> ·
+  <a href="#shell-integration">Shell Integration</a>
+</p>
+
+---
 
 Tarazed is a pure Ruby terminal emulator core. It provides the
 terminal cell grid, scrollback, VT parser, keyboard/mouse encoding, and a
 POSIX or Windows ConPTY session without depending on an editor or UI toolkit.
 
+## Features
+
+- Unicode-aware cell grid with bounded scrollback
+- Chunk-safe VT parsing for terminal controls, input, links, and selection
+- Keyboard, mouse, bracketed-paste, and terminal-reply encoding
+- POSIX PTY and 64-bit Windows ConPTY sessions behind one API
+- OSC 133 command history and OSC 7 working-directory tracking
+- Packaged shell integration for bash, zsh, and fish
+
 ## Installation
 
 ```bash
@@ -12,7 +43,9 @@ bundle add tarazed
 
 Or run `gem install tarazed`.
 
-## Usage
+Tarazed supports Ruby 3.1 and later.
+
+## Quick Start
 
 Feed arbitrary byte chunks into a `VT`; incomplete UTF-8 and control sequences
 are retained until the next chunk.
@@ -26,6 +59,8 @@ terminal.feed("\e[32mready\e[0m\r\n")
 puts screen.text
 ```
 
+## PTY Sessions
+
 `Tarazed::PTY` owns a child process and feeds its output into the same grid.
 It uses a POSIX PTY on macOS and Linux and ConPTY on 64-bit Windows:
 
@@ -33,11 +68,15 @@ It uses a POSIX PTY on macOS and Linux and ConPTY on 64-bit Windows:
 terminal = Tarazed::PTY.new(command: ["/bin/sh"], columns: 80, rows: 24)
 terminal.write("printf 'hello\\n'\r")
 terminal.read(timeout: 0.1)
+puts terminal.status.exitstatus if !terminal.alive? && terminal.status
 terminal.close
 ```
 
 ConPTY requires a supported 64-bit Windows release and does not fall back to a
-pipe-only console.
+pipe-only console. After natural process exit, `status` provides `exited?`,
+`exitstatus`, `success?`, and `termsig` on every platform.
+
+## Command History
 
 `Tarazed::Session` adds a pump-oriented API and bounded OSC 133 command
 history. Command rows and output ranges use stable absolute history rows, and
@@ -52,6 +91,8 @@ end
 session.close
 ```
 
+## Shell Integration
+
 Shell integration snippets for bash, zsh, and fish are packaged with the gem.
 An embedding application can inject one into a new interactive shell with
 `Tarazed::ShellIntegration.read(:bash)` (or `:zsh` / `:fish`). The snippets
@@ -60,9 +101,13 @@ visible prompt.
 
 ## Development
 
-Run `bundle install`, then `bundle exec rake test`. Validate the signatures with
-`bundle exec rbs -I sig validate` and run the benchmark with
-`BUDGET=1 bundle exec rake bench`.
+```bash
+bundle install
+bundle exec rake test
+bundle exec rbs -I sig validate
+BUDGET=1 bundle exec rake bench
+gem build --strict tarazed.gemspec
+```
 
 ## Contributing
 
@@ -70,4 +115,4 @@ Bug reports and pull requests are welcome at https://github.com/noxdea/tarazed.
 
 ## License
 
-The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+Tarazed is available under the [MIT License](LICENSE.txt).

data/lib/tarazed/pty.rb

@@ -5,7 +5,7 @@ require "shellwords"
 
 module Tarazed
   class PTY
-    attr_reader :reader, :writer, :pid, :grid, :vt, :status, :initial_cwd, :command_name
+    attr_reader :reader, :writer, :pid, :grid, :vt, :initial_cwd, :command_name
 
     def initialize(command: ENV.fetch("SHELL", "/bin/sh"), cwd: Dir.pwd, columns: 80, rows: 24, env: {},
       scrollback: 10_000, queue_limit_bytes: 8_388_608, command_history_limit: 1_000, on_command: nil)
@@ -124,6 +124,8 @@ module Tarazed
       @foreground_name = nil
     end
 
+    def status = @native ? @native.status : @status
+
     def signal(name = "INT")
       return @native.write("\x03") if @native && name == "INT"
       if @native

data/lib/tarazed/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tarazed
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/lib/tarazed/windows/conpty.rb

@@ -21,8 +21,23 @@ module Tarazed
     class ConPTY
       P, I, U, N, V = Fiddle::TYPE_VOIDP, Fiddle::TYPE_INT, Fiddle::TYPE_UINT, Fiddle::TYPE_SIZE_T,
         Fiddle::TYPE_VOID
+      STILL_ACTIVE = 259
       private_constant :P, :I, :U, :N, :V
 
+      class Status
+        attr_reader :exitstatus
+
+        def initialize(exitstatus)
+          @exitstatus = exitstatus
+          freeze
+        end
+
+        def exited? = true
+        def success? = exitstatus.zero?
+        def termsig = nil
+      end
+      private_constant :Status
+
       attr_reader :pid
 
       def initialize(command: nil, columns: 80, rows: 24, cwd: nil, env: {}, kernel: nil)
@@ -104,13 +119,17 @@ module Tarazed
         check_hresult(function(:ResizePseudoConsole, [P, I], I).call(@console, coordinate(columns, rows)))
       end
 
-      def alive?
-        !@closed && function(:WaitForSingleObject, [P, U], U).call(@process, 0) == 258
+      def status
+        refresh_status unless @closed
+        @status
       end
 
+      def alive? = !@closed && !status
+
       def close
         return self if @closed
 
+        safely { refresh_status }
         @closed = true
         close_handle(@input_write)
         @input_write = nil
@@ -128,6 +147,15 @@ module Tarazed
         @kernel.fn(name, arguments, result, need_gvl: need_gvl)
       end
 
+      def refresh_status
+        return @status if @status
+
+        code = [0].pack("I")
+        check(function(:GetExitCodeProcess, [P, P], I).call(@process, code), "GetExitCodeProcess")
+        value = code.unpack1("I")
+        @status = Status.new(value) unless value == STILL_ACTIVE
+      end
+
       def process_attributes(console)
         size = [0].pack("J")
         function(:InitializeProcThreadAttributeList, [P, U, U, P], I).call(0, 1, 0, size)

data/sig/tarazed.rbs

@@ -132,13 +132,20 @@ module Tarazed
     def key: (String | Symbol name, ?shift: bool, ?alt: bool, ?control: bool) -> String
   end
 
+  interface _PTYStatus
+    def exited?: () -> bool
+    def exitstatus: () -> Integer?
+    def success?: () -> bool?
+    def termsig: () -> Integer?
+  end
+
   class PTY
     attr_reader reader: IO?
     attr_reader writer: IO?
     attr_reader pid: Integer
     attr_reader grid: Grid
     attr_reader vt: VT
-    attr_reader status: Process::Status?
+    attr_reader status: _PTYStatus?
     attr_reader initial_cwd: String
     attr_reader command_name: String
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tarazed
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
 platform: ruby
 authors:
 - Yudai Takada