net-connector 0.4.0

data/lib/net/connector/operations/tftp/strategy.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+module Net
+  module Connector
+    module Operations
+      module Tftp
+        autoload :H3c, File.expand_path("h3c", __dir__)
+        autoload :CiscoIos, File.expand_path("cisco_ios", __dir__)
+        autoload :CiscoNxos, File.expand_path("cisco_nxos", __dir__)
+        autoload :Huawei, File.expand_path("huawei", __dir__)
+        autoload :Hillstone, File.expand_path("hillstone", __dir__)
+        autoload :Radware, File.expand_path("radware", __dir__)
+        autoload :PaloAlto, File.expand_path("palo_alto", __dir__)
+
+        class Strategy
+          # 保存 TFTP 厂商策略使用的设备对象。
+          def initialize(device)
+            @device = device
+            @responses = []
+          end
+
+          # 返回调用方指定的配置源文件。
+          def source_file(value) = value
+
+          # 根据设备地址生成默认远端文件名。
+          def default_path(_source_file) = TftpTarget.filename(@device.host, extension: "cfg")
+
+          # 返回目标中指定的远端文件名。
+          def remote_path(target, _result) = target.path
+
+          private
+
+          # 记录脚本的静态响应，避免文件名或 VRF 回显成为传输完成证据。
+          def interaction(pattern, response)
+            @responses << response.chomp
+            Interaction.new(pattern, response, capture: false)
+          end
+
+          # 只从设备消息中核对完成状态；命令、交互响应和最终提示均不是传输证据。
+          def completion_lines(result)
+            step = result.steps.last
+            return [] unless step
+
+            output = TerminalRenderer.render(step.output)
+            prompt = TerminalRenderer.render(step.prompt.to_s)
+            output = output.delete_suffix(prompt) unless prompt.empty?
+            echoes = [step.command.text, "#{prompt.strip}#{step.command.text}", *@responses]
+            output.each_line.map(&:strip).reject { |line| line.empty? || echoes.include?(line) }
+          end
+
+          # 只接受字节数非零、已发送量与总量相同的 curl 完成进度行。
+          def completed_progress?(line)
+            line.match?(/\A100\s+([1-9]\d*(?:\.\d+)?[kMGT]?)\s+0\s+0\s+100\s+\1(?:\s+[\d.:kMGT-]+)*\z/i)
+          end
+
+          # H3C 和华为的上传完成消息使用相同的文本及进度格式。
+          def completed_upload?(line)
+            line.match?(/\A
+              (?:File\s+)?(?:transfer|upload)(?:\s+(?:is|was))?\s+
+              (?:success(?:ful(?:ly)?)?|succeeded|complete(?:d)?(?:\s+successfully)?)[.!]?
+              \z/ix) ||
+              line.match?(/\A[1-9]\d*\s+bytes?\s+sent(?:\s+in\s+[\d.]+\s+(?:secs?|seconds?))?[.!]?\z/i) ||
+              completed_progress?(line)
+          end
+
+          # Cisco 明确报告复制完成的字节数，可附带耗时和速率。
+          def copied_bytes?(line)
+            line.match?(/\A
+              [1-9]\d*\s+bytes?\s+copied
+              (?:\s+in\s+[\d.]+\s+(?:secs?|seconds?)(?:\s+\([\d.]+\s+bytes\/sec\))?)?[.!]?
+              \z/ix)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/net/connector/operations/tftp_backup.rb

@@ -0,0 +1,120 @@
+# frozen_string_literal: true
+
+require "digest"
+require_relative "tftp/strategy"
+
+module Net
+  module Connector
+    # 设备主动上传使用的 TFTP 目标，服务器必须能被设备访问。
+    class TftpTarget
+      MAX_PATH_BYTES = 220
+
+      attr_reader :host, :path
+
+      # 校验并保存 TFTP 服务器、远端路径及显式文件名标记。
+      def initialize(host:, path:, explicit_path: true)
+        unless host.is_a?(String) && host.bytesize <= 253 &&
+               host.match?(/\A[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?\z/) && !host.include?("..")
+          raise ArgumentError, "TFTP host must be an IPv4 address or DNS name"
+        end
+        self.class.validate_path!(path)
+        @host, @path = host.dup.freeze, path.dup.freeze
+        @explicit_path = explicit_path
+        freeze
+      end
+
+      # 判断调用方是否明确指定了远端文件名。
+      def explicit_path? = @explicit_path
+
+      # 校验设备或调用方给出的远端相对路径。
+      def self.validate_path!(path)
+        unless path.is_a?(String) && path.bytesize <= MAX_PATH_BYTES &&
+               path.match?(/\A[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)*\z/) &&
+               path.split("/").none? { |part| %w[. ..].include?(part) }
+          raise ArgumentError, "TFTP path must be a relative filename or path without traversal"
+        end
+        path
+      end
+
+      # 设备地址和可选清单名称共用目标长度限制；极长地址用稳定摘要表示。
+      def self.filename(host, extension:, label: nil)
+        address = host.gsub(/[^A-Za-z0-9._-]/, "_")
+        suffix = "#{address}.#{extension}"
+        if suffix.bytesize > MAX_PATH_BYTES - (label ? 2 : 0)
+          suffix = "#{Digest::SHA256.hexdigest(host)}.#{extension}"
+        end
+        path = label ? "#{label.byteslice(0, MAX_PATH_BYTES - suffix.bytesize - 1)}-#{suffix}" : suffix
+        validate_path!(path)
+      end
+
+      # 校验设备源文件路径是否符合命令安全约束。
+      def self.validate_source_file!(value)
+        unless value.is_a?(String) && value.match?(/\A[A-Za-z0-9._:\/-]+\z/) &&
+               !value.split("/").include?("..")
+          raise ArgumentError, "source_file must be a device file path without spaces or traversal"
+        end
+        value
+      end
+    end
+
+    TftpBackup = Data.define(:server, :path, :completed_at)
+
+    module Operations
+      class TftpBackup
+        # 保存执行 TFTP 导出的设备对象。
+        def initialize(device) = @device = device
+
+        # 执行设备原生 TFTP 导出并核对完成回显。
+        def call(host:, path: nil, source_file: nil, vrf: nil)
+          strategy_class = @device.profile.tftp_strategy
+          unless strategy_class
+            raise UnsupportedOperation.new("native TFTP backup is not supported for this vendor",
+                                           host: @device.host, phase: :tftp_backup)
+          end
+          strategy = strategy_class.new(@device)
+          if vrf && (!vrf.is_a?(String) || !vrf.match?(/\A[A-Za-z0-9_][A-Za-z0-9_.-]*\z/))
+            raise ArgumentError, "vrf must be a single safe name"
+          end
+          # H3C 在解析源文件时可能连接设备，因此先验证调用方提供的目标。
+          target = TftpTarget.new(host: host, path: path || "preflight.cfg", explicit_path: !path.nil?)
+          source_file = strategy.source_file(source_file)
+          target = TftpTarget.new(host: host, path: strategy.default_path(source_file), explicit_path: false) unless path
+          result = @device.execute_operation(strategy.script(target, source_file: source_file, vrf: vrf),
+                                             name: :tftp_backup, privilege: false)
+          result.value!
+          if transfer_failed?(result)
+            @device.record_event("tftp_backup", level: :error, status: "transfer_failed", server: target.host)
+            raise DeviceError.new("device reported TFTP backup failure",
+                                  code: :transfer_failed, host: @device.host, phase: :tftp_backup)
+          end
+          unless strategy.complete?(result)
+            @device.record_event("tftp_backup", level: :error, status: "transfer_unconfirmed", server: target.host)
+            raise DeviceError.new("device did not confirm TFTP backup completion",
+                                  code: :transfer_unconfirmed, host: @device.host, phase: :tftp_backup)
+          end
+
+          remote_path = strategy.remote_path(target, result)
+          @device.record_event("tftp_backup", status: "reported_uploaded", server: target.host, path: remote_path)
+          Net::Connector::TftpBackup.new(server: target.host, path: remote_path, completed_at: Time.now.utc)
+        end
+
+        private
+
+        # 识别设备回显中的传输失败信息。
+        def transfer_failed?(result)
+          result.steps.any? do |step|
+            # 文件名中的 failed.cfg、error-backup 等不属于诊断词；句末标点仍是词边界。
+            pattern = %r{(?<![\w./-])
+              (?:error|failed|failure|aborted|denied|timed\ out|timeout|not\ found|no\ such\ file|
+                 unable\ to|network\ is\ unreachable|can't\ open)
+              (?![\w/-]|\.[\w])}ix
+            # 原始诊断不能被回车抹除，颜色控制符也不能掩盖失败词。
+            history = step.output.gsub(/\r(?!\n)/, "\n")
+            step.output.match?(pattern) || TerminalRenderer.render(history).match?(pattern) ||
+              TerminalRenderer.render(step.output).match?(pattern)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/net/connector/operations/topology/cisco.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../vendor/cisco_ios/topology"
+
+module Net
+  module Connector
+    module Operations
+      Topology::Cisco = Net::Connector::CiscoIos::Topology
+    end
+  end
+end

data/lib/net/connector/operations/topology/h3c.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../vendor/h3c/topology"
+
+module Net
+  module Connector
+    module Operations
+      Topology::H3c = Net::Connector::H3c::Topology
+    end
+  end
+end

data/lib/net/connector/operations/topology/hillstone.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../vendor/hillstone/topology"
+
+module Net
+  module Connector
+    module Operations
+      Topology::Hillstone = Net::Connector::Hillstone::Topology
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../vendor/palo_alto/topology"
+
+module Net
+  module Connector
+    module Operations
+      Topology::PaloAlto = Net::Connector::PaloAlto::Topology
+    end
+  end
+end

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

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require_relative "../../vendor/radware/topology"
+
+module Net
+  module Connector
+    module Operations
+      Topology::Radware = Net::Connector::Radware::Topology
+    end
+  end
+end

data/lib/net/connector/operations/topology/strategy.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "shellwords"
+require_relative "../../device/interface_description"
+
+module Net
+  module Connector
+    module Operations
+      class Topology
+        autoload :Cisco, File.expand_path("cisco", __dir__)
+        autoload :H3c, File.expand_path("h3c", __dir__)
+        autoload :Hillstone, File.expand_path("hillstone", __dir__)
+        autoload :PaloAlto, File.expand_path("palo_alto", __dir__)
+        autoload :Radware, File.expand_path("radware", __dir__)
+
+        # 厂商拓扑规则；默认不提供任何设备能力。
+        class Strategy
+          def initialize(device)
+            @device = device
+          end
+
+          def self.supports?(_capability) = false
+          def supports?(capability) = self.class.supports?(capability)
+
+          def neighbor_command = nil
+          def neighbor_template(_output) = nil
+          def description_template = nil
+          def expected_neighbor_count(_output, _template) = 0
+          def empty_neighbor_output?(_output) = false
+          def enter_configuration = nil
+          def finish_commands = []
+          def change_commands(_change) = []
+          def protocol = :lldp
+          def script_command(command) = command
+
+          def interface_key(name) = InterfaceName.key(name)
+
+          # 将发现协议常用的接口简称展开为配置视图可识别的名称。
+          def configuration_interface(name) = InterfaceName.configuration(name)
+
+          # 还原 PAN-OS set 配置或 Alteon dump 中的引号描述。
+          def decode_description(value)
+            value = value.strip
+            value.start_with?('"') ? Shellwords.split(value).join(" ") : value
+          rescue ArgumentError
+            value
+          end
+
+        end
+      end
+    end
+  end
+end

data/lib/net/connector/operations/topology.rb

@@ -0,0 +1,192 @@
+# frozen_string_literal: true
+
+require_relative "topology/strategy"
+
+module Net
+  module Connector
+    module Operations
+      # 从 CDP/LLDP 回显生成链路邻居，并规划接口描述变更。
+      class Topology
+        Neighbor = Data.define(:local_interface, :neighbor_name, :neighbor_interface, :chassis_id, :protocol)
+        Change = Data.define(:interface, :old_description, :new_description, :neighbor)
+        Plan = Data.define(:host, :vendor, :evidence, :changes, :commands)
+
+        # 保存设备及其独立的 TextFSM 解析入口。
+        def initialize(device, template_dir: nil)
+          require_relative "parse_output"
+
+          @device = device
+          @parser = ParseOutput.new(template_dir: template_dir)
+          @strategy = (device.profile.topology_strategy || Strategy).new(device)
+        end
+
+        # 执行厂商 CDP/LLDP 命令，返回统一的邻居记录。
+        def neighbors
+          command = @strategy.neighbor_command
+          unless @strategy.supports?(:neighbors) && command
+            raise UnsupportedOperation.new("this device cannot discover LLDP neighbors",
+                                           code: :neighbor_discovery_unsupported, host: @device.host, phase: :discover)
+          end
+
+          output = @device.execute(command).value!
+          template = @strategy.neighbor_template(output)
+          rows = @parser.call(output, template: template, vendor: @device.vendor, command: command, host: @device.host)
+          if rows.size != @strategy.expected_neighbor_count(output, template) || (rows.empty? && !@strategy.empty_neighbor_output?(output))
+            raise ParsingError.new("neighbor output was not recognized", code: :unrecognized_output,
+                                   host: @device.host, phase: :discover)
+          end
+
+          rows.map do |row|
+            Neighbor.new(local_interface: row.fetch("LOCAL_INTERFACE").strip.freeze,
+                         neighbor_name: row.fetch("NEIGHBOR_NAME", "").strip.freeze,
+                         neighbor_interface: row.fetch("NEIGHBOR_INTERFACE").strip.freeze,
+                         chassis_id: row.fetch("CHASSIS_ID", "").strip.freeze,
+                         protocol: @strategy.protocol).freeze
+          end
+        end
+
+        # 从运行配置读取已设置的接口描述或端口名称。
+        def descriptions
+          template = @strategy.description_template
+          unless @strategy.supports?(:interface_descriptions) && template
+            raise UnsupportedOperation.new("interface descriptions are unsupported for this vendor",
+                                           code: :description_unsupported, host: @device.host, phase: :discover)
+          end
+          config = @device.running_config.value!
+          @parser.call(config, template: template, host: @device.host).each_with_object({}) do |row, found|
+            interface = @strategy.interface_key(row.fetch("INTERFACE"))
+            description = @strategy.decode_description(row.fetch("DESCRIPTION", ""))
+            previous = found[interface]
+            if previous && !previous.empty? && !description.empty? && previous != description
+              raise ParsingError.new("interface has conflicting descriptions", code: :ambiguous_description,
+                                     host: @device.host, phase: :parse)
+            end
+            found[interface] = description unless description.empty? && previous
+          end
+        end
+
+        # 比对邻居和现有描述，生成包含确切命令的只读变更计划。
+        def plan_descriptions(abbreviate: true, lowercase: false, &formatter)
+          check_change_support!(:plan) if @strategy.supports?(:neighbors)
+          discovered = neighbors
+          current = descriptions
+          current.each_value(&:freeze)
+          evidence = evidence_for(discovered, current)
+          changes = discovered.filter_map do |neighbor|
+            old = current.fetch(@strategy.interface_key(neighbor.local_interface))
+            proposed = if formatter
+                         formatter.call(neighbor)
+                       else
+                         InterfaceDescription.format(neighbor, abbreviate: abbreviate, lowercase: lowercase)
+                       end
+            InterfaceDescription.validate!(proposed)
+            next if old == proposed
+
+            Change.new(interface: @strategy.configuration_interface(neighbor.local_interface).freeze, old_description: old.freeze,
+                       new_description: proposed.freeze, neighbor: neighbor).freeze
+          end.freeze
+          commands = if changes.empty?
+                       []
+                     else
+                       [@strategy.enter_configuration] + changes.flat_map { |change| change_commands(change) } + @strategy.finish_commands
+                     end
+          commands.each(&:freeze)
+          Plan.new(host: @device.host.dup.freeze, vendor: @device.vendor, evidence: evidence,
+                   changes: changes, commands: commands.freeze).freeze
+        end
+
+        # 只有明确确认且邻居和旧描述未变化时，才下发计划中的命令。
+        def apply(plan, confirmed: false)
+          unless confirmed == true
+            raise UnsupportedOperation.new("description plan requires confirmation", code: :confirmation_required,
+                                           host: @device.host, phase: :apply)
+          end
+          raise ArgumentError, "plan must be a topology plan for this device" unless plan.is_a?(Plan) &&
+                                                                           plan.host == @device.host &&
+                                                                           plan.vendor == @device.vendor
+          return Result.new if plan.changes.empty?
+
+          check_change_support!(:apply) if @strategy.supports?(:neighbors)
+          @device.with_operation(:apply) { apply_plan(plan) }
+        end
+
+        private
+
+        # 现场复核、修改和回读属于同一次独占操作。
+        def apply_plan(plan)
+          discovered = neighbors
+          evidence = evidence_for(discovered, descriptions)
+          current_neighbors = discovered.to_h { |neighbor| [@strategy.interface_key(neighbor.local_interface), neighbor] }
+          same_neighbors = plan.changes.all? do |change|
+            current_neighbors[@strategy.interface_key(change.interface)] == change.neighbor
+          end
+          unless evidence == plan.evidence && same_neighbors
+            raise DeviceError.new("neighbors or interface descriptions changed after planning",
+                                  code: :stale_plan, host: @device.host, phase: :apply)
+          end
+
+          plan.changes.each do |change|
+            InterfaceDescription.validate!(change.new_description)
+            unless evidence.fetch(@strategy.interface_key(change.interface)) ==
+                   [change.neighbor.neighbor_name, change.neighbor.neighbor_interface, change.old_description]
+              raise ArgumentError, "plan changes do not match its discovery evidence"
+            end
+          end
+          commands = [@strategy.enter_configuration] + plan.changes.flat_map { |change| change_commands(change) } + @strategy.finish_commands
+          raise ArgumentError, "plan commands were modified" unless commands == plan.commands
+
+          script = commands.map do |command|
+            @strategy.script_command(command)
+          end
+          result = @device.execute_script(Script.new(script, name: "interface descriptions"))
+          return result if result.failure?
+
+          updated = descriptions
+          return result if plan.changes.all? do |change|
+            updated.fetch(@strategy.interface_key(change.interface), "") == change.new_description
+          end
+
+          Result.new(steps: result.steps,
+                     error: DeviceError.new("interface descriptions were not confirmed by readback",
+                                            code: :description_unconfirmed, host: @device.host, phase: :verify))
+        rescue Error => error
+          raise unless result&.success?
+
+          Result.new(steps: result.steps, error: error)
+        end
+
+        def check_change_support!(phase)
+          return if @strategy.supports?(:interface_description_changes)
+
+          raise UnsupportedOperation.new("interface description changes are unsupported for this vendor",
+                                         code: :description_unsupported, host: @device.host, phase: phase)
+        end
+
+        # 汇总邻居身份和当前描述，并要求每个目标接口都有配置证据。
+        def evidence_for(discovered, current)
+          interfaces = discovered.group_by { |neighbor| @strategy.interface_key(neighbor.local_interface) }
+          if interfaces.any? { |_interface, peers| peers.size != 1 || peers.first.neighbor_name.empty? ||
+                                 peers.first.neighbor_interface.empty? }
+            raise ParsingError.new("neighbor identity is incomplete or ambiguous", code: :ambiguous_neighbor,
+                                   host: @device.host, phase: :plan)
+          end
+          unless interfaces.keys.all? { |interface| current.key?(interface) }
+            raise ParsingError.new("neighbor interface was not found in running configuration",
+                                   code: :interface_missing, host: @device.host, phase: :plan)
+          end
+
+          interfaces.transform_values do |peers|
+            peer = peers.fetch(0)
+            [peer.neighbor_name, peer.neighbor_interface, current.fetch(@strategy.interface_key(peer.local_interface))].freeze
+          end.freeze
+        end
+
+        # 设备标识来自解析证据，仍需在生成命令前验证其安全性。
+        def change_commands(change)
+          InterfaceDescription.validate_interface!(change.interface)
+          @strategy.change_commands(change)
+        end
+      end
+    end
+  end
+end

data/lib/net/connector/operations.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# Topology 同时是扩展策略的命名空间。显式装配公共定义，确保旧扩展先加载
+# topology/strategy 时，已有常量不会阻止工作流加载；TextFSM 仍延迟到实际解析。
+require_relative "operations/topology"
+
+module Net
+  module Connector
+    module Operations
+      autoload :RunningConfig, File.expand_path("operations/running_config", __dir__)
+      autoload :ParseOutput, File.expand_path("operations/parse_output", __dir__)
+      autoload :LocalBackup, File.expand_path("operations/local_backup", __dir__)
+      autoload :TftpBackup, File.expand_path("operations/tftp_backup", __dir__)
+      autoload :Tftp, File.expand_path("operations/tftp/strategy", __dir__)
+    end
+    autoload :TftpTarget, File.expand_path("operations/tftp_backup", __dir__)
+    autoload :TftpBackup, File.expand_path("operations/tftp_backup", __dir__)
+    autoload :Backup, File.expand_path("operations/local_backup", __dir__)
+  end
+end

data/lib/net/connector/templates/cisco_cdp_neighbors_detail.textfsm

@@ -0,0 +1,7 @@
+Value Required LOCAL_INTERFACE (\S+)
+Value Required NEIGHBOR_NAME (\S+)
+Value Required NEIGHBOR_INTERFACE (\S+)
+
+Start
+  ^\s*Device ID:\s*${NEIGHBOR_NAME}\s*$$
+  ^\s*Interface:\s*${LOCAL_INTERFACE},\s*Port ID \(outgoing port\):\s*${NEIGHBOR_INTERFACE}\s*$$ -> Record

data/lib/net/connector/templates/cisco_ios_running_config_interfaces.textfsm

@@ -0,0 +1,12 @@
+Value Required INTERFACE (\S+)
+Value DESCRIPTION (.*)
+
+Start
+  ^interface ${INTERFACE}$$ -> Interface
+
+Interface
+  ^\s+description ${DESCRIPTION}$$
+  ^!$$ -> Record Start
+  ^interface .+ -> Continue.Record
+  ^interface ${INTERFACE}$$
+  ^end$$ -> Record End

data/lib/net/connector/templates/cisco_ios_show_ip_interface_brief.textfsm

@@ -0,0 +1,7 @@
+Value Required INTERFACE (\S+)
+Value IP_ADDRESS (\S+)
+Value STATUS (administratively down|up|down)
+Value PROTOCOL (up|down)
+
+Start
+  ^${INTERFACE}\s+${IP_ADDRESS}\s+\S+\s+\S+\s+${STATUS}\s+${PROTOCOL}$$ -> Record

data/lib/net/connector/templates/h3c_interface_descriptions.textfsm

@@ -0,0 +1,11 @@
+Value Required INTERFACE (\S+)
+Value DESCRIPTION (.*)
+
+Start
+  ^interface ${INTERFACE}$$ -> Interface
+
+Interface
+  ^\s+description ${DESCRIPTION}$$
+  ^#$$ -> Record Start
+  ^interface .+ -> Continue.Record
+  ^interface ${INTERFACE}$$

data/lib/net/connector/templates/h3c_lldp_local_first.textfsm

@@ -0,0 +1,8 @@
+Value Required LOCAL_INTERFACE (\S+)
+Value NEIGHBOR_NAME (\S+)
+Value Required CHASSIS_ID (\S+)
+Value Required NEIGHBOR_INTERFACE (Port\s+\d+|\S+)
+
+Start
+  ^\s*display lldp neighbor-information list\s*$$
+  ^\s*${LOCAL_INTERFACE}\s+${CHASSIS_ID}\s+${NEIGHBOR_INTERFACE}\s+${NEIGHBOR_NAME}\s*$$ -> Record

data/lib/net/connector/templates/h3c_lldp_name_first.textfsm

@@ -0,0 +1,8 @@
+Value Required LOCAL_INTERFACE (\S+)
+Value NEIGHBOR_NAME (\S+)
+Value Required CHASSIS_ID (\S+)
+Value Required NEIGHBOR_INTERFACE (Port\s+\d+|\S+)
+
+Start
+  ^\s*display lldp neighbor-information list\s*$$
+  ^\s*${NEIGHBOR_NAME}\s+${LOCAL_INTERFACE}\s+${CHASSIS_ID}\s+${NEIGHBOR_INTERFACE}\s*$$ -> Record

data/lib/net/connector/templates/hillstone_interface_descriptions.textfsm

@@ -0,0 +1,11 @@
+Value Required INTERFACE (\S+)
+Value DESCRIPTION (.*)
+
+Start
+  ^interface ${INTERFACE}$$ -> Interface
+
+Interface
+  ^\s+description ${DESCRIPTION}$$
+  ^\s*exit\s*$$ -> Record Start
+  ^interface .+ -> Continue.Record
+  ^interface ${INTERFACE}$$

data/lib/net/connector/templates/hillstone_lldp_neighbors.textfsm

@@ -0,0 +1,7 @@
+Value Required LOCAL_INTERFACE (\S+)
+Value NEIGHBOR_NAME (\S+)
+Value Required CHASSIS_ID (\S+)
+Value Required NEIGHBOR_INTERFACE (\S+)
+
+Start
+  ^\s*${NEIGHBOR_NAME}\s+${LOCAL_INTERFACE}\s+${CHASSIS_ID}\s+${NEIGHBOR_INTERFACE}\s*$$ -> Record

data/lib/net/connector/templates/index

@@ -0,0 +1,8 @@
+Template, Vendor, Command
+cisco_ios_show_ip_interface_brief.textfsm, cisco_ios, show ip interface brief$
+cisco_cdp_neighbors_detail.textfsm, cisco_ios, show cdp neighbors detail$
+cisco_cdp_neighbors_detail.textfsm, cisco_nxos, show cdp neighbors detail$
+h3c_lldp_name_first.textfsm, h3c, display lldp neighbor-information list$
+h3c_lldp_name_first.textfsm, h3c_wireless, display lldp neighbor-information list$
+hillstone_lldp_neighbors.textfsm, hillstone, show lldp neighbor-information$
+palo_alto_lldp_neighbors.textfsm, palo_alto, show lldp neighbors all$

data/lib/net/connector/templates/palo_alto_interface_descriptions.textfsm

@@ -0,0 +1,6 @@
+Value Required INTERFACE (\S+)
+Value DESCRIPTION (.*)
+
+Start
+  ^set network interface ethernet ${INTERFACE} comment ${DESCRIPTION}$$ -> Record
+  ^set network interface ethernet ${INTERFACE}\s+.*$$ -> Record

data/lib/net/connector/templates/palo_alto_lldp_neighbors.textfsm

@@ -0,0 +1,11 @@
+Value Required LOCAL_INTERFACE (\S+)
+Value NEIGHBOR_NAME (\S+)
+Value CHASSIS_ID (\S+)
+Value Required NEIGHBOR_INTERFACE (\S+)
+
+Start
+  ^\s*Local information:\s*$$ -> Record
+  ^\s*Local interface:\s*${LOCAL_INTERFACE}\s*$$
+  ^\s*Chassis ID:\s*${CHASSIS_ID}\s*$$
+  ^\s*Port ID:\s*${NEIGHBOR_INTERFACE}\s*$$
+  ^\s*System name:\s*${NEIGHBOR_NAME}\s*$$

data/lib/net/connector/templates/radware_port_names.textfsm

@@ -0,0 +1,13 @@
+Value Required INTERFACE (\d+)
+Value DESCRIPTION (.*)
+
+Start
+  ^/(?:c|cfg)/port ${INTERFACE}/name "${DESCRIPTION}"\s*$$ -> Record
+  ^/(?:c|cfg)/port ${INTERFACE}\s*$$ -> Port
+
+Port
+  ^\s+name "${DESCRIPTION}"\s*$$
+  ^\s+name ${DESCRIPTION}$$
+  ^/.* -> Continue.Record
+  ^/(?:c|cfg)/port ${INTERFACE}/name "${DESCRIPTION}"\s*$$ -> Record Start
+  ^/(?:c|cfg)/port ${INTERFACE}\s*$$