net-connector 0.4.0 → 0.4.2

data/lib/net/connector/vendor/palo_alto/topology.rb

@@ -6,19 +6,31 @@ module Net
   module Connector
     module PaloAlto
       class Topology < Operations::Topology::Strategy
+        # 候选配置缺少经固件实验确认的所有权/commit 协议，暂只提供读取能力。
         def self.supports?(capability)
-          %i[neighbors interface_descriptions interface_description_changes].include?(capability)
+          %i[neighbors interface_descriptions].include?(capability)
         end
 
+        def change_error_code = :candidate_isolation_unavailable
+
+        # 读取各本机接口的 LLDP 邻居详情。
         def neighbor_command = "show lldp neighbors all"
+
+        # 从 set 格式配置解析接口备注。
         def description_template = "palo_alto_interface_descriptions.textfsm"
+
+        # 进入候选配置视图。
         def enter_configuration = "configure"
+
+        # 提交候选配置后退出配置视图。
         def finish_commands = ["commit", "exit"]
 
+        # 只计入非空邻居块，跳过没有对端的本机接口。
         def expected_neighbor_count(output, _template)
           neighbor_blocks(output).count { |block| !empty_neighbor_block?(block) }
         end
 
+        # 输出必须明确说明无邻居，或每个本机接口块都明确为空。
         def empty_neighbor_output?(output)
           return true if output.match?(/No LLDP neighbors/i)
 
@@ -34,6 +46,7 @@ module Net
           output.split(/^\s*Local information:\s*$/i).select { |block| block.match?(/^\s*Local interface:\s*\S+/i) }
         end
 
+        # 邻居字段区只有空行和提示符时，才视为明确的空块。
         def empty_neighbor_block?(block)
           tail = block.split(/^\s*Neighbor information:\s*$/i, 2)
           tail.size == 2 && tail.last.lines.all? { |line| line.strip.empty? || line.match?(/^\S+[>#]\s*$/) }
@@ -50,10 +63,12 @@ module Net
                                  code: :unrecognized_output, host: @device.host, phase: :parse)
         end
 
+        # 用 PAN-OS set 语法生成接口备注变更。
         def change_commands(change)
           [%Q(set network interface ethernet #{change.interface} comment "#{change.new_description}")]
         end
 
+        # commit 可能耗时较长，单独放宽该命令的超时。
         def script_command(command)
           command == "commit" ? Command.new(command, timeout: 300) : command
         end

data/lib/net/connector/vendor/radware/tftp_backup.rb

@@ -6,13 +6,20 @@ module Net
   module Connector
     module Radware
       class TftpBackup < Operations::Tftp::Strategy
-        # 生成 Radware 压缩配置的远端文件名。
-        def default_path(_source_file) = TftpTarget.filename(@device.host, extension: "tgz")
+        # Radware 原生导出生成压缩配置归档。
+        def self.file_extension = "tgz"
+
+        # 在连接前拒绝当前厂商不支持的参数组合。
+        def validate_options!(_target, source_file:, vrf: nil)
+          raise ArgumentError, "Radware Alteon does not use source_file" unless source_file.nil?
+          raise ArgumentError, "Radware TFTP backup does not use vrf" unless vrf.nil?
+        end
+
+        def receipt_metadata(_target, **) = { configuration_kind: :native_archive, format: :tgz }
 
         # 构造当前厂商的 TFTP 导出交互脚本。
         def script(target, source_file:, vrf: nil)
-          raise ArgumentError, "Radware Alteon does not use source_file" if source_file
-          raise ArgumentError, "Radware TFTP backup does not use vrf" if vrf
+          validate_options!(target, source_file: source_file, vrf: vrf)
 
           Script.new([Command.new("/cfg/ptcfg #{target.host} -tftp", timeout: 180, interactions: [
             interaction(/Enter\s+(?:hostname|IP address)[^\r\n]*:\s*\z/i, "#{target.host}\n"),

data/lib/net/connector/vendor/radware/topology.rb

@@ -6,7 +6,10 @@ module Net
   module Connector
     module Radware
       class Topology < Operations::Topology::Strategy
+        # Alteon 只支持读取端口描述，不提供邻居发现或自动改写。
         def self.supports?(capability) = capability == :interface_descriptions
+
+        # 从设备配置转储解析端口名称。
         def description_template = "radware_port_names.textfsm"
       end
     end

data/lib/net/connector/version.rb

@@ -2,6 +2,6 @@
 
 module Net
   module Connector
-    VERSION = "0.4.0"
+    VERSION = "0.4.2"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: net-connector
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.4.2
 platform: ruby
 authors:
 - net-connector contributors
 bindir: exe
 cert_chain: []
-date: 2026-09-26 00:00:00.000000000 Z
+date: 2026-09-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: expect-pty
@@ -15,34 +15,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.1
+        version: 0.5.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.3.1
-- !ruby/object:Gem::Dependency
-  name: activesupport
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '7.2'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '9'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '7.2'
-    - - "<"
-      - !ruby/object:Gem::Version
-        version: '9'
+        version: 0.5.0
 - !ruby/object:Gem::Dependency
   name: textfsm
   requirement: !ruby/object:Gem::Requirement
@@ -159,6 +139,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '1.5'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: net-http
   requirement: !ruby/object:Gem::Requirement
@@ -333,6 +333,26 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: timeout
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.3'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: uri
   requirement: !ruby/object:Gem::Requirement
@@ -373,16 +393,17 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '1.0'
-description: Automate network device login, configuration collection, command scripts,
-  interactive prompts, redacted logging, and Netdisco inventory backups.
+description: 通过 SSH 或 Telnet 登录网络设备，采集配置、执行命令脚本、处理交互提示，并提供脱敏日志与基于 Netdisco 清单的批量备份。
 executables:
 - net-connector-backup
 extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- CONTRIBUTING.md
 - LICENSE
 - README.md
+- SECURITY.md
 - docs/RELEASING.md
 - docs/VERIFICATION.md
 - docs/architecture.md
@@ -393,6 +414,7 @@ files:
 - lib/net/connector/device/interface_description.rb
 - lib/net/connector/device/interface_name.rb
 - lib/net/connector/device/profile.rb
+- lib/net/connector/device/profile/builder.rb
 - lib/net/connector/device/running_config.rb
 - lib/net/connector/device/running_config/strategy.rb
 - lib/net/connector/engine.rb
@@ -418,13 +440,18 @@ files:
 - lib/net/connector/netdisco/client.rb
 - lib/net/connector/netdisco/config_file.rb
 - lib/net/connector/netdisco/device.rb
+- lib/net/connector/netdisco/diagnostic.rb
 - lib/net/connector/netdisco/fleet.rb
+- lib/net/connector/netdisco/inventory_budget.rb
+- lib/net/connector/netdisco/plan.rb
 - lib/net/connector/netdisco/planner.rb
+- lib/net/connector/netdisco/report.rb
 - lib/net/connector/netdisco/result_store.rb
 - lib/net/connector/netdisco/rules.rb
 - lib/net/connector/netdisco/settings.rb
 - lib/net/connector/netdisco/worker.rb
 - lib/net/connector/operations.rb
+- lib/net/connector/operations/backup_lock.rb
 - lib/net/connector/operations/local_backup.rb
 - lib/net/connector/operations/parse_output.rb
 - lib/net/connector/operations/private_file.rb
@@ -433,9 +460,12 @@ files:
 - lib/net/connector/operations/running_config/hillstone.rb
 - lib/net/connector/operations/running_config/palo_alto.rb
 - lib/net/connector/operations/running_config/strategy.rb
+- lib/net/connector/operations/safe_file.rb
 - lib/net/connector/operations/saved_config.rb
+- lib/net/connector/operations/saved_config/legacy_index.rb
 - lib/net/connector/operations/tftp/cisco_ios.rb
 - lib/net/connector/operations/tftp/cisco_nxos.rb
+- lib/net/connector/operations/tftp/file_upload.rb
 - lib/net/connector/operations/tftp/h3c.rb
 - lib/net/connector/operations/tftp/hillstone.rb
 - lib/net/connector/operations/tftp/huawei.rb
@@ -443,10 +473,12 @@ files:
 - lib/net/connector/operations/tftp/radware.rb
 - lib/net/connector/operations/tftp/strategy.rb
 - lib/net/connector/operations/tftp_backup.rb
+- lib/net/connector/operations/tftp_receipt.rb
 - lib/net/connector/operations/topology.rb
 - lib/net/connector/operations/topology/cisco.rb
 - lib/net/connector/operations/topology/h3c.rb
 - lib/net/connector/operations/topology/hillstone.rb
+- lib/net/connector/operations/topology/immediate_strategy.rb
 - lib/net/connector/operations/topology/palo_alto.rb
 - lib/net/connector/operations/topology/radware.rb
 - lib/net/connector/operations/topology/strategy.rb
@@ -511,7 +543,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.12
+rubygems_version: 4.0.16
 specification_version: 4
-summary: Network device CLI sessions and Netdisco-driven concurrent backups
+summary: 网络设备命令行会话与 Netdisco 清单批量备份
 test_files: []