tarazed 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9aca479c6fefe50cf31a19a4d9f2ee2e9ccda43c41737accfc7d4297fd68df34
-  data.tar.gz: e877aa139fc517da68b0214e3b76e9f0b87d7d8277cc096370c451153a8463ca
+  metadata.gz: c614cedbb2f3c547a9338aab4e19ff9861d5da64a1688a34bb29b2f00f3c5781
+  data.tar.gz: 297e80f11061fae2596697f78f0e19d97d6537c6133999c2df70b1f277e53292
 SHA512:
-  metadata.gz: 264107d5d55ddb7f21f95c973c6211113eebe67e25b64c24c3c1b5810b31b93231b7e6297e9c5143fd39f3d3496f66e7539e8a43863e379cbdd0fefa4279fbf6
-  data.tar.gz: b6af96ac20098f3b52aa9642be6550aa35a4c0a37cc0ab9cf5775f86d0e717e819e3dcbb9dbb509f63fb324761ae1b4e2b4019ac9c7fb7a3717b0859b3104dbf
+  metadata.gz: 724ba37a3d343f37740d857d00cc38012d338d588cae81ddde319c0e7b362f6d88a6149abc991a283980366c471b6f4b70b87c3d6aa9a9a6d3e61097245dec24
+  data.tar.gz: 787a10f3d001c3bae7501c23037c75ce53488749a3fecd2cdd9671f8d46fabe3d08c36503d89a18cf7c204a1465c8049e4537dc6353fca591d626744da7e2593

data/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 ## Unreleased
 
+## 0.2.2 - 2026-09-17
+
+- Drain final Windows ConPTY output to EOF after the primary process exits without racing resize or close.
+
+## 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.2"
 end

data/lib/tarazed/windows/conpty.rb

@@ -21,11 +21,30 @@ 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
-      private_constant :P, :I, :U, :N, :V
+      STILL_ACTIVE = 259
+      WAIT_OBJECT_0 = 0
+      WAIT_TIMEOUT = 258
+      EXIT_POLL_MILLISECONDS = 10
+      private_constant :P, :I, :U, :N, :V, :WAIT_OBJECT_0, :WAIT_TIMEOUT, :EXIT_POLL_MILLISECONDS
+
+      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)
+        @console_lock, @lifecycle_lock = Mutex.new, Mutex.new
         raise Error, "ConPTY requires 64-bit Windows Ruby" unless Fiddle::SIZEOF_VOIDP == 8
 
         @kernel = kernel || Library.new("kernel32.dll")
@@ -40,6 +59,7 @@ module Tarazed
         attributes = process_attributes(@console)
         @process, @pid = spawn(command, cwd, env, attributes)
         start_reader
+        start_exit_watcher
       rescue Fiddle::DLError, LoadError => error
         release
         raise Error, "ConPTY is unavailable: #{error.message}"
@@ -101,24 +121,36 @@ module Tarazed
       end
 
       def resize(columns, rows)
-        check_hresult(function(:ResizePseudoConsole, [P, I], I).call(@console, coordinate(columns, rows)))
+        size = coordinate(columns, rows)
+        @console_lock.synchronize do
+          return unless @console
+
+          check_hresult(function(:ResizePseudoConsole, [P, I], I).call(@console, size))
+        end
       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
-
-        @closed = true
-        close_handle(@input_write)
-        @input_write = nil
-        close_console
-        @reader&.join(2)
-        close_handle(@output_read)
-        close_handle(@process)
-        @output_read = @process = nil
+        @lifecycle_lock.synchronize do
+          return self if @closed
+
+          safely { refresh_status }
+          @closed = true
+          close_handle(@input_write)
+          @input_write = nil
+          close_console
+          @watcher&.join
+          @reader&.join(2)
+          close_handle(@output_read)
+          close_handle(@process)
+          @output_read = @process = nil
+        end
         self
       end
 
@@ -128,6 +160,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)
@@ -213,20 +254,43 @@ module Tarazed
         end
       end
 
+      def start_exit_watcher
+        wait = function(:WaitForSingleObject, [P, U], U, need_gvl: false)
+        @watcher = Thread.new do
+          loop do
+            result = wait.call(@process, EXIT_POLL_MILLISECONDS)
+            break if @closed
+            if result == WAIT_OBJECT_0
+              close_console
+              break
+            end
+            raise SystemCallError.new("WaitForSingleObject", Fiddle.last_error) unless result == WAIT_TIMEOUT
+          end
+        end
+      end
+
       def close_console
-        return unless @console
+        console = @console_lock.synchronize do
+          value = @console
+          @console = nil
+          value
+        end
+        return unless console
 
-        function(:ClosePseudoConsole, [P], V, need_gvl: false).call(@console)
-        @console = nil
+        function(:ClosePseudoConsole, [P], V, need_gvl: false).call(console)
       end
 
       def release
-        safely { close_handle(@input_write) }
-        safely { close_console }
-        @reader&.join(2)
-        safely { close_handle(@output_read) }
-        safely { close_handle(@process) }
-        @input_write = @output_read = @process = nil
+        @lifecycle_lock.synchronize do
+          @closed = true
+          safely { close_handle(@input_write) }
+          safely { close_console }
+          @watcher&.join
+          @reader&.join(2)
+          safely { close_handle(@output_read) }
+          safely { close_handle(@process) }
+          @input_write = @output_read = @process = nil
+        end
       end
 
       def safely

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.2
 platform: ruby
 authors:
 - Yudai Takada