netstack 0.1.1 → 0.2.0

data/lib/netstack/connector/transports.rb

@@ -0,0 +1,201 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+require "open3"
+require "expect/pty"
+
+module Netstack
+  module Connector
+    # 可替换的字节传输层；厂商语法属于设备边界，不属于此层。
+    module Transports
+      # Expect 适配器拥有伪终端和进程，在限制未匹配尾部时不丢弃数据。
+      class Pty
+        # 即使读到完整行也保留 32 KiB，因为提示符可能跨越多次读取和多行。
+        STREAM = /\A[\s\S]{32768}(?=[\s\S]{32768})/n
+        attr_reader :configuration
+
+        # 保存配置和可替换的信道工厂，便于测试和设备差异注入。
+        def initialize(configuration, channel_factory: nil, terminal_size: nil)
+          @configuration = configuration
+          @channel_factory = channel_factory
+          @terminal_size = terminal_size
+        end
+
+        # 打开伪终端、设置终端大小并启动设备进程。
+        def open
+          configuration.validate_endpoint!
+          @channel = if @channel_factory
+                       @channel_factory.call
+                     else
+                       Expect.new(raw_pty: true, reset_timeout_on_read: false, buffer_limit: nil,
+                                  preserve_buffer: false, log_stdout: false, log_listeners: false,
+                                  debug_level: 0, write_timeout: configuration.write_timeout)
+                     end
+          # Profile 使用宽、高；PTY 使用行数、列数。
+          @channel.slave.winsize = @terminal_size.reverse if @terminal_size
+          @channel.log_output = method(:write_log_output)
+          @channel.spawn(*argv)
+          self
+        rescue Exception # rubocop:disable Lint/RescueException -- A half-open PTY must be released on interrupts.
+          begin
+            close
+          rescue
+            # 尝试释放半打开信道后，仍然抛出原始失败。
+          end
+          raise
+        end
+
+        # 从信道读取下一事件，并把字符串字段转换为字节字符串。
+        def read(patterns, timeout:)
+          # 0.5.3 起 expect 直接返回 Result；旧版 expect 只返回模式序号。
+          result = if @channel.respond_to?(:expect_result)
+                     @channel.expect_result(*patterns, STREAM, timeout: timeout)
+                   else
+                     @channel.expect(*patterns, STREAM, timeout: timeout)
+                   end
+          Event.new(index: result.number && (result.number - 1), before: result.before.to_s.b,
+                    match: result.match.to_s.b, error: result.error)
+        end
+
+        # 临时设置写入超时，完成写入后恢复原设置。
+        def write(bytes, timeout: configuration.write_timeout)
+          previous = @channel.write_timeout
+          @channel.write_timeout = timeout
+          @channel.write(bytes)
+        ensure
+          @channel.write_timeout = previous if @channel
+        end
+
+        # 判断信道尚未建立或已经关闭。
+        def closed? = !@channel || @channel.closed?
+
+        # 设置日志输出目标；nil 表示暂时停止记录。
+        def log_output=(target)
+          @log_target = target
+        end
+
+        # 清除信道和日志目标，并强制关闭底层进程。
+        def close
+          channel = @channel
+          @channel = nil
+          @log_target = nil
+          channel&.hard_close
+        end
+
+        # 把人工交互结果转换为设备 EOF、超时或输入状态。
+        def interact(**)
+          stopped = @channel.interact(**)
+          return :device_eof if stopped.equal?(@channel)
+
+          stopped.nil? ? :timeout : :input
+        end
+
+        # 返回传输主机和关闭状态摘要。
+        def inspect = "#<#{self.class} host=#{configuration.host.inspect} closed=#{closed?}>"
+
+        private
+
+        # 检查缓冲上限并把设备输出写入当前日志目标。
+        def write_log_output(bytes)
+          if @channel.buffer.bytesize > configuration.max_output_bytes
+            raise OutputLimitExceeded.new("transport buffer exceeded max_output_bytes",
+                                          phase: :read, output: @channel.buffer.dup), cause: nil
+          end
+
+          @log_target&.write(bytes)
+          @log_target.flush if @log_target.respond_to?(:flush)
+        end
+      end
+
+      # 生成 OpenSSH 参数，并处理显式请求的旧版协商和主机密钥操作。
+      class Ssh < Pty
+        attr_reader :legacy_arguments
+
+        # 保存旧版 SSH 参数并复用伪终端初始化。
+        def initialize(configuration, legacy_arguments: [], **)
+          super(configuration, **)
+          @legacy_arguments = legacy_arguments.dup.freeze
+        end
+
+        def open
+          configuration.validate_endpoint!
+          unless configuration.host_key_policy == :strict
+            @known_hosts = KnownHosts.new(configuration, replace: @replace_host_key)
+          end
+          super
+        rescue Exception # rubocop:disable Lint/RescueException -- Release a staged trust file on failed startup.
+          close
+          raise
+        end
+
+        def authenticated
+          @known_hosts&.commit
+          @replace_host_key = false
+        end
+
+        def close
+          super
+        ensure
+          @known_hosts&.close
+          @known_hosts = nil
+        end
+
+        # 返回 SSH 协议标识。
+        def protocol = :ssh
+
+        # 根据配置生成经过端点校验的 SSH 参数数组。
+        def argv
+          configuration.validate_endpoint!
+          checking = (configuration.host_key_policy == :strict) ? "yes" : "accept-new"
+          arguments = ["ssh", *legacy_arguments, "-tt", "-o", "StrictHostKeyChecking=#{checking}",
+                       "-o", "NumberOfPasswordPrompts=1", "-o", "UpdateHostKeys=no",
+                       "-o", "ConnectTimeout=#{[configuration.login_timeout.ceil, 1].max}"]
+          known_hosts = @known_hosts&.path || configuration.known_hosts
+          arguments += ["-o", "UserKnownHostsFile=#{known_hosts}"] if known_hosts
+          arguments += ["-p", configuration.port.to_s] if configuration.port
+          arguments + ["-l", configuration.username, configuration.host]
+        end
+
+        # 创建带旧版协商参数的同类传输对象。
+        def with_legacy(arguments)
+          self.class.new(configuration, legacy_arguments: arguments, channel_factory: @channel_factory,
+                         terminal_size: @terminal_size)
+        end
+
+        # 创建不继承 SSH 专用端口的 Telnet 传输对象。
+        def as_telnet
+          Telnet.new(configuration, channel_factory: @channel_factory, terminal_size: @terminal_size)
+        end
+
+        # 恢复只标记下一次会话副本；共享信任文件在认证成功后才更新。
+        def replace_host_key
+          raise IOError, "host key replacement is not enabled" unless configuration.host_key_policy == :replace
+
+          @replace_host_key = true
+        end
+
+      end
+
+      # Telnet 只能显式启用；SSH 专用端口不能带入回退连接。
+      class Telnet < Pty
+        # 返回 Telnet 协议标识。
+        def protocol = :telnet
+
+        # 根据配置生成经过端点校验的 Telnet 参数数组。
+        def argv
+          configuration.validate_endpoint!
+          port = (configuration.protocol == :telnet) ? configuration.port : nil
+          ["telnet", "-l", configuration.username, configuration.host, *(port ? [port.to_s] : [])]
+        end
+      end
+
+      TYPES = { ssh: Ssh, telnet: Telnet }.freeze
+
+      # 按协议选择具体传输实现。
+      def self.build(configuration, **)
+        TYPES.fetch(configuration.protocol).new(configuration, **)
+      end
+    end
+  end
+end

data/lib/netstack/connector/underlying_error.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+require "expect/redactor"
+
+module Netstack
+  module Connector
+    # 安全保存底层异常，不保留包含凭据的原始消息。
+    class UnderlyingError
+      attr_reader :type, :message, :backtrace
+
+      # 保存脱敏后的异常类型、消息和调用栈。
+      def initialize(error, redactor, sensitive: false)
+        @type = error.is_a?(UnderlyingError) ? error.type : error.class.name
+        @message = (sensitive ? "[REDACTED]" : redactor.call(error.message)).freeze
+        @backtrace = (sensitive ? [] : Array(error.backtrace).map { |line| redactor.call(line).freeze }).freeze
+        freeze
+      end
+
+      # 返回底层异常类型摘要。
+      def inspect = "#<#{self.class} type=#{type}>"
+    end
+  end
+end

data/lib/netstack/connector/unsupported_operation.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+require "expect/redactor"
+
+module Netstack
+  module Connector
+    class UnsupportedOperation < Error; end
+  end
+end

data/lib/netstack/connector/vendors/cisco_ios/running_config.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoIos
+        class RunningConfig < Netstack::Connector::RunningConfig::Rendered
+          # 去掉终端长度设置、保存命令回显和易变化的配置时间注释。
+          def clean(text)
+            config = super
+            config.gsub!(/^[^\n]*#\s*terminal\s+length\s+0\s*\n/i, "")
+            config.sub!(/^[^\n]*#\s*copy\s+run(?:ning-config)?\s+(?:start|startup-config)\s*\n.*\z/im, "")
+            config.gsub!(/^!.*(?:Last\s+configuration\s+change|NVRAM\s+config).*\n/i, "")
+            config
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_ios/tftp_backup.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoIos
+        class TftpBackup < Tftp::Strategy
+          # 在连接前拒绝当前厂商不支持的参数组合。
+          def validate_options!(_target, source_file:, vrf: nil)
+            raise ArgumentError, "Cisco IOS does not use source_file" unless source_file.nil?
+            raise ArgumentError, "Cisco IOS TFTP backup does not use vrf" unless vrf.nil?
+          end
+
+          def receipt_metadata(_target, **) = { configuration_kind: :running, format: :cfg }
+
+          # 构造当前厂商的 TFTP 导出交互脚本。
+          def script(target, source_file:, vrf: nil)
+            validate_options!(target, source_file: source_file, vrf: vrf)
+
+            Script.new([Command.new("copy running-config tftp:", timeout: 180,
+                                    interactions: [
+                                      interaction(/Address\s+or\s+name\s+of\s+remote\s+host\s*\[[^\]]*\]\?\s*\z/i,
+                                                  "#{target.host}\n"),
+                                      interaction(/Destination\s+filename\s*\[[^\]]*\]\?\s*\z/i,
+                                                  "#{target.path}\n")
+                                    ])])
+          end
+
+          # 检查设备回显是否确认 TFTP 传输完成。
+          def device_reported_complete?(result)
+            completion_lines(result).any? do |line|
+              copied_bytes?(line) || line.match?(/\A\[OK(?:\s*-\s*[1-9]\d*\s+bytes)?\]\z/i)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_ios/topology.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoIos
+        class Topology < Netstack::Connector::Topology::ImmediateStrategy
+          # IOS 提供 CDP 邻居、配置描述读取和描述变更。
+          def self.supports?(capability)
+            %i[neighbors interface_descriptions interface_description_changes].include?(capability)
+          end
+
+          # 使用详细 CDP 输出获取对端设备与端口。
+          def neighbor_command = "show cdp neighbors detail"
+
+          # 从运行配置解析接口描述。
+          def description_template = "cisco_ios_running_config_interfaces.textfsm"
+
+          # 标记发现协议，供邻居记录使用。
+          def protocol = :cdp
+
+          # 进入全局配置视图。
+          def enter_configuration_command = "configure terminal"
+
+          # 先回到执行视图读回，随后才执行档案中的保存命令。
+          def leave_configuration_commands = ["end"]
+
+          def persistence_pattern = /\A(?:\[OK\]|Copy complete\.)\z/i
+
+          # 每个 Device ID 块都须解析；设备提供总数时还须与块数相符。
+          def expected_neighbor_count(output, _template)
+            count = output.scan(/^\s*Device ID:/i).size
+            totals = output.scan(/^\s*Total cdp entries displayed\s*:\s*(\d+)\b/i).flatten
+            return unless totals.all? { |total| total.to_i == count }
+
+            count
+          end
+
+          # 只有设备明确报告零 CDP 邻居时才认可空表。
+          def empty_neighbor_output?(output)
+            output.match?(/Total cdp entries displayed\s*:\s*0\b|no cdp neighbors/i)
+          end
+
+          # 复用公共接口描述命令，保留本机接口原名。
+          def change_commands(change)
+            Netstack::Connector::Topology::InterfaceDescription.commands(interface: change.interface, description: change.new_description)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_ios.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoIos < Netstack::Connector::Device
+        vendor :cisco_ios
+        # 声明 IOS 的命令、提示、分页、诊断和保存确认规则。
+        profile do
+          running_config_strategy Netstack::Connector::Vendors::CiscoIos::RunningConfig
+          tftp_strategy Netstack::Connector::Vendors::CiscoIos::TftpBackup
+          topology_strategy Netstack::Connector::Vendors::CiscoIos::Topology
+          commands do
+            running_config "terminal length 0", "show running-config"
+            save_config "copy running-config startup-config"
+          end
+
+          prompts do
+            login(/(?:\A|(?<=[\r\n]))\S+[>#]\s*\z/)
+            command(/(?:\A|(?<=[\r\n]))\S+#\s*\z/)
+          end
+
+          pager do
+            pattern(/(?:\A|(?<=[\r\n]))[^\S\r\n]*--More--[^\r\n]*(?=\r|\n|\z)/i)
+          end
+
+          errors do
+            command(/^[ \t]*%[ \t]+(?:Invalid|Incomplete|Ambiguous)\s+(?:input|command)\b/i, /^[ \t]*\^/)
+          end
+
+          command_timeout 60
+
+          interactions do
+            confirm(/Destination\s+filename\s+\[[^\]]+\]\?\s*\z/i, response: "\n")
+            confirm(%r{Do\s+you\s+want\s+to\s+overwrite\?\s*\[yes/no\]\s*\z}i, response: "yes\n")
+            confirm(/Proceed\s+with\s+copy\?\s*\[confirm\]\s*\z/i, response: "\n")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_nxos/running_config.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoNxos
+        class RunningConfig < CiscoIos::RunningConfig
+          # 先清除 NX-OS 分页与进度回显，再复用 IOS 的配置清理规则。
+          def clean(text)
+            without_pager = text.to_s.gsub(
+              /[ \t]*(?:\x1b\[[0-9;]*[A-Za-z])*--More--
+                (?:\x1b\[[0-9;]*[A-Za-z])*(?:[\r\x00\x08 ]|\x1b\[[0-9;]*[A-Za-z])*/ix, ""
+            )
+            config = super(without_pager)
+            config.sub!(/\A.*?^(?=[^\n]*#\s*show\s+running-config\s*$)/im, "")
+            config.gsub(/^[ \t]*(?:\[[# ]*\]|\])[ \t]*\d+%[ \t]*\n?/i, "")
+                  .gsub(/^[ \t]*Copy\s+complete\b[^\n]*\n?/i, "")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_nxos/tftp_backup.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoNxos
+        class TftpBackup < Tftp::Strategy
+          # 在连接前拒绝当前厂商不支持的参数组合。
+          def validate_options!(_target, source_file:, **)
+            raise ArgumentError, "Cisco NX-OS does not use source_file" unless source_file.nil?
+          end
+
+          def receipt_metadata(_target, **) = { configuration_kind: :running, format: :cfg }
+
+          # 构造当前厂商的 TFTP 导出交互脚本。
+          def script(target, source_file:, vrf: nil)
+            validate_options!(target, source_file: source_file, vrf: vrf)
+
+            vrf ||= "management"
+            command = "copy running-config tftp://#{target.host}/#{target.path} vrf #{vrf}"
+            Script.new([Command.new(command, timeout: 180,
+                                    interactions: [
+                                      interaction(/Enter\s+vrf\s*\([^\r\n]*\):\s*\z/i,
+                                                  "#{vrf}\n")
+                                    ])])
+          end
+
+          # 检查设备回显是否确认 TFTP 传输完成。
+          def device_reported_complete?(result)
+            completion_lines(result).any? do |line|
+              line.match?(/\A
+                (?:transfer|copy)(?:\s+operation)?\s+
+                (?:success(?:ful(?:ly)?)?|succeeded|complete(?:d)?(?:\s+successfully)?)[.!]?
+                \z/ix) || copied_bytes?(line)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/cisco_nxos.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class CiscoNxos < Netstack::Connector::Device
+        vendor :cisco_nxos
+        # 声明 NX-OS 的命令、提示、分页、诊断和保存确认规则。
+        profile do
+          running_config_strategy Netstack::Connector::Vendors::CiscoNxos::RunningConfig
+          tftp_strategy Netstack::Connector::Vendors::CiscoNxos::TftpBackup
+          topology_strategy Netstack::Connector::Vendors::CiscoIos::Topology
+          commands do
+            running_config "terminal length 0", "show running-config"
+            save_config "copy run start"
+          end
+
+          prompts do
+            login(/\S+[>#]\s*\z/)
+            command(/\S+#\s*\z/)
+          end
+
+          pager do
+            pattern(/(?:\A|(?<=[\r\n]))[ \t]*(?:\x1b\[[0-9;]*[A-Za-z])*--More--
+              (?:[ \t\x00\x08]|\x1b\[[0-9;]*[A-Za-z])*(?=\r|\n|\z)/ix)
+          end
+
+          errors do
+            command(
+              /^[ \t]*%?[ \t]*(?:(?:Invalid|Ambiguous|Incomplete)\s+command(?:\s+\([^)]+\))?|
+                Invalid\s+parameter\s+detected)\s+at\s+'\^'\s+marker\./ix,
+              /^[ \t]*\^/,
+              /^[ \t]*%[ \t]+(?:Invalid|Ambiguous|Incomplete)\s+command\b/i,
+              /^[ \t]*%?[ \t]*Invalid\s+parameter\s+detected\b/i,
+              /^[ \t]*syntax\s+error\b/i
+            )
+          end
+
+          command_timeout 60
+
+          interactions do
+            confirm(/Destination\s+filename\s+\[[^\]]+\]\?\s*\z/i, response: "\n")
+            confirm(%r{Do\s+you\s+want\s+to\s+overwrite\?\s*\[yes/no\]\s*\z}i, response: "yes\n")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/h3c/tftp_backup.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class H3c
+        class TftpBackup < Tftp::FileUpload
+          # 自动探测选择的是启动配置；显式文件仍不能推断为运行或启动配置。
+          def receipt_metadata(target, source_file:, explicit_source:)
+            super.merge(configuration_kind: explicit_source ? :saved_file : :startup)
+          end
+
+          # 选取并校验 H3C 启动配置文件路径。
+          def resolve_source_file(value)
+            return TftpTarget.validate_source_file!(value) if value
+
+            output = @device.execute_command("display startup").value!
+            rendered = TerminalRenderer.render(output)
+            path = rendered[/^\s*Next main startup saved-configuration file:\s*(\S+)/i, 1]
+            path ||= rendered[/^\s*Current startup saved-configuration file:\s*(\S+)/i, 1]
+            if path.nil? || path.casecmp?("NULL")
+              raise DeviceError.new("device has no saved startup configuration",
+                                    code: :startup_config_missing, host: @device.host, phase: :tftp_backup)
+            end
+
+            TftpTarget.validate_source_file!(path.sub(/\(\*\)\z/, ""))
+          end
+        end
+      end
+    end
+  end
+end

data/lib/netstack/connector/vendors/h3c/topology.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+# Adapted from net-connector; copyright (c) 2026 net-connector contributors (MIT).
+
+module Netstack
+  module Connector
+    module Vendors
+      class H3c
+        class Topology < Netstack::Connector::Topology::ImmediateStrategy
+          TABLE_HEADER = /^\s*(?:System Name\s+Local Interface\b|(?:Local Interface|LocalIf)\s+)/i
+          # H3C 提供 LLDP 邻居、配置描述读取和描述变更。
+          def self.supports?(capability)
+            %i[neighbors interface_descriptions interface_description_changes].include?(capability)
+          end
+
+          # 读取设备的 LLDP 邻居列表。
+          def neighbor_command = "display lldp neighbor-information list"
+
+          # 从运行配置解析当前接口描述。
+          def description_template = "h3c_interface_descriptions.textfsm"
+
+          # 进入系统视图以修改接口描述。
+          def enter_configuration_command = "system-view"
+
+          # 返回用户视图读回；保存交给后续独立阶段。
+          def leave_configuration_commands = ["return"]
+
+          def persistence_pattern = /\ASaved the current configuration to mainboard device successfully\.\z/i
+
+          # H3C 不同版本的列顺序不同，按表头选对应模板。
+          def neighbor_template(output)
+            return "h3c_lldp_name_first.textfsm" if output.match?(/^\s*System Name\s+Local Interface\b/im)
+            return "h3c_lldp_local_first.textfsm" if output.match?(/^\s*(?:Local Interface|LocalIf)\s+/im)
+
+            raise ParsingError.new("H3C LLDP table header was not recognized", code: :unrecognized_output,
+                                   host: @device.host, phase: :discover)
+          end
+
+          # 按表头后的有效数据行计数，未知行会让完整性校验失败。
+          def expected_neighbor_count(output, template)
+            local_column = template == "h3c_lldp_name_first.textfsm" ? 1 : 0
+            lines = neighbor_lines(output)
+            return unless lines.all? do |line|
+              interface = line.split.fetch(local_column, nil)
+              interface&.match?(/\A[A-Za-z][A-Za-z-]*\d+(?:\/\d+)+\z/)
+            end
+
+            lines.size
+          end
+
+          # 表头之后的未知行不能作为零邻居证据。
+          def empty_neighbor_output?(output) = neighbor_lines(output).empty?
+
+          # 在接口视图设置描述后用 quit 返回系统视图。
+          def change_commands(change)
+            Netstack::Connector::Topology::InterfaceDescription.commands(interface: change.interface, description: change.new_description, leave: "quit")
+          end
+
+          private
+
+          # 过滤表头、分隔线和设备提示符，保留待解析的邻居行。
+          def neighbor_lines(output)
+            output.lines.drop_while { |line| !line.match?(TABLE_HEADER) }.map(&:strip).reject do |line|
+              line.empty? || line.match?(TABLE_HEADER) || line.match?(/\A[-=+ ]+\z/) ||
+                line.match?(/\A(?:<[^>]+>|\[[^\]]+\])\z/)
+            end
+          end
+        end
+      end
+    end
+  end
+end