TextFSM is a template-based state machine for parsing semi-structured text.

This is an Elixir implementation of the TextFSM library written in Python. TextFSM allows you to define a template that describes the structure of your text (e.g. CLI output from network devices) and parse it into a structured table.

Example

template = """
Value INTERFACE (\\S+)
Value IP_ADDRESS (\\d+\.\\d+\.\\d+\.\\d+|unassigned)
Value STATUS (up|down|administratively down)
Value PROTOCOL (up|down)

Start
  ^${INTERFACE}\\s+${IP_ADDRESS}\\s+\\w+\\s+\\w+\\s+${STATUS}\\s+${PROTOCOL} -> Record
"""

text = """
Interface              IP-Address      OK? Method Status                Protocol
GigabitEthernet0/0     192.168.1.1     YES NVRAM  up                    up
GigabitEthernet0/1     unassigned      YES NVRAM  administratively down down
GigabitEthernet0/2     10.0.0.5        YES manual up                    up
Loopback0              127.0.0.1       YES unset  up                    up
"""

{:ok, result} = TextFSM.parse(template, text)

Result:

%{
  "INTERFACE" => ["GigabitEthernet0/0", "GigabitEthernet0/1",
  "GigabitEthernet0/2", "Loopback0"],
  "IP_ADDRESS" => ["192.168.1.1", "unassigned", "10.0.0.5", "127.0.0.1"],
  "PROTOCOL" => ["up", "down", "up", "up"],
  "STATUS" => ["up", "administratively down", "up", "up"]
}