expect-pty 0.7.3 → 0.7.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c57608249970451325b18ded1deb6ecea96a110e3640e198aa947a8dd9a15b98
-  data.tar.gz: b14a1b19bff3673fa64d89ee6fc052cdb11d8fd7f64be00a74e4d47688b72c28
+  metadata.gz: 2b48d4fb81d2c6f7035133387df5641fb420b5c108e7257c2348f4ad119edecf
+  data.tar.gz: c6dcfa0a5edc30db418739decdaa262a480e905a234ddf179c67c609edac56a4
 SHA512:
-  metadata.gz: d242048c45c5143d7a651bb64ef82c352aee96474c764ce3c168038274dfac2b6aec602548f5f9de497a23c8f90c4e9c46efab58c3e6e13add9cd4351b61f99d
-  data.tar.gz: e2a86987567a5a0e254d76adf89d744af34f521c60172a4e8a32c373f6a31f020f777a1e983bcb078bd92048533371b0a94bc98564568aa092b3bde4425fadea
+  metadata.gz: 3a310e67d4303ebc2d9a2db7231722ab59b52a46bca2cf1aa32a1abd0de63a956867c17f4013df5029d21e4df509c8c6980fcc4193484f1e485b84e0933dff64
+  data.tar.gz: 19a972f1e1c19a64ba9b18f2148d0436c2f0a4211261f4a3396447b5863d8e6ac9e8f30322cb28e92ef45a5e8801dc519593c6a82044dacb42fe33b0ed17b1e0

data/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## Unreleased
 
+## 0.7.4 - 2026-10-06
+
+- **连续匹配**：修复回调中嵌套读取相同内容的新消息后漏触发匹配、最终超时的问题，保留零宽匹配和同值赋回的防空转保护。
+- **大缓冲转接**：降低已积累大量输出时的转接耗时与 GC 压力，保持完整交付、结果快照和失败续发行为。
+- **流式脱敏**：减少长短秘密混合、细粒度分片时的重复扫描和临时对象，保留规则更新、跨块重叠及已有掩码。
+
 ## 0.7.3 - 2026-10-06
 
 - **转义连续性**：匹配消费、显式缓冲替换/清空及实际窗口裁剪后清除旧正则历史，避免跨过已消费输入误拼转义并吞字节；内部交接及非消费匹配保留连续历史。

data/README.md

@@ -17,7 +17,7 @@ RubyGems/Bundler 解析。推荐入口 **`require "expect/pty"`**；本项目提
 项目和仓库名为 `expect-ruby`，Gem 名为 `expect-pty`。在应用的 Gemfile 中添加以下内容，然后运行 `bundle install`：
 
 ```ruby
-gem "expect-pty", "~> 0.7.3", require: "expect/pty"
+gem "expect-pty", "~> 0.7.4", require: "expect/pty"
 ```
 
 也可直接执行 `gem install expect-pty`。需要跟随开发分支时，可从 GitHub 安装：
@@ -30,8 +30,8 @@ gem "expect-pty", git: "https://github.com/gatework/expect-ruby.git", branch: "m
 
 ```sh
 mkdir -p tmp
-gem build expect-pty.gemspec --output tmp/expect-pty-0.7.3.gem
-gem install ./tmp/expect-pty-0.7.3.gem
+gem build expect-pty.gemspec --output tmp/expect-pty-0.7.4.gem
+gem install ./tmp/expect-pty-0.7.4.gem
 ```
 
 ```ruby

data/docs/API.md

@@ -49,6 +49,7 @@ result => { number:, captures: }
 `reset_timeout: false` 保持原相对期限。全部 EOF 后直接返回 EOF；已处理的来源不再参与超时。
 
 `consume: false` 仅在本轮保留完整匹配缓冲；继续但不改变缓冲的模式暂停到输入变化，避免反复触发。
+回调中的嵌套等待实际读入新字节时，即使缓冲内容与之前相同也会恢复匹配；仅同值赋回缓冲不算新输入。
 `reset_timeout_on_read: true` 使每次读取重置本轮相对期限。`deadline` 是单调时钟绝对秒数，不被输入或回调延长。
 IO 期限不打断用户代码或单次正则；不可信正则应使用 Ruby `Regexp` 自身的 timeout。
 

data/lib/expect/interaction.rb

@@ -111,7 +111,9 @@ module Expect
           trim_history(history, buffer.byteslice(0, count), limit: session.buffer_limit || REGEXP_ESCAPE_HISTORY_LIMIT,
                                                             utf8: utf8_regexp)
         end
-        buffer.slice!(0, count)
+        # 排队前缀与尾部可共享原字节；替换窗口而非删除前缀，避免逐块复制整个余量。
+        # 保留缓冲对象身份，嵌套 Matcher 仍把尾部交回 Relay 借用的同一个对象。
+        buffer.replace(buffer.byteslice(count..)) if count.positive?
         return count.positive? ? :queued : :ready
       end
     end

data/lib/expect/matcher.rb

@@ -71,7 +71,7 @@ module Expect
 
           buffer = buffers ? (buffers[session] ||= session.scan_buffer) : session.scan_buffer
           stalled = @stalled_matches[session]
-          if stalled && stalled[:buffer] != buffer
+          if stalled && (stalled[:received_bytes] != session.received_bytes || stalled[:buffer] != buffer)
             @stalled_matches.delete(session)
             stalled = nil
           end
@@ -124,13 +124,14 @@ module Expect
     # 先记录并消费匹配，再执行回调；回调可选择结束、重置期限或保留期限继续。
     def handle_match(session, pattern, position)
       previous_buffer = session.buffer
+      received_bytes = session.received_bytes
       result = session.record_match(pattern, position, consume: @consume)
       action = pattern.call(session)
       return result unless continuing?(action)
 
-      # 回调未改变缓冲时暂停当前模式，等待缓冲变化后再匹配，避免原地空转。
-      if session.buffer == previous_buffer
-        stalled = (@stalled_matches[session] ||= { buffer: previous_buffer, patterns: [] })
+      # 同值赋回仍须防止空转；嵌套读取到的新字节即使内容相同，也能恢复匹配。
+      if session.received_bytes == received_bytes && session.buffer == previous_buffer
+        stalled = (@stalled_matches[session] ||= { buffer: previous_buffer, received_bytes:, patterns: [] })
         stalled[:patterns] << pattern
       end
       @deadline = next_deadline if CONTINUE.equal?(action)

data/lib/expect/redactor.rb

@@ -32,6 +32,7 @@ module Expect
 
       @patterns = patterns.map { |pattern| pattern.b.freeze }.uniq.freeze
       @lookbehind = [(@patterns.map(&:bytesize).max || 0) - 1, 0].max
+      @scanned_bytes = 0
     end
 
     # 追加一个原始字节块，返回已经可以确定的安全前缀；新秘密可能跨越此前保留的尾部。
@@ -94,14 +95,18 @@ module Expect
       end
     end
 
-    # 仍逐字节推进重叠命中，但同一模式的相交/相邻区间只写一次掩码。
-    # 只向旧掩码取并集，不能清除其他模式或旧规则已经隐藏的 pending 字节。
+    # 每个模式只扫描可能跨越新增字节的起点；规则更新后从头重扫保留窗口。
+    # 重叠命中取并集，同一模式的相交/相邻区间只写一次，不清除旧掩码。
     def mark_secrets
+      size = @pending.bytesize
+      return if @scanned_bytes == size
+
       @patterns.each do |pattern|
-        starting = @pending.index(pattern)
+        length = pattern.bytesize
+        offset = @scanned_bytes >= length ? @scanned_bytes - length + 1 : 0
+        starting = @pending.index(pattern, offset)
         next unless starting
 
-        length = pattern.bytesize
         ending = starting + length
         offset = starting
         while (offset = @pending.index(pattern, offset + 1))
@@ -113,12 +118,15 @@ module Expect
         end
         @hidden[starting, ending - starting] = "\1" * (ending - starting)
       end
+      @scanned_bytes = size
     end
 
     # 按连续区间输出，避免逐字节构造字符串；只保存尚可能与下一块组成秘密的后缀。
     # masking 跨 append 保留，使被分成多个块的同一隐藏区间只输出一次替换标记。
     def release(length)
       output = "".b
+      return output if length.zero?
+
       cursor = 0
       while cursor < length
         hidden = @hidden.getbyte(cursor) == 1
@@ -135,9 +143,11 @@ module Expect
         end
         cursor = ending
       end
-      @pending = @pending.byteslice(length..)
-      @hidden = @hidden.byteslice(length..)
-      @suppressed = @suppressed.byteslice(length..) if @suppressed
+      remaining = @pending.bytesize - length
+      @pending = @pending.byteslice(length, remaining)
+      @hidden = @hidden.byteslice(length, remaining)
+      @suppressed = @suppressed.byteslice(length, remaining) if @suppressed
+      @scanned_bytes = remaining
       output
     end
 

data/lib/expect/session.rb

@@ -145,6 +145,10 @@ module Expect
     # @api private
     def scan_buffer = @buffer
 
+    # 成功读取的累计字节数；消费、替换和移交缓冲不算新的接收进展。
+    # @api private
+    attr_reader :received_bytes
+
     # 复制并替换原始字节缓冲，应用当前上限；调用方后续修改原字符串不会影响会话。
     def buffer=(value)
       raise ArgumentError, "buffer must be a String" unless value.is_a?(String)
@@ -359,6 +363,7 @@ module Expect
 
       data = data.b
       buffer << data
+      @received_bytes += data.bytesize
       trim_buffer if trim
       # 本块完成全部交付前不能递归读取，否则后块会抢先进入其他日志及输出目标。
       # 回调仍可匹配已有缓冲或驱动其他会话；拒绝嵌套读取不能释放外层的保护。
@@ -388,6 +393,7 @@ module Expect
       @tty_name = slave.path if slave
       @buffer = "".b
       @buffer_generation = 0
+      @received_bytes = 0
       @buffer_discarded_bytes = 0
       @outputs = []
       @sequences = {}

data/lib/expect/version.rb

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

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: expect-pty
 version: !ruby/object:Gem::Version
-  version: 0.7.3
+  version: 0.7.4
 platform: ruby
 authors:
 - expect-pty contributors
 bindir: bin
 cert_chain: []
-date: 2026-10-06 00:00:00.000000000 Z
+date: 2026-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: io-console