textfsm 0.2.0

data/examples/cisco_version_example

@@ -0,0 +1,40 @@
+Cisco IOS Software, Catalyst 4500 L3 Switch Software (cat4500-ENTSERVICESK9-M), Version 12.2(31)SGA1, RELEASE SOFTWARE (fc3)
+Technical Support: http://www.cisco.com/techsupport
+Copyright (c) 1986-2007 by Cisco Systems, Inc.
+Compiled Fri 26-Jan-07 14:28 by kellythw
+Image text-base: 0x10000000, data-base: 0x118AD800
+
+ROM: 12.2(31r)SGA
+Pod Revision 0, Force Revision 34, Gill Revision 20
+
+router.abc uptime is 3 days, 13 hours, 53 minutes
+System returned to ROM by reload
+System restarted at 05:09:09 PDT Wed Apr 2 2008
+System image file is "bootflash:cat4500-entservicesk9-mz.122-31.SGA1.bin"
+
+
+This product contains cryptographic features and is subject to United
+States and local country laws governing import, export, transfer and
+use. Delivery of Cisco cryptographic products does not imply
+third-party authority to import, export, distribute or use encryption.
+Importers, exporters, distributors and users are responsible for
+compliance with U.S. and local country laws. By using this product you
+agree to comply with applicable laws and regulations. If you are unable
+to comply with U.S. and local laws, return this product immediately.
+
+A summary of U.S. laws governing Cisco cryptographic products may be found at:
+http://www.cisco.com/wwl/export/crypto/tool/stqrg.html
+
+If you require further assistance please contact us by sending email to export@cisco.com.
+
+cisco WS-C4948-10GE (MPC8540) processor (revision 5) with 262144K bytes of memory.
+Processor board ID FOX111700ZP
+MPC8540 CPU at 667Mhz, Fixed Module
+Last reset from Reload
+2 Virtual Ethernet interfaces
+48 Gigabit Ethernet interfaces
+2 Ten Gigabit Ethernet interfaces
+511K bytes of non-volatile configuration memory.
+
+Configuration register is 0x2102
+

data/examples/cisco_version_template

@@ -0,0 +1,17 @@
+Value Model (\S+)
+Value Memory (\S+)
+Value ConfigRegister (0x\S+)
+Value Uptime (.*)
+Value Version (.*?)
+Value ReloadReason (.*)
+Value ReloadTime (.*)
+Value ImageFile ([^"]+)
+
+Start
+  ^Cisco IOS Software.*Version ${Version},
+  ^.*uptime is ${Uptime}
+  ^System returned to ROM by ${ReloadReason}
+  ^System restarted at ${ReloadTime}
+  ^System image file is "${ImageFile}"
+  ^cisco ${Model} .* with ${Memory} bytes of memory
+  ^Configuration register is ${ConfigRegister}

data/examples/f10_ip_bgp_summary_example

@@ -0,0 +1,16 @@
+BGP router identifier 192.0.2.1, local AS number 65551
+BGP table version is 173711, main routing table version 173711
+255 network entrie(s) using 43260 bytes of memory
+1114 paths using 75752 bytes of memory
+BGP-RIB over all using 76866 bytes of memory
+23 BGP path attribute entrie(s) using 1472 bytes of memory
+3 BGP AS-PATH entrie(s) using 137 bytes of memory
+10 BGP community entrie(s) using 498 bytes of memory
+2 BGP route-reflector cluster entrie(s) using 62 bytes of memory
+6 neighbor(s) using 28128 bytes of memory
+
+Neighbor        AS            MsgRcvd  MsgSent     TblVer  InQ  OutQ Up/Down  State/Pfx
+
+10.10.10.10     65551             647      397      73711    0   (0) 10:37:12         5
+10.10.100.1     65552             664      416      73711    0   (0) 10:38:27         0
+10.100.10.9     65553             709      526      73711    0   (0) 07:55:38         1

data/examples/f10_ip_bgp_summary_template

@@ -0,0 +1,15 @@
+Value Filldown RouterID (\d+(\.\d+){3})
+Value Filldown LocalAS (\d+)
+Value RemoteAS (\d+)
+Value Required RemoteIP (\d+(\.\d+){3})
+Value Uptime (\S+)
+Value Received_V4 (\d+)
+Value Received_V6 ()
+Value Status (\D.*)
+
+Start
+  ^BGP router identifier ${RouterID}, local AS number ${LocalAS}
+  ^${RemoteIP}\s+${RemoteAS}(\s+\S+){5}\s+${Uptime}\s+${Received_V4} -> Next.Record
+  ^${RemoteIP}\s+${RemoteAS}(\s+\S+){5}\s+${Uptime}\s+${Status} -> Next.Record
+
+EOF

data/examples/f10_version_example

@@ -0,0 +1,25 @@
+Force10 Networks Real Time Operating System Software
+Force10 Operating System Version: 1.0
+Force10 Application Software Version: 7.7.1.1
+Copyright (c) 1999-2008 by Force10 Networks, Inc.
+Build Time: Fri Sep 12 14:08:26 PDT 2008
+Build Path: /sites/sjc/work/sw/build/special_build/Release/E7-7-1/SW/SRC
+router.abc uptime is 3 day(s), 2 hour(s), 3 minute(s)
+
+System image file is "flash://FTOS-EF-7.7.1.1.bin"
+
+Chassis Type: E1200
+Control Processor: IBM PowerPC 750FX (Rev D2.2) with 536870912 bytes of memory.
+Route Processor 1: IBM PowerPC 750FX (Rev D2.2) with 1073741824 bytes of memory.
+Route Processor 2: IBM PowerPC 750FX (Rev D2.2) with 1073741824 bytes of memory.
+
+128K bytes of non-volatile configuration memory.
+
+  1 Route Processor Module
+  9 Switch Fabric Module
+  1 48-port GE line card with SFP optics (EF)
+  7 4-port 10GE LAN/WAN PHY line card with XFP optics (EF)
+  1 FastEthernet/IEEE 802.3 interface(s)
+ 48 GigabitEthernet/IEEE 802.3 interface(s)
+ 28 Ten GigabitEthernet/IEEE 802.3 interface(s)
+

data/examples/f10_version_template

@@ -0,0 +1,10 @@
+Value Chassis (\S+)
+Value Model (.*)
+Value Software (.*)
+Value Image ([^"]*)
+
+Start
+  ^Force10 Application Software Version: ${Software}
+  ^Chassis Type: ${Chassis} -> Continue
+  ^Chassis Type: ${Model}
+  ^System image file is "${Image}"

data/examples/index

@@ -0,0 +1,14 @@
+
+# First line is the header fields for columns and is mandatory.
+# Regular expressions are supported in all fields except the first.
+# Last field supports variable length command completion.
+# abc[[xyz]] is expanded to abc(x(y(z)?)?)?, regexp inside [[]] is not supported
+#
+Template, Hostname, Vendor, Command
+cisco_bgp_summary_template, .*, Cisco, sh[[ow]] ip bg[[p]] su[[mmary]]
+cisco_version_template, .*, Cisco, sh[[ow]] ve[[rsion]]
+f10_ip_bgp_summary_template, .*, Force10, sh[[ow]] ip bg[[p]] sum[[mary]]
+f10_version_template, .*, Force10, sh[[ow]] ve[[rsion]]
+juniper_bgp_summary_template, .*,  Juniper, sh[[ow]] bg[[p]] su[[mmary]]
+juniper_version_template, .*, Juniper, sh[[ow]] ve[[rsion]]
+unix_ifcfg_template, hostname[abc].*, .*, ifconfig

data/examples/juniper_bgp_summary_example

@@ -0,0 +1,12 @@
+Groups: 3 Peers: 3 Down peers: 0
+Table          Tot Paths  Act Paths Suppressed    History Damp State    Pending
+inet.0               947        310          0          0          0          0
+inet6.0              849        807          0          0          0          0
+Peer                     AS      InPkt     OutPkt    OutQ   Flaps Last Up/Dwn State|#Active/Received/Damped...
+10.247.68.182         65550     131725   28179233       0      11     6w3d17h Establ
+  inet.0: 4/5/1
+  inet6.0: 0/0/0
+10.254.166.246        65550     136159   29104942       0       0      6w5d6h Establ
+  inet.0: 0/0/0
+  inet6.0: 7/8/1
+192.0.2.100           65551    1269381    1363320       0       1      9w5d6h 2/3/0 0/0/0

data/examples/juniper_bgp_summary_template

@@ -0,0 +1,22 @@
+Value RemoteAS (\d+)
+Value RemoteIP (\S+)
+Value Uptime (.*[0-9h])
+Value Active_V4 (\d+)
+Value Received_V4 (\d+)
+Value Accepted_V4 (\d+)
+Value Damped_V4 (\d+)
+Value Active_V6 (\d+)
+Value Received_V6 (\d+)
+Value Accepted_V6 (\d+)
+Value Damped_V6 (\d+)
+Value Status ([a-zA-Z]+)
+
+Start
+  # New format IPv4 & IPv6 split across newlines.
+  ^\s+inet.0: ${Active_V4}/${Received_V4}/${Damped_V4}
+  ^\s+inet6.0: ${Active_V6}/${Received_V6}/${Damped_V6}
+  ^ -> Continue.Record
+  ^${RemoteIP}\s+${RemoteAS}(\s+\d+){4}\s+${Uptime}\s+${Status}
+  ^${RemoteIP}\s+${RemoteAS}(\s+\d+){4}\s+${Uptime}\s+${Active_V4}/${Received_V4}/${Damped_V4}\s+${Active_V6}/${Received_V6}/${Damped_V6} -> Next.Record
+  ^${RemoteIP}\s+${RemoteAS}(\s+\d+){4}\s+${Uptime}\s+${Active_V4}/${Received_V4}/${Accepted_V4}/${Damped_V4}\s+${Active_V6}/${Received_V6}/${Accepted_V6}/${Damped_V6} -> Next.Record
+  ^${RemoteIP}\s+${RemoteAS}(\s+\d+){4}\s+${Uptime}\s+${Status} -> Next.Record

data/examples/juniper_version_example

@@ -0,0 +1,10 @@
+Hostname: router.abc
+Model: mx960
+JUNOS Base OS boot [9.1S3.5]
+JUNOS Base OS Software Suite [9.1S3.5]
+JUNOS Kernel Software Suite [9.1S3.5]
+JUNOS Crypto Software Suite [9.1S3.5]
+JUNOS Packet Forwarding Engine Support (M/T Common) [9.1S3.5]
+JUNOS Packet Forwarding Engine Support (MX Common) [9.1S3.5]
+JUNOS Online Documentation [9.1S3.5]
+JUNOS Routing Software Suite [9.1S3.5]

data/examples/juniper_version_template

@@ -0,0 +1,21 @@
+Value Chassis (\S+)
+Value Required Model (\S+)
+Value Boot (.*)
+Value Base (.*)
+Value Kernel (.*)
+Value Crypto (.*)
+Value Documentation (.*)
+Value Routing (.*)
+
+Start
+# Support multiple chassis systems.
+  ^\S+:$$ -> Continue.Record
+  ^${Chassis}:$$
+  ^Model: ${Model}
+  ^JUNOS Base OS boot \[${Boot}\]
+  ^JUNOS Software Release \[${Base}\]
+  ^JUNOS Base OS Software Suite \[${Base}\]
+  ^JUNOS Kernel Software Suite \[${Kernel}\]
+  ^JUNOS Crypto Software Suite \[${Crypto}\]
+  ^JUNOS Online Documentation \[${Documentation}\]
+  ^JUNOS Routing Software Suite \[${Routing}\]

data/examples/unix_ifcfg_example

@@ -0,0 +1,16 @@
+lo0: flags=8049<UP,LOOPBACK,RUNNING,MULTICAST> mtu 16384
+	inet6 ::1 prefixlen 128
+	inet6 fe80::1%lo0 prefixlen 64 scopeid 0x1
+	inet 127.0.0.1 netmask 0xff000000
+en0: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+	ether 34:15:9e:27:45:e3
+	inet6 fe80::3615:9eff:fe27:45e3%en0 prefixlen 64 scopeid 0x4
+	inet6 2001:db8::3615:9eff:fe27:45e3 prefixlen 64 autoconf
+	inet 192.0.2.215 netmask 0xfffffe00 broadcast 192.0.2.255
+	media: autoselect (1000baseT <full-duplex,flow-control>)
+	status: active
+en1: flags=8863<UP,BROADCAST,SMART,RUNNING,SIMPLEX,MULTICAST> mtu 1500
+	ether 90:84:0d:f6:d1:55
+	media: <unknown subtype> (<unknown type>)
+	status: inactive
+

data/examples/unix_ifcfg_template

@@ -0,0 +1,18 @@
+Value Required Interface ([^:]+)
+Value MTU (\d+)
+Value State ((in)?active)
+Value MAC ([\d\w:]+)
+Value List Inet ([\d\.]+)
+Value List Netmask (\S+)
+# Don't match interface local (fe80::/10) - achieved with excluding '%'.
+Value List Inet6 ([^%]+)
+Value List Prefix (\d+)
+
+Start
+  # Record interface record (if we have one).
+  ^\S+:.* -> Continue.Record
+  # Collect data for new interface.
+  ^${Interface}:.* mtu ${MTU}
+  ^\s+ether ${MAC}
+  ^\s+inet6 ${Inet6} prefixlen ${Prefix}
+  ^\s+inet ${Inet} netmask ${Netmask}

data/exe/textfsm

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/textfsm/cli"
+
+exit TextFSM::CLI.run

data/lib/textfsm/cli.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+require "json"
+require "optparse"
+require_relative "version"
+require_relative "parser"
+
+module TextFSM
+  class CLI
+    def self.run(argv = ARGV, **streams)
+      new(**streams).run(argv)
+    end
+
+    def initialize(input: $stdin, output: $stdout, error: $stderr)
+      @input = input
+      @output = output
+      @error = error
+    end
+
+    def run(argv)
+      settings = { format: "json", rows: false, validate: false, help: false, version: false }
+      options = option_parser(settings)
+      args = options.parse(argv.dup)
+      if settings[:help] || settings[:version]
+        @output.puts(settings[:help] ? options : VERSION)
+        return 0
+      end
+      raise OptionParser::InvalidArgument, "expected TEMPLATE and optional INPUT" unless (1..2).cover?(args.length)
+
+      parser = Parser.from_file(args.first)
+      if settings[:validate]
+        @output.puts("Template OK: #{parser.header.join(', ')}")
+        return 0
+      end
+      text = args[1] && args[1] != "-" ? File.read(args[1], encoding: "UTF-8") : @input.read
+      rows = parser.parse(text)
+      write_result(parser.header, rows, settings)
+      0
+    rescue Error, OptionParser::ParseError, SystemCallError, IOError, ArgumentError => e
+      @error.puts("textfsm: #{e.message}")
+      2
+    end
+
+    private
+
+    def option_parser(settings)
+      OptionParser.new do |parser|
+        parser.banner = "Usage: textfsm [options] TEMPLATE [INPUT|-]"
+        parser.on("--format FORMAT", %w[json table], "Output format: json (default), table") do |format|
+          settings[:format] = format
+        end
+        parser.on("--rows", "JSON output as {header, rows}") do
+          settings[:rows] = true
+        end
+        parser.on("--validate", "Validate template without parsing input") do
+          settings[:validate] = true
+        end
+        parser.on("-v", "--version", "Print version") do
+          settings[:version] = true
+        end
+        parser.on("-h", "--help", "Print help") do
+          settings[:help] = true
+        end
+      end
+    end
+
+    def write_result(header, rows, settings)
+      if settings[:format] == "json"
+        data = settings[:rows] ? { header: header, rows: rows } : rows.map { |row| header.zip(row).to_h }
+        @output.puts(JSON.pretty_generate(data))
+      else
+        @output.puts(header.join("\t"))
+        rows.each do |row|
+          @output.puts(row.map { |value| value.is_a?(String) ? value : JSON.generate(value) }.join("\t"))
+        end
+      end
+    end
+  end
+end

data/lib/textfsm/cli_table.rb

@@ -0,0 +1,92 @@
+# frozen_string_literal: true
+
+# Ruby port of Google TextFSM CLI tables. Copyright 2022 Google Inc.
+# Modified in 2026. Licensed under Apache-2.0; see LICENSE.
+require_relative "parser"
+require_relative "index_table"
+require_relative "table"
+
+module TextFSM
+  class CliTable < Table
+    attr_reader :index, :template_dir, :input, :keys
+
+    def initialize(index: nil, template_dir: ".")
+      super()
+      @template_dir = File.path(template_dir).dup.freeze
+      @keys = [].freeze
+      load_index(index) if index
+    end
+
+    def load_index(path)
+      candidate = IndexTable.new(
+        File.join(@template_dir, path),
+        transform: ->(key, value) { key == "Command" ? expand_command(value) : value },
+        compile: ->(key, value) { key == "Template" ? nil : value }
+      )
+      raise IndexError, "Index must contain a Template column" unless candidate.header.include?("Template")
+
+      @index = candidate
+      self
+    end
+
+    def parse(text, attributes: {}, templates: nil)
+      names = template_names(templates || find_templates(attributes))
+      text = text.read if text.respond_to?(:read)
+      raise ArgumentError, "text must be a String or readable IO" unless text.is_a?(String)
+
+      keys = []
+      table = names.reduce(nil) do |result, name|
+        parser = Parser.from_file(File.join(@template_dir, name))
+        keys = parser.fields_with_option("Key") if keys.empty?
+        parsed = Table.new(parser.header, parser.parse(text))
+        result ? result.merge!(parsed, keys: keys) : parsed
+      end
+      # Replace the result only after every template and merge succeeds.
+      input = text.dup.freeze
+      keys = Data.copy(keys, immutable: true)
+      @input = input
+      @header = table.header
+      @rows = table.rows
+      @keys = keys
+      self
+    end
+
+    def keys=(columns)
+      missing = columns - @header
+      raise KeyError, "Unknown key columns: #{missing.join(', ')}" unless missing.empty?
+
+      @keys = Data.copy(columns.uniq, immutable: true)
+    end
+
+    def key_for(row)
+      row.values_at(*@keys.map { |key| @header.index(key) })
+    end
+
+    private
+
+    def find_templates(attributes)
+      raise IndexError, "Provide templates or load an index" unless @index
+
+      row = @index.match(attributes)
+      raise IndexError, "No template found for attributes: #{attributes.inspect}" unless row
+
+      row.fetch("Template")
+    end
+
+    def template_names(templates)
+      raise ArgumentError, "templates must be a String or an Array of names" unless templates.is_a?(String) || templates.is_a?(Array)
+
+      names = templates.is_a?(Array) ? templates : templates.split(":", -1)
+      raise ArgumentError, "Template list cannot be empty" if names.empty? || names.any? { |name| !name.is_a?(String) || name.strip.empty? }
+
+      names.map(&:strip)
+    end
+
+    def expand_command(command)
+      command.gsub(/\[\[(.+?)\]\]/) do
+        word = Regexp.last_match(1)
+        "(#{word.each_char.to_a.join('(')}#{')?' * word.length}"
+      end
+    end
+  end
+end

data/lib/textfsm/data.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module TextFSM
+  # Records contain nested lists and named captures. Every ownership boundary
+  # copies these values; callers can request an immutable result snapshot.
+  module Data
+    def self.copy(value, immutable: false)
+      result = case value
+               when Array
+                 value.map { |item| copy(item, immutable: immutable) }
+               when Hash
+                 value.to_h do |key, item|
+                   [copy(key, immutable: immutable), copy(item, immutable: immutable)]
+                 end
+               else
+                 value.dup
+               end
+      immutable ? result.freeze : result
+    end
+  end
+
+  private_constant :Data
+end

data/lib/textfsm/errors.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module TextFSM
+  class Error < StandardError; end
+  class TemplateError < Error; end
+  class ParseError < Error; end
+  class IndexError < Error; end
+end

data/lib/textfsm/field.rb

@@ -0,0 +1,83 @@
+# frozen_string_literal: true
+
+# Ruby port of Google TextFSM values. Copyright 2010 Google Inc.
+# Modified in 2026. Licensed under Apache-2.0; see LICENSE.
+require_relative "errors"
+require_relative "options"
+require_relative "pattern"
+
+module TextFSM
+  class Field
+    attr_reader :parser, :name, :source, :capture_source, :option_names, :pattern
+    attr_accessor :value
+
+    def initialize(line, parser:, options: Options::BUILTINS)
+      @parser = parser
+      parse_declaration(line)
+      @pattern = Pattern.new(@source)
+      @capture_source = "(?P<#{@name}>#{@source[1..]}".freeze
+      @options = @option_names.map do |name|
+        options.fetch(name) { raise TemplateError, "Unknown option #{name.inspect}" }.new(self)
+      end.freeze
+      @options.each(&:after_initialize)
+    end
+
+    def option?(name)
+      @option_names.include?(name)
+    end
+
+    def visible?
+      @options.all?(&:visible?)
+    end
+
+    def empty?
+      !@value || (@value.respond_to?(:empty?) && @value.empty?)
+    end
+
+    def assign(value)
+      @value = value
+      @options.each(&:after_assign)
+    end
+
+    def clear
+      @value = nil
+      @options.each(&:after_clear)
+    end
+
+    def reset
+      @value = nil
+      @options.each(&:after_reset)
+    end
+
+    def prepare_record
+      @options.each(&:before_record)
+    end
+
+    def to_s
+      ["Value", (@option_names.join(",") unless @option_names.empty?), @name, @source].compact.join(" ")
+    end
+
+    private
+
+    def parse_declaration(line)
+      # The template grammar splits on literal spaces, including empty fields.
+      tokens = line.split(/ /, -1)
+      raise TemplateError, "Expect at least 3 tokens in Value declaration" if tokens.length < 3
+
+      if tokens[2].start_with?("(")
+        @name = tokens[1].freeze
+        @source = tokens[2..].join(" ").freeze
+        @option_names = [].freeze
+      else
+        @name = tokens[2].freeze
+        @source = tokens[3..].join(" ").freeze
+        @option_names = tokens[1].split(",", -1).map(&:freeze).freeze
+      end
+      raise TemplateError, "Invalid Value name #{@name.inspect}" unless @name.match?(/\A[a-zA-Z_][a-zA-Z_0-9]*\z/) && @name.length <= 48
+      raise TemplateError, "Duplicate option" if @option_names.uniq != @option_names
+      return if @source.start_with?("(") && @source.end_with?(")")
+
+      raise TemplateError, "Value #{@source.inspect} must be contained within a '()' pair"
+    end
+  end
+end

data/lib/textfsm/index_table.rb

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+# Ruby port of Google TextFSM index matching. Copyright 2022 Google Inc.
+# Modified in 2026. Licensed under Apache-2.0; see LICENSE.
+require_relative "errors"
+require_relative "pattern"
+require_relative "data"
+
+module TextFSM
+  class IndexTable
+    include Enumerable
+
+    attr_reader :header
+
+    def initialize(path, transform: nil, compile: nil)
+      @header, @rows = Data.copy(read_table(path, transform), immutable: true)
+      @patterns = @rows.map do |row|
+        row.to_h do |key, value|
+          value = compile.call(key, value) if compile
+          [key, value.nil? || value.empty? ? nil : Pattern.new(value)]
+        end.freeze
+      end.freeze
+      freeze
+    rescue TemplateError => e
+      raise IndexError, "#{path}: #{e.message}"
+    end
+
+    def each(&)
+      return enum_for(__method__) { size } unless block_given?
+
+      @rows.each(&)
+      self
+    end
+
+    def size
+      @rows.size
+    end
+
+    def empty?
+      @rows.empty?
+    end
+
+    def [](index)
+      @rows[index]
+    end
+
+    # Empty cells are wildcards. Attributes absent from the index are ignored.
+    def match(attributes)
+      index = @patterns.index do |patterns|
+        attributes.all? do |key, value|
+          pattern = patterns[key.to_s]
+          pattern.nil? || pattern.match?(value.to_s)
+        end
+      end
+      @rows[index] if index
+    end
+
+    private
+
+    def read_table(path, transform)
+      lines = File.foreach(path, encoding: "UTF-8")
+      header = nil
+      rows = []
+      lines.each do |raw|
+        line = raw.strip
+        next if line.empty? || line.start_with?("#")
+
+        line = line.split("#", 2).first.rstrip unless header
+
+        fields = line.split(",", -1).map(&:strip)
+        unless header
+          header = fields
+          raise IndexError, "Duplicate index header" unless header.uniq == header
+
+          next
+        end
+        next unless fields.size == header.size
+
+        row = header.zip(fields).to_h
+        row = row.to_h { |key, value| [key, transform.call(key, value)] } if transform
+        rows << row
+      end
+      raise IndexError, "Missing index header" unless header
+
+      [header, rows]
+    end
+  end
+end