Release Notes¶

0.5.7¶

BUGS¶

Fixing cisco_xr_show_bgp_neighbors.txt template dynamic BGP peers ASN parsing
Fixing juniper_junos_process_show_configuration_interfaces_pipe_display_set extraction of ips for interfaces with virtual gateways
Fixing juniper_junos_process_show_configuration_interfaces_pipe_display_set parent assignment logic - skip it for irb and lo0 interfaces
Fixing juniper_junos_process_show_configuration_interfaces_pipe_display_set to check if bridge port has sub-interface when trying to derive untagged vlan

0.5.6¶

CHANGES¶

Changing get/interfaces lag to be a parent lag name and adding lag_id attribute
get/interfaces for Arista adding interfaces speeds map
Enhancing get/interfaces for Arista to calculate access VLAN id for SVI interfaces
Changing vrf to be None for get bgp peerings, if BGP peering belongs to global/default/master VRF

TEMPLATES¶

Added platform/cisco_xr_show_running_config_interface.txt refactoring to alight with interfaces getter data
Added platform/juniper_junos_show_configuration_interfaces_pipe_display_set.txt template
Added platform/arista_eos_show_lldp_neighbors_detail_pipe_json.txt template
Added get/lldp_neighbors.txt getter template supporting Arista EOS
Added platform/juniper_junos_show_lldp_neighbors_detail_pipe_display_json.txt template

0.5.5¶

CHANGES¶

Changing Arista EOS bgp neighbor template to use "show ip bgp .." command instead of "show bgp .." command

0.5.4¶

BUGS¶

Fixing VRF handling for platform/cisco_xr_show_bgp_neighbors.txt template.
Fixing BGP peer local ip handling for platform/cisco_xr_show_bgp_neighbors.txt template for newer IOS XR syntax
Fixing bgp peer group extraction for platform/arista_eos_show_bgp_neighbors_vrf_all_pipe_json.txt template for newer JSON format

0.5.3¶

TEMPLATES¶

platform/arista_eos_show_running_config_section_interface
get/interfaces.txt

CHANGES¶

bgp neighbors templates now return local_as and remote_as as integers not strings.
Removed filtering of built-in modules for Junos inventory in get_inventory getter.

0.5.2¶

TEMPLATES¶

platform/arista_eos_show_bgp_neighbors_vrf_all_pipe_json.txt
get/bgp_neighbors.txt
platform/juniper_junos_show_bgp_neighbor_pipe_display_json.txt
platform/cisco_xr_show_bgp_neighbors.txt

0.5.1¶

CHANGES¶

Enhancing get results return to return only parsing result for matched template

0.5.0¶

Features¶

get template collection – new ttp_templates/get/ directory holds getter templates modelled after NAPALM getters. Each getter bundles platform-specific <extend> references and returns a normalised, platform-agnostic structure regardless of which vendor's output is supplied.
inventory getter template – first getter: get/inventory.txt supports Cisco IOS-XR (cisco_xr), Cisco NXOS (cisco_nxos, nxos), Arista EOS (arista_eos, eos), and Juniper Junos (juniper_junos, junos). Returns a list of dicts with keys slot, description, module, serial.
get_template(get=...) argument – get_template now accepts a get keyword argument to load a getter template by name (e.g. get_template(get="inventory")). The .txt extension is optional.
parse_output(get=..., platform=...) routing – parse_output updated to handle getter templates: when get is supplied the platform argument is required and is used to select the correct platform-specific input section inside the getter template. Raises ValueError when platform is omitted and RuntimeError when no input in the getter supports the given platform.
list_templates() includes "get" key – the dict returned by list_templates now has a "get" top-level key listing all getter template filenames.
list_templates_refs() new function – returns a flat, sorted list of ttp:// URI strings for every template across all collections (platform, yang, misc, get). Every URI is directly loadable via get_template(path=ref). Supports the same pattern glob filter as list_templates.

Templates¶

Added ttp://get/inventory.txt – multi-platform inventory getter template.
Updated ttp://platform/cisco_xr_show_inventory.txt – added platform list to the input block for getter routing compatibility.
Updated ttp://platform/arista_eos_show_inventory_pipe_json.txt – added platform list with arista_eos and eos entries.
Updated ttp://platform/cisco_nxos_show_inventory_pipe_json_pretty.txt – added platform list with cisco_nxos and nxos entries.
Updated ttp://platform/juniper_junos_show_chassis_hardware_pipe_json.txt – added platform list with juniper_junos and junos entries.

v0.4.0¶

Bugs¶

Bug 1 – parse_output now raises ValueError with a descriptive message when called without any valid template-locating argument (previously the None returned by get_template was silently forwarded to the TTP constructor, causing confusing downstream errors).
Bug 2 – Fixed path-traversal vulnerability (OWASP A01) in get_template. The resolved template filename is now verified with os.path.realpath to confirm it falls inside the package directory before the file is opened; crafted paths such as path="../../etc/passwd" now raise ValueError.
Bug 3 – Fixed list_templates crashing with AttributeError when a template file is placed directly inside the misc/ root directory (rather than in a subdirectory). The leaf-assignment logic now checks whether the target key already holds a dict; if it does, the files are stored under the empty-string sub-key instead of overwriting the dict with a list.
Bug 4 – list_templates now returns file lists in sorted alphabetical order. Previously os.walk / os.listdir produced non-deterministic ordering across operating systems and filesystems, making the output unreliable for callers and difficult to test reliably.
Bug 5 – Fixed prefix-ambiguity in short_interface_names (ttp_vars.py). The 2GE patterns '^Tw' and '^Two' were broad enough to also match TwoHundredGigabitEthernet* (200GE) names because 2GE appeared before 200GE in the dict. Negative look-ahead anchors (r'^Tw(?!entyFive|oHundred)' and r'^Two(?!Hundred)') were added so only genuine 2GE interface names are matched.

Changes¶

Python minimum version bumped to 3.10.
Improved logging throughout all public API functions.
Improved type hint annotations and converted docstrings to Google format.
Improved inline comments for clarity.
Enhancing tests suite

v0.3.2¶

Templates¶

Added misc/Netbox folder with templates for Junos, IOS-XR, and Arista devices configuration.

v0.3.1¶

Templates¶

Added ttp://misc/N2G/cli_ip_data/arista_eos.txt template to parse Arista EOS IP details for N2G L3 diagrams.

v0.3.0¶

Features¶

Added list_templates method to list available templates.

Bugs¶

Fixed Cisco IOS show running-configuration to correct command: show running-config.
Updated N2G IOS-XR cli_ip_data template to match ipv4 address 1.1.1.1/32 style config.

Templates¶

Updated all N2G templates to have default input with required commands and platform attributes.

v0.2.0¶

Changes¶

Moved to Poetry for dependency management.

Templates¶

Added templates:

ttp://platform/juniper_junos_show_isis_database_verbose_pipe_no_more.txt
ttp://misc/N2G/cli_l2_data/juniper.txt
ttp://misc/N2G/cli_isis_data/juniper.txt
ttp://platform/arista_eos_show_hostname.txt

Modified templates:

ttp://platform/cisco_xr_show_isis_database_verbose.txt – updated produced data structure to key LSPs by hostname.

v0.1.3¶

Bugs¶

Fixed TTP Templates docs example path formation: the correct path is ttp://misc/Netmiko/cisco.ios.arp.txt, not ttp://misc.Netmiko.cisco.ios.arp.txt.

New Templates¶

Added N2G templates.

v0.1.2¶

Minor Features¶

Added support for get_template to source a template by path using the ttp:// URI scheme.
Added ttp_vars.py to repository to store common TTP variables.
Added short_interface_names dictionary in ttp_vars.py for use with resuball to normalize interface names to shorter abbreviations.

New Templates¶

misc/Netmiko/cisco.ios.arp.txt
misc/Netmiko/cisco.ios.cfg.ip.txt
misc/Netmiko/cisco.iosxr.arp.txt
misc/Netmiko/huawei.vrp.cfg.ip.txt
yang/openconfig-lldp_cisco_ios.txt
yang/openconfig-lldp_cisco_nxos.txt
yang/openconfig-lldp_cisco_xr.txt
misc/Netmiko/cisco.iosxr.cfg.ip.txt
platform/arista_eos_show_hostname.txt