expect-pty 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9d6ae394cf13d882d00a78b0684c158551e08896bf572272790d68cc7850d804
-  data.tar.gz: 2cada03b8804a8402bec3dfdbc54f705650d1b47d57b410e3e6c83d35af4cd9c
+  metadata.gz: 0742e1462f3858067396edb88d2e401ba621869882091cddee3237cedd86eaf5
+  data.tar.gz: d054194b5f0f54740d86ccdca2d684d7ee8faeae77dbbf50595cc0b3516d4308
 SHA512:
-  metadata.gz: 64dbb1fbbed803a50dedda414a59f662121adcfee88de614f563e1de1d2f7c195f82d77f415a3a0fc545b420f5158e252637dada211c8ac35a98fa1728868748
-  data.tar.gz: d060fd85a2344e4e18d15257506844908f332100538517edbf6b5395e2a6bef0c98e0c12c44d21d26074eccb690ef6d1f81b4508056e85107239c84de3d7a09e
+  metadata.gz: 5a3be17c347139230dfe4395292ef7eeb58d0f432445c6d234542e3d83ac0f87e0e08d3131dc6842f4f1639a7a979868b84dd51ea9c9b206809901e232faac0d
+  data.tar.gz: e3f6508feaaa07172147b4c26bbc850e22bc918f377213ae4b1403947446cd15141f6d43860d26c28dac62a95628b72df1e09ae9ea2819781eef5cdb7fa93d54

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.9.3 - 2026-10-18
+
+- 结果的 inspect 与 to_s 仅输出匹配序号和错误状态，避免诊断、字符串插值泄露匹配文本、捕获内容或异常消息；原始结果字段保持不变。
+- 工厂块异常、取消或非局部退出时跳过 graceful 读尾，直接硬关闭；正常返回（包括 nil/false）仍可收取尾部输出。
+
 ## 0.9.2 - 2026-10-18
 
 - 减少显式搜索窗口下字面量匹配的内存分配，保留原始字节偏移、声明优先级和正则窗口语义。

data/docs/API.md

@@ -19,6 +19,8 @@ Session 构造器不接收命令或操作参数。同一会话只能启动一次
 `Expect.open(io, writer: io, own: false, graceful: false, **settings)` 适配真实可 select 的 IO，默认借用。
 `own: true` 接管关闭责任，包括初始化中已知设置的非法值导致的失败；未知关键字在 Ruby 方法入口拒绝，此时不接管 IO。
 `spawn`、`open` 无块时返回 Session，有块时返回块结果并确保按 `graceful:` 关闭；非局部返回也清理。
+工厂块正常返回时才执行 graceful 读尾；异常、线程取消以及 return/break/throw 等非局部退出直接硬关闭，避免读尾延迟退出。
+块正常返回 nil 或 false 仍属于正常完成；调用方 rescue 中已处理的异常不影响此判断。
 清理中的 StandardError 不覆盖本次作用域已有的主异常；没有主异常时照常传播。新发生的 Interrupt/SystemExit 不会被清理包装吞掉。
 
 `close(graceful: false)` 最终硬关闭兜底，返回 nil；`soft_close(timeout: 15, term_timeout: 1)` 收取尾部、关闭句柄并最多发送
@@ -65,6 +67,8 @@ nil 保留全缓冲扫描；指定时，字符串和正则只搜索最新的尾
 固定 UTF-8 正则跳过边界切开的合法首字符，等待合法未完成尾字符；窗口内非法字节及 EOF 未完成字符仍报错。
 二进制正则按原始字节匹配。
 
+Result 的 `inspect` 与 `to_s` 仅显示匹配序号和错误状态，不打印原始文本、异常消息或来源对象。
+需要原始结果时显式读取字段；`redact` 不改变这些字段。
 Result 字段为 `number`、`error`、`match`、`before`、`after`、`session`、`captures`。对象、文本及捕获数组均不可变，未参与捕获为
 nil。
 错误为 nil、`:timeout`、`:eof` 或原始 IO 异常；来源会话与异常不复制、不冻结。使用 `matched?`、`timeout?`、`eof?` 查询，

data/docs/COMPATIBILITY.md

@@ -46,7 +46,8 @@ PID。`hard_close` 不等待输出，必要时 TERM、KILL 并回收子进程。
 
 Ruby 使用关键字指定各阶段期限，关闭方法返回 `Process::Status` 或 `nil`。`close(graceful: true)` 或工厂块的
 `graceful: true`
-先尝试软关闭，再在 `ensure` 中硬关闭；这对应原版销毁时可选软关闭、随后硬关闭的清理策略。`close` 返回 `nil`；GC
+先尝试软关闭，再在 `ensure` 中硬关闭；工厂块仅正常返回时读尾，异常、取消及非局部退出直接硬关闭。
+显式 `close(graceful: true)` 仍按调用参数读尾。`close` 返回 `nil`；GC
 兜底直接强制清理，不阻塞等待。
 
 ## 有意采用的 Ruby 语义

data/lib/expect/pty.rb

@@ -66,12 +66,12 @@ module Expect
               timeout: nil, write_timeout: nil, buffer_limit: nil, logger: nil, transcript: nil, outputs: [])
       session = nil
       spawned = false
-      cleanup = lambda do
+      cleanup = lambda do |completed|
         if session && (block_given? || !spawned)
-          session.cleanup_session(nil, writer: nil, own: false, graceful: spawned && graceful)
+          session.cleanup_session(nil, writer: nil, own: false, graceful: spawned && graceful && completed)
         end
       end
-      Cleanup.always(cleanup) do
+      Cleanup.always(cleanup, report_completion: true) do
         # 工厂在构造期间处理失败；成功对象的返回与登记不可被中断拆开。
         Thread.handle_interrupt(Object => :never) do
           session = SessionFactory.pty(timeout:, write_timeout:, buffer_limit:, logger:, transcript:, outputs:)
@@ -89,14 +89,14 @@ module Expect
       session = nil
       initialized = false
       constructing = false
-      cleanup = lambda do
+      cleanup = lambda do |completed|
         if session && (block_given? || !initialized)
-          session.cleanup_session(io, writer:, own:, graceful: initialized && graceful)
+          session.cleanup_session(io, writer:, own:, graceful: initialized && graceful && completed)
         elsif !session && own && !constructing
           ResourceOwner.close_handles(io, writer)
         end
       end
-      Cleanup.always(cleanup) do
+      Cleanup.always(cleanup, report_completion: true) do
         Thread.handle_interrupt(Object => :never) do
           constructing = true
           session = SessionFactory.io(io, writer:, own:, timeout:, write_timeout:, buffer_limit:,

data/lib/expect/result.rb

@@ -30,6 +30,22 @@ module Expect
             captures: captures.map { |value| value&.dup&.freeze }.freeze)
     end
 
+    # 诊断只显示匹配序号和错误状态，不检查原始文本、异常或来源对象。
+    # @return [String] 不包含协议内容的结果摘要。
+    def inspect
+      state = if error.nil? then "none"
+              elsif error.equal?(:eof) then "eof"
+              elsif error.equal?(:timeout) then "timeout"
+              else "exception"
+              end
+      index = number.is_a?(Integer) ? number.to_s : "nil"
+      "#<#{self.class} number=#{index} error=#{state}>"
+    end
+
+    # Data 的默认 to_s 独立于 inspect；字符串插值同样只使用安全摘要。
+    # @return [String] 与 inspect 相同的结果摘要。
+    def to_s = inspect
+
     # 是否命中文本；EOF 和超时没有模式序号。
     def matched? = !number.nil?
 

data/lib/expect/version.rb

@@ -2,5 +2,5 @@
 
 module Expect
   # Gem 与库共用的版本号；独立文件使 gemspec 无需加载完整会话实现。
-  VERSION = "0.9.2"
+  VERSION = "0.9.3"
 end

data/sig/expect.rbs

@@ -238,6 +238,10 @@ module Expect
 
     def eof?: () -> bool
 
+    def inspect: () -> String
+
+    def to_s: () -> String
+
     def deconstruct: () -> [Integer?, result_error, String?, String?, String?, Session?, Array[String?]]
 
     def with: (

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: expect-pty
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.3
 platform: ruby
 authors:
 - expect-pty contributors