net-connector 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7e379dbe5598c3f170fdcfbc123103c4eb178941508e8fa0df12e2b8043fdf93
-  data.tar.gz: 3ad7934b5aa811031ea1a1283c67743494795472a0361207869d6b16d03cfda0
+  metadata.gz: d4fb0da3edb43705fb7cf6cf98d08748f1b5efe5e9c9ad1385ee773d42cafb6e
+  data.tar.gz: b7cf3167af1527683bee2e2ca9bd69a8750608168b069868f6e28dc56f2d54b1
 SHA512:
-  metadata.gz: 07e68bd1ebd341839e6c45db6e821e76f8371c7b5d2e135a064925be5ca6f0d06189cf22be97fd2d8ea676fc542216dc67bfeff88fd06043b310fe72e642b67b
-  data.tar.gz: 96400e19508ca207d0e4aeccb0dc5aad7529bafebb0e2a4723a10e9d3907e07c5ba9f722afaabf5d78f257184f2b7f27aab82da91c7e64f60ca005188d1aa445
+  metadata.gz: 238e37ad287e6c4dc61cf2924b5b1bf91a3899cb7c304258795f225182a9c814b033b07bca48a5c8986fd59673e2dade8af17787aa3ac74b7e96fdeacd5a77f5
+  data.tar.gz: c5da59c15251d4e0f5b7dce7cca4e4a4135962bd6708fa871cd86dd371679922a388af48ef8fb20843cb0372d24eba917c291ae16181096c445263fb1f6bdeaf

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+## 0.22.0 - 2026-10-30
+
+- Require Ruby 4.0.6 and expect-pty 0.10.x. Adapt its explicit Result status and match_number in PTY transport and SSH authentication while retaining connector event semantics and zero-based indexes.
+- Accept explicit expect-pty source and package candidates for integration and isolated installation checks; verify the installed candidate bytes.
+
 ## 0.21.0 - 2026-10-30
 
 - Rename neighbor fields to `remote_name`, `remote_interface` and `remote_chassis_id`, retaining `local_interface`. Collection progress reads schema 4 `target`; require ctx_cli 0.5. No legacy accessor aliases.

data/README.md

@@ -4,7 +4,7 @@
 
 Ruby sessions for network device CLIs over SSH or Telnet. Collect configurations, save private backups, run interactive scripts, parse output with TextFSM, and back up fleets from Netdisco inventories.
 
-Requires Ruby 3.4+, expect-pty 0.9.6+, ctx_cli 0.4.x, TextFSM 0.5.1+ and a POSIX system. SSH uses local OpenSSH; Telnet requires a local `telnet` executable and explicit configuration.
+Requires Ruby 4.0.6+, expect-pty 0.10.x, ctx_cli 0.5.x, TextFSM 0.5.1+ and a POSIX system. SSH uses local OpenSSH; Telnet requires a local `telnet` executable and explicit configuration.
 
 ## Install
 

data/README.zh-CN.md

@@ -4,7 +4,7 @@
 
 通过 SSH 或 Telnet 操作网络设备的 Ruby 库。支持配置采集、私有备份、交互脚本、TextFSM 解析，以及基于 Netdisco 清单的批量备份。
 
-需要 Ruby 3.4+、expect-pty 0.9.6+、ctx_cli 0.4.x、TextFSM 0.5.1+ 和 POSIX 系统。SSH 使用本机 OpenSSH；Telnet 需要本机安装 `telnet` 并显式配置。
+需要 Ruby 4.0.6+、expect-pty 0.10.x、ctx_cli 0.5.x、TextFSM 0.5.1+ 和 POSIX 系统。SSH 使用本机 OpenSSH；Telnet 需要本机安装 `telnet` 并显式配置。
 
 ## 安装
 

data/docs/VERIFICATION.md

@@ -1,5 +1,20 @@
 # 验证、依赖与敏感数据
 
+## 2026-10-30：expect-pty 0.10 候选联调
+
+使用 RVM Ruby 4.0.6 / Bundler 4.0.16 / Linux x86_64，显式指定 `EXPECT_PTY_PATH=../expect-ruby` 和
+`EXPECT_PTY_GEM=/absolute/path/expect-pty-0.10.0.gem` 运行完整 `bash script/ci`。
+1,285 runs、12,997 assertions，零失败、错误或跳过；源码/历史/包扫描、307 文件 lint、工作流检查、
+关键组覆盖率下限、基准 smoke、普通/Bundler 隔离安装通过，安装后逐文件核对候选包内容。
+历史覆盖率基线的 Ruby 描述与本机不同，比较状态为 not_comparable，未改写历史基线。
+
+PTY 适配显式映射 matched、timeout、eof、error 和 match_number；设备事件继续使用零基 index，
+超时与 EOF 不会因为 Result#error 为 nil 被误判为成功。真实本地 PTY 测试覆盖流式读取、输出上限、关闭与认证。
+最低业务依赖组合（expect-pty 0.10.0、ctx_cli 0.5.0、TextFSM 0.5.1、JSON 2）亦通过完整测试与普通/Bundler 隔离安装；
+先安装候选包，再在未设置 EXPECT_PTY_PATH 的环境中解析 minimum.gemfile。
+日志为 `tmp/lean-ci.log`；最低依赖记录保存在工作区 `.expect-review-20261030/minimum.log`。
+远端 Actions、macOS 和真实设备未在本轮执行。
+
 在项目根目录执行：
 
 ```sh
@@ -128,7 +143,7 @@ NC-00 未保存逐文件数据，因此本轮不伪造逐文件历史下限；
 
 ## 平台与工具
 
-CI 矩阵为 Ubuntu 24.04 / macOS 15 × Ruby 3.4、4.0。
+CI 矩阵为 Ubuntu 24.04 / macOS 15 × Ruby 4.0.6、4.0。
 GitHub Actions 固定提交 SHA；Gitleaks 与 actionlint 固定版本和各平台归档
 SHA-256，首次使用时从官方 GitHub Release 下载，缓存到 `tmp/tools/`。
 已有工具归档和可执行文件也会再次校验。初次安装依赖和下载工具需要联网；
@@ -155,7 +170,7 @@ SHA-256，首次使用时从官方 GitHub Release 下载，缓存到 `tmp/tools/
 
 运行依赖写在 `net-connector.gemspec`，包括直接使用的、可能从 Ruby 默认
 安装中拆出的标准库 gem。开发工具只写在 Gemfile，不进入运行依赖。
-PTY 与共享脱敏直接依赖 expect-pty 0.9.6+ 的公开 `Session`、`buffer_bytesize` 和 `Expect::Redactor` 接口。
+PTY 与共享脱敏直接依赖 expect-pty 0.10.x 的公开 `Session`、`buffer_bytesize` 和 `Expect::Redactor` 接口。
 开发用 `parallel` 保持 1.x。升级 expect-pty 时先验证源码集成，再用本次构建的 gem 验证隔离安装；
 新依赖版本发布前不得将本地构建验证记成已发布版本验收，也不能退回旧接口掩盖依赖缺失。
 
@@ -163,9 +178,9 @@ PTY 与共享脱敏直接依赖 expect-pty 0.9.6+ 的公开 `Session`、`buffer_
 分别解析兼容依赖。应用使用者应在自己的应用中提交 lockfile。测试和打包
 脚本通过隔离安装检查运行依赖，避免依赖开发环境里偶然存在的 gem。
 
-`gemfiles/minimum.gemfile` 固定受支持的依赖下界 expect-pty 0.9.6、ctx_cli 0.4.0、textfsm 0.5.1；
+`gemfiles/minimum.gemfile` 固定受支持的依赖下界 expect-pty 0.10.0、ctx_cli 0.5.0、textfsm 0.5.1；
 标准库和开发工具仍按主 Gemfile 的兼容范围解析。普通矩阵检查允许版本的正常解析，
-另在 Ubuntu / Ruby 3.4、4.0 检查这组版本的全量测试与隔离安装。本地复现：
+另在 Ubuntu / Ruby 4.0.6、4.0 检查这组版本的全量测试与隔离安装。本地复现：
 
 ```sh
 BUNDLE_GEMFILE=gemfiles/minimum.gemfile bundle install
@@ -211,7 +226,7 @@ Gitleaks 默认规则之外，还检查网络设备密码/SNMP community 配置
 运行依赖要求 TextFSM 0.5.1 或更新版本；0.5.1 的公开 JSON 声明为 `>= 2.0`，
 允许普通消费者选择 JSON 2 或 JSON 3。最低依赖任务固定 TextFSM 0.5.1 与 JSON 2。
 
-CI 的 `json3-compatibility` 在 Ruby 3.4 / 4.0 使用已发布 TextFSM 0.5.1 与 JSON 3，
+CI 的 `json3-compatibility` 在 Ruby 4.0.6 / 4.0 使用已发布 TextFSM 0.5.1 与 JSON 3，
 执行完整测试和真实打包隔离安装。脚本核对原始 gem 的 JSON 依赖声明，再将发布包缓存
 交给隔离消费者；不再检出旧源码、修改 metadata 或重建同版本 TextFSM。
 
@@ -244,7 +259,7 @@ TFTP 远端未核验回执以及自定义日志目录；离线复核同时支持
 实施记录使用当前工作区文件和方法可见性快照，区别已有改动与本轮增量，不以 Git HEAD 冒充修改前基线。
 源码根目录 `RENAMES.md` 记录批准的改名与兼容边界。完整验收仍运行 `bundle exec rake ci`；
 临时 PostgreSQL 使用 `bundle exec rake test:postgres`，可通过 `NC_TEST_PG_BINDIR` 指定服务端工具目录。
-最低 Ruby 3.4 必须在对应解释器中运行 lint/test；RuboCop 的 TargetRubyVersion 和 Ruby 4.0 测试不能替代此项。
+最低 Ruby 4.0.6 必须在对应解释器中运行 lint/test；RuboCop 的 TargetRubyVersion 和 Ruby 4.0 测试不能替代此项。
 
 ## 报告统计基准
 

data/lib/net/connector/engine/transports.rb

@@ -61,8 +61,15 @@ module Net
         # 从信道读取下一事件，并把字符串字段转换为字节字符串。
         def read(patterns, timeout:)
           result = @channel.expect(*patterns, STREAM, timeout: timeout)
-          Event.new(index: result.number && (result.number - 1), before: result.before.to_s,
-                    match: result.match.to_s, error: result.error)
+          # 传输事件维持连接器的零基索引与事件协议；PTY 的等待状态和异常在适配边界明确转换。
+          error = case result.status
+                  when :matched then nil
+                  when :eof, :timeout then result.status
+                  when :error then result.error
+                  else raise ArgumentError, "unknown PTY result status"
+                  end
+          Event.new(index: result.match_number && (result.match_number - 1), before: result.before.to_s,
+                    match: result.match.to_s, error:)
         end
 
         # 临时设置写入超时，完成写入后恢复原设置。

data/lib/net/connector/netdisco/ssh/authentication.rb

@@ -17,11 +17,11 @@ module Net
             Expect.spawn(*arguments, raw: true, buffer_limit: 65_536, write_timeout: 5) do |session|
               deadline = Expect.monotonic + 15
               challenge = session.expect(PASSWORD, REJECTED, timeout: [deadline - Expect.monotonic, 0].max)
-              next false unless challenge.number == 1
+              next false unless challenge.match_number == 1
 
               session.write(password + "\n")
               completion = session.expect(PASSWORD, REJECTED, timeout: [deadline - Expect.monotonic, 0].max)
-              completion.error == :eof
+              completion.eof?
             end
           end
         end

data/lib/net/connector/version.rb

@@ -3,6 +3,6 @@
 module Net
   module Connector
     # gemspec、CLI 与发布工具共用此版本，运行时读取不触发设备依赖加载。
-    VERSION = "0.21.0"
+    VERSION = "0.22.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: net-connector
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - net-connector contributors
@@ -35,20 +35,20 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.6
+        version: 0.10.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.11'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.6
+        version: 0.10.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.11'
 - !ruby/object:Gem::Dependency
   name: textfsm
   requirement: !ruby/object:Gem::Requirement
@@ -586,7 +586,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.4'
+      version: 4.0.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="