catalyst-config-auditor 1.4.0__tar.gz

catalyst_config_auditor-1.4.0/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+## [1.4.0] — 2026-11-05
+- Add separate SSH modes `--backup-only`, `--commands-only` and `--collect` (backup + show outputs only).
+- Add `--excel --input <any/Commands_Output.txt>`; default workbook is saved beside input TXT, plus recursive `--input-dir DIR` batch mode.
+- Add independent `--extract-vars` (YAML only) and `--generate-templates` (Jinja only) with `--vars-dir`.
+- Add `--create-main`, `--create-interfaces`, and `--create-full` to render distinct offline configuration files.
+- Preserve `--vars` for combined YAML/Jinja2 and `-AIO` for all stages including Excel.
+- Expand CLI `--help` examples for each mode, retain TTP/NTC/custom/RAW parser logic.
+- Ensure no file overwrites without `--overwrite`; protect original offline inputs.
+
+
+## [1.3.9] — 2026-11-04
+- Parse recognized `show` outputs into Excel columns; use a single `RAW` column for unmatched commands.
+- Remove the `Parsing_Summary` worksheet and write per-command parser results to logs.
+- Support external custom NTC/TextFSM templates using `--ntc-dir`; keep TTP, built-in Python parsers and RAW fallback.
+- Save configuration backups as `<hostname>_running_Config.txt` (legacy naming remains readable for offline extraction).
+- Include routed interfaces in `var_interfaces.yaml` and their reusable blocks in generated interface templates.
+- Try saved `show inventory`, `show version`, and `license udi` for chassis serial identification.
+- Reduce extra lines in generated interface Jinja2 while preserving Cisco indentation.
+
+## [1.3.8]
+- Remove Genie/pyATS integration and runtime dependency; retain TTP/custom/RAW parsing.
+
+## [1.3.7]
+- Independently preserve existing `ip arp inspection trust` and `ip arp inspection limit rate N` commands; do not inject defaults.
+
+## [1.3.6]
+- Introduce optional TTP parsing, offline parser test/check and engine reporting.
+
+## [1.3.5]
+- Simplify VLAN/BGP/secondary-IP variable structures and generic Jinja2 templates.

catalyst_config_auditor-1.4.0/CLI_HELP_v1.4.0.txt

@@ -0,0 +1,158 @@
+usage: Catalyst_Config_Auditor.py [-h] [-ho HOST | -hf HOST_FILE |
+                                  --from-config FROM_CONFIG] [-u USERNAME]
+                                  [-p PASSWORD] [-o OUTPUT] [-AIO] [--collect]
+                                  [--backup-only] [--commands-only] [--vars]
+                                  [--extract-vars] [--generate-templates]
+                                  [--create] [--create-main]
+                                  [--create-interfaces] [--create-full]
+                                  [--interface-template INTERFACE_TEMPLATE]
+                                  [--interface-vars INTERFACE_VARS] [--backup]
+                                  [--excel]
+                                  [--parser {auto,ttp,ntc,custom,raw}]
+                                  [--parser-dir DIR] [--ntc-dir DIR]
+                                  [--parser-test COMMAND] [--parser-check]
+                                  [--input FILE] [--input-dir DIR]
+                                  [--ttp-template FILE] [--json-output FILE]
+                                  [--yaml] [--cmd-file CMD_FILE]
+                                  [--selection SELECTION] [--vars-dir DIR]
+                                  [--template [FILE]] [--variables [FILE]]
+                                  [--extra-vars FILE] [--output-file FILE]
+                                  [--model MODEL] [-w WORKERS] [--overwrite]
+                                  [--debug] [--version]
+
+Catalyst Config Auditor v1.4.0 | Excel, selective YAML and Jinja2
+
+options:
+  -h, --help            show this help message and exit
+  -ho, --host HOST      Single hostname or management IP
+  -hf, --host-file, --hosts-file HOST_FILE
+                        File with one hostname/IP per line
+  --from-config FROM_CONFIG
+                        Read an existing local running-config instead of
+                        connecting over SSH
+  -u, --username USERNAME
+                        SSH username (prompt when missing)
+  -p, --password PASSWORD
+                        SSH password (interactive prompt recommended)
+  -o, --output OUTPUT   Root output folder (default: output)
+  -AIO, --all-in-one    SSH backup + show commands + Excel + YAML + Jinja2
+  --collect             SSH: running-config backup + show outputs (no Excel)
+  --backup-only         SSH: save running-config only
+  --commands-only       SSH: save show outputs only
+  --vars                Offline YAML + Jinja2 (legacy combined mode)
+  --extract-vars        Offline: generate only YAML files from running-config
+  --generate-templates  Offline: generate only Jinja2 from running-config +
+                        existing YAML
+  --create, --create_config
+                        Offline: generic Jinja2 + YAML renderer
+  --create-main         Offline: render only main config, excluding interface
+                        include
+  --create-interfaces   Offline: render only interface config
+  --create-full         Offline: render complete main + interfaces config
+  --interface-template INTERFACE_TEMPLATE
+                        Optional replacement for an included interface Jinja2
+                        template (legacy support)
+  --interface-vars INTERFACE_VARS
+                        Optional extra interface YAML file (legacy support)
+  --backup              Alias for --backup-only (SSH)
+  --excel               Offline Excel from --input FILE, or saved
+                        output/<host>/Backups/Commands_Output.txt
+  --parser {auto,ttp,ntc,custom,raw}
+                        Excel parser engine (auto: proven custom first, TTP >
+                        NTC custom > NTC built-in > RAW)
+  --parser-dir DIR      Folder holding .ttp templates (default:
+                        Custom_Parsers/TTP)
+  --ntc-dir DIR         External NTC TextFSM templates/index (default:
+                        Custom_Parsers/NTC)
+  --parser-test COMMAND
+                        Offline test parser for a single CLI command; requires
+                        --input
+  --parser-check        Display parser availability and TTP/NTC external
+                        templates
+  --input FILE          Source TXT for --excel or --parser-test (Excel stays
+                        in TXT folder by default)
+  --input-dir DIR       With --excel, recursively create workbooks for all
+                        Commands_Output.txt files under DIR
+  --ttp-template FILE   Explicit .ttp template for --parser-test (overrides
+                        --parser-dir)
+  --json-output FILE    Save --parser-test structured result as JSON
+  --yaml                Alias for --vars (offline)
+  --cmd-file CMD_FILE   Command list for --collect; asks interactively when
+                        omitted (default cmd.txt)
+  --selection SELECTION
+                        YAML field selection file
+  --vars-dir DIR        Directory for generated YAML/Jinja2, or source folder
+                        for --create-main/interfaces/full
+  --template [FILE]     Main Jinja2 template; omit FILE to be prompted during
+                        --create
+  --variables [FILE]    ANY YAML variables; omit FILE to be prompted during
+                        --create
+  --extra-vars FILE     Additional YAML mapping; repeat to combine files (last
+                        wins)
+  --output-file, --dest FILE
+                        Exact output filename for --excel or config rendering
+  --model MODEL         Model hint for offline running-config processing
+  -w, --workers WORKERS
+                        Concurrent SSH sessions (default: 20)
+  --overwrite           Allow overwriting existing output files
+  --debug               Display detailed exceptions
+  --version             show program's version number and exit
+
+COLLECTION - SSH, read-only:
+  # Collect running-config plus show commands (does not generate Excel)
+  python Catalyst_Config_Auditor.py -ho SW01 --collect --cmd-file cmd.txt
+  python Catalyst_Config_Auditor.py -hf hosts.txt --collect -w 20 -o output
+  # Backup running-config only
+  python Catalyst_Config_Auditor.py -ho SW01 --backup-only
+  # Run show commands only, without running-config backup
+  python Catalyst_Config_Auditor.py -ho SW01 --commands-only --cmd-file cmd.txt
+
+EXCEL - offline, no SSH:
+  # Input may be anywhere; Excel is saved NEXT TO that TXT by default
+  python Catalyst_Config_Auditor.py --excel --input "C:\Backups\SW01\Commands_Output.txt"
+  python Catalyst_Config_Auditor.py --excel --input "C:\Backups\SW01\Commands_Output.txt" --parser auto --overwrite
+  # Batch: generate Excel beside EVERY Commands_Output.txt under a folder
+  python Catalyst_Config_Auditor.py --excel --input-dir "C:\Backups\Cat9k" --parser auto
+  # Custom output file and device label (optional)
+  python Catalyst_Config_Auditor.py --excel --input saved.txt -ho SW01 --output-file SW01.xlsx
+  # Original device-folder workflow is still supported
+  python Catalyst_Config_Auditor.py -ho SW01 --excel -o output
+  # Custom NTC and TTP templates
+  python Catalyst_Config_Auditor.py --excel --input saved.txt --ntc-dir Custom_Parsers/NTC --parser-dir Custom_Parsers/TTP
+
+VARIABLES AND TEMPLATES - offline, independent:
+  # Generate ONLY var_main.yaml + var_interfaces.yaml from a backup
+  python Catalyst_Config_Auditor.py -ho SW01 --extract-vars
+  python Catalyst_Config_Auditor.py --extract-vars --from-config "C:\Backups\SW01\SW01_running_Config.txt"
+  # Generate ONLY template_main.j2 + template_interfaces.j2, using existing YAML
+  python Catalyst_Config_Auditor.py -ho SW01 --generate-templates
+  # Legacy combined mode: variables AND templates
+  python Catalyst_Config_Auditor.py -ho SW01 --vars
+
+CONFIG GENERATION - offline only, never sends changes to switches:
+  # Main configuration WITHOUT physical interface include
+  python Catalyst_Config_Auditor.py -ho SW01 --create-main
+  # Physical interfaces only
+  python Catalyst_Config_Auditor.py -ho SW01 --create-interfaces
+  # Complete configuration (main + included interfaces)
+  python Catalyst_Config_Auditor.py -ho SW01 --create-full
+  # Use a Variables folder at any location
+  python Catalyst_Config_Auditor.py --create-interfaces --vars-dir "C:\Backups\SW01\Variables"
+  # Generic Jinja2+YAML: any template/variables/output
+  python Catalyst_Config_Auditor.py --create --template policy.j2 --variables site.yaml --output-file policy.cfg
+  python Catalyst_Config_Auditor.py --create --template output/SW01/Variables/template_interfaces.j2 --variables output/SW01/Variables/var_interfaces.yaml
+
+COMBINED / DIAGNOSTIC MODES:
+  python Catalyst_Config_Auditor.py -ho SW01 -AIO  # collect + Excel + YAML + templates
+  python Catalyst_Config_Auditor.py --parser-check
+  python Catalyst_Config_Auditor.py --parser-test "show ip arp" --input arp.txt --parser ttp
+
+NOTES:
+  --collect is backup + show commands only in v1.4.0; use --excel separately.
+  --vars retains old behavior (YAML + templates) for existing users.
+  --input with --excel places XLSX beside the input unless --output-file is set.
+  --input-dir recursively creates an XLSX beside every Commands_Output.txt.
+  --from-config places extracted files beside the backup, in Variables/.
+  Existing files are protected unless --overwrite is supplied.
+  No configuration commands are sent to devices.
+  See README.md for layout and security guidance.

catalyst_config_auditor-1.4.0/CONTRIBUTING.md

@@ -0,0 +1,22 @@
+# Contributing
+
+## Setup (Windows / PowerShell)
+
+```powershell
+py -m venv .venv
+.venv\Scripts\Activate.ps1
+python -m pip install -r requirements.txt
+python Catalyst_Config_Auditor.py --help
+python -m unittest discover -s tests -v
+```
+
+## Before opening a PR
+1. Preserve the single-file application (`Catalyst_Config_Auditor.py`) and public CLI flags unless a change is intentional.
+2. Add offline fixture-based tests for new parser or rendering behavior; do not require switch access in CI.
+3. Keep comments/docstrings in English and use fictitious hostnames, serials, MACs and RFC 5737 documentation IPv4 addresses.
+4. Prefer parsing that verifies its record count/columns; keep the original output and use RAW on unrecognized formats.
+5. Keep `PROJECT_CONTEXT.md`, `CHANGELOG.md` and the version constant in sync.
+6. Never add production outputs or credentials. Generated variable YAML can contain BGP secrets.
+
+## New parsing templates
+For NTC/TextFSM, add `Custom_Parsers/NTC/cisco_ios_show_*.textfsm`, update `Custom_Parsers/NTC/index`, and add a synthetic sample test. For TTP, add an appropriately named `.ttp` in `Custom_Parsers/TTP/`. Verify on sanitized device outputs because IOS-XE may use multiple formatting variants.

catalyst_config_auditor-1.4.0/Catalyst_Config_Auditor.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""Backward-compatible launcher and import alias to the packaged implementation."""
+from pathlib import Path
+import sys
+
+_SRC = Path(__file__).resolve().parent / 'src'
+if _SRC.is_dir():
+    sys.path.insert(0, str(_SRC))
+from catalyst_config_auditor import cli as _implementation
+
+if __name__ == '__main__':
+    raise SystemExit(_implementation.main())
+else:
+    # Legacy unit tests and downstream monkeypatching must affect the real module.
+    sys.modules[__name__] = _implementation

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/README.md

@@ -0,0 +1,19 @@
+# NTC / TextFSM directory
+
+Put your `cisco_ios_<command>.textfsm` files here and optionally register them in `index`.
+
+The auditor accepts two discovery modes:
+
+1. `index` file with NTC syntax: `Template, Hostname, Platform, Command` plus mappings.
+2. Direct filename convention, e.g. `cisco_ios_show_interfaces_trunk.textfsm`.
+
+The default `--ntc-dir` is `Custom_Parsers/NTC`, resolved from the working directory or beside the script. A full official collection in `Custom_Parsers/NTC/templates/index` is also accepted.
+
+Install: `python -m pip install ntc-templates textfsm`.
+
+The example templates in this package are based on **illustrative CLI formats**. Several IOS-XE releases and chassis differ. Test each template with `--parser-test` and representative saved outputs before relying on the Excel results. The original Commands_Output.txt is always retained.
+
+Example:
+```
+python Catalyst_Config_Auditor.py --parser-test "show interfaces trunk" --input examples/show_interfaces_trunk.txt --parser ntc
+```

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_device-tracking_database.textfsm

@@ -0,0 +1,11 @@
+# Supports common IPv4 database layouts. Platform/version differences require local tests.
+Value Required IP_ADDRESS (\d{1,3}(?:\.\d{1,3}){3})
+Value MAC_ADDRESS ((?:[0-9A-Fa-f]{4}\.){2}[0-9A-Fa-f]{4}|(?:[0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2})
+Value VLAN (\d+)
+Value INTERFACE (\S+)
+Value STATE (\S+)
+
+Start
+  ^\s*${IP_ADDRESS}\s+${MAC_ADDRESS}\s+${VLAN}\s+${INTERFACE}\s+${STATE}\s*$$ -> Record
+  ^\s*${IP_ADDRESS}\s+${MAC_ADDRESS}\s+${INTERFACE}\s+${VLAN}\s+${STATE}\s*$$ -> Record
+  ^\s*${IP_ADDRESS}\s+${MAC_ADDRESS}\s+${VLAN}\s+${INTERFACE}\s*$$ -> Record

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_environment_all.textfsm

@@ -0,0 +1,12 @@
+# Catalyst IOS-XE - selected fan/power/temperature status rows.
+Value SWITCH (\d+)
+Value COMPONENT (\S+(?:\s+\S+)?)
+Value STATUS (\S+(?:\s+\S+)?)
+Value TEMPERATURE_C (\d+(?:\.\d+)?)
+
+Start
+  ^\s*Switch\s+${SWITCH}\s+FAN\s+${COMPONENT}\s+is\s+${STATUS}\s*$$ -> Record
+  ^\s*FAN\s+${COMPONENT}\s+is\s+${STATUS}\s*$$ -> Record
+  ^\s*(?:Power Supply|POWER SUPPLY|PSU)\s+${COMPONENT}\s+is\s+${STATUS}\s*$$ -> Record
+  ^\s*SYSTEM TEMPERATURE\s+is\s+${STATUS}\s*$$ -> Record
+  ^\s*Temperature\s*:\s*${TEMPERATURE_C}\s*(?:C|Degree Celsius|degrees C)?\s*$$ -> Record

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_interfaces_counters.textfsm

@@ -0,0 +1,24 @@
+# The two counter blocks yield separate rows; pivot/merge rows by PORT for Excel.
+Value Required PORT (\S+)
+Value IN_OCTETS (\d+)
+Value IN_UCAST (\d+)
+Value IN_MCAST (\d+)
+Value IN_BCAST (\d+)
+Value OUT_OCTETS (\d+)
+Value OUT_UCAST (\d+)
+Value OUT_MCAST (\d+)
+Value OUT_BCAST (\d+)
+
+Start
+  ^\s*Port\s+InOctets\s+InUcastPkts\s+InMcastPkts\s+InBcastPkts\s*$$ -> InCounters
+  ^\s*Port\s+OutOctets\s+OutUcastPkts\s+OutMcastPkts\s+OutBcastPkts\s*$$ -> OutCounters
+
+InCounters
+  ^\s*${PORT}\s+${IN_OCTETS}\s+${IN_UCAST}\s+${IN_MCAST}\s+${IN_BCAST}\s*$$ -> Record
+  ^\s*Port\s+OutOctets\s+OutUcastPkts\s+OutMcastPkts\s+OutBcastPkts\s*$$ -> OutCounters
+  ^\s*Port\s+InOctets\s+InUcastPkts\s+InMcastPkts\s+InBcastPkts\s*$$ -> InCounters
+
+OutCounters
+  ^\s*${PORT}\s+${OUT_OCTETS}\s+${OUT_UCAST}\s+${OUT_MCAST}\s+${OUT_BCAST}\s*$$ -> Record
+  ^\s*Port\s+InOctets\s+InUcastPkts\s+InMcastPkts\s+InBcastPkts\s*$$ -> InCounters
+  ^\s*Port\s+OutOctets\s+OutUcastPkts\s+OutMcastPkts\s+OutBcastPkts\s*$$ -> OutCounters

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_interfaces_counters_errors.textfsm

@@ -0,0 +1,12 @@
+# Common Catalyst error counter table variants.
+Value Required PORT (\S+)
+Value ALIGN_ERR (\d+)
+Value FCS_ERR (\d+)
+Value XMIT_ERR (\d+)
+Value RCV_ERR (\d+)
+Value UNDERSIZE (\d+)
+Value OUTDISCARDS (\d+)
+
+Start
+  ^\s*${PORT}\s+${ALIGN_ERR}\s+${FCS_ERR}\s+${XMIT_ERR}\s+${RCV_ERR}\s+${UNDERSIZE}\s+${OUTDISCARDS}\s*$$ -> Record
+  ^\s*${PORT}\s+${ALIGN_ERR}\s+${FCS_ERR}\s+${XMIT_ERR}\s+${RCV_ERR}\s*$$ -> Record

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_interfaces_trunk.textfsm

@@ -0,0 +1,36 @@
+# Multiple tables in IOS-XE; rows should be merged by PORT for Excel.
+Value Required PORT (\S+)
+Value MODE (\S+)
+Value ENCAPSULATION (\S+)
+Value STATUS (\S+)
+Value NATIVE_VLAN (\S+)
+Value ALLOWED_VLANS (\S+)
+Value ACTIVE_VLANS (\S+)
+Value FORWARDING_VLANS (\S+)
+
+Start
+  ^\s*Port\s+Mode\s+Encapsulation\s+Status\s+Native vlan\s*$$ -> StatusTable
+  ^\s*Port\s+Vlans allowed on trunk\s*$$ -> AllowedTable
+  ^\s*Port\s+Vlans allowed and active in management domain\s*$$ -> ActiveTable
+  ^\s*Port\s+Vlans in spanning tree forwarding state and not pruned\s*$$ -> ForwardTable
+
+StatusTable
+  ^\s*${PORT}\s+${MODE}\s+${ENCAPSULATION}\s+${STATUS}\s+${NATIVE_VLAN}\s*$$ -> Record
+  ^\s*Port\s+Vlans allowed on trunk\s*$$ -> AllowedTable
+  ^\s*Port\s+Vlans allowed and active in management domain\s*$$ -> ActiveTable
+  ^\s*Port\s+Vlans in spanning tree forwarding state and not pruned\s*$$ -> ForwardTable
+
+AllowedTable
+  ^\s*${PORT}\s+${ALLOWED_VLANS}\s*$$ -> Record
+  ^\s*Port\s+Vlans allowed and active in management domain\s*$$ -> ActiveTable
+  ^\s*Port\s+Vlans in spanning tree forwarding state and not pruned\s*$$ -> ForwardTable
+  ^\s*Port\s+Mode\s+Encapsulation\s+Status\s+Native vlan\s*$$ -> StatusTable
+
+ActiveTable
+  ^\s*${PORT}\s+${ACTIVE_VLANS}\s*$$ -> Record
+  ^\s*Port\s+Vlans in spanning tree forwarding state and not pruned\s*$$ -> ForwardTable
+  ^\s*Port\s+Vlans allowed on trunk\s*$$ -> AllowedTable
+
+ForwardTable
+  ^\s*${PORT}\s+${FORWARDING_VLANS}\s*$$ -> Record
+  ^\s*Port\s+Mode\s+Encapsulation\s+Status\s+Native vlan\s*$$ -> StatusTable

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_ip_arp_inspection_interfaces.textfsm

@@ -0,0 +1,10 @@
+# Supports whitespace-separated and pipe-separated table examples.
+Value Required INTERFACE (\S+)
+Value TRUST_STATE (\S+)
+Value RATE_PPS (\S+)
+Value BURST_INTERVAL (\S+)
+
+Start
+  ^\s*${INTERFACE}\s+${TRUST_STATE}\s+${RATE_PPS}\s+${BURST_INTERVAL}\s*$$ -> Record
+  ^\s*${INTERFACE}\s+${TRUST_STATE}\s+${RATE_PPS}\s*$$ -> Record
+  ^\s*${INTERFACE}\s*\|\s*${TRUST_STATE}\s*\|\s*${RATE_PPS}\s*$$ -> Record

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_ip_dhcp_snooping.textfsm

@@ -0,0 +1,18 @@
+# Key summary settings and per-port trust/rate rows.
+Value SWITCH_STATUS (\S+)
+Value CONFIGURED_VLANS (\S+)
+Value OPERATIONAL_VLANS (\S+)
+Value OPTION82 (\S+)
+Value INTERFACE (\S+)
+Value TRUST (\S+)
+Value RATE_PPS (\S+)
+
+Start
+  ^\s*Switch DHCP snooping is ${SWITCH_STATUS}\s*$$ -> Record
+  ^\s*DHCP snooping is configured on following VLANs:\s*${CONFIGURED_VLANS}\s*$$ -> Record
+  ^\s*DHCP snooping is operational on following VLANs:\s*${OPERATIONAL_VLANS}\s*$$ -> Record
+  ^\s*Insertion of option 82 is ${OPTION82}\s*$$ -> Record
+  ^\s*Interface\s+Trusted\s+Rate limit \(pps\)\s*$$ -> Interfaces
+
+Interfaces
+  ^\s*${INTERFACE}\s+${TRUST}\s+${RATE_PPS}\s*$$ -> Record

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/cisco_ios_show_ip_protocols.textfsm

@@ -0,0 +1,19 @@
+# Summary records by protocol; this does not decode all nested protocol detail.
+Value Filldown PROTOCOL ([^"\r\n]+)
+Value REDISTRIBUTING (.+)
+Value NETWORK (.+)
+Value DISTANCE (.+)
+
+Start
+  ^\s*Routing Protocol is "${PROTOCOL}"\s*$$ -> Record
+  ^\s*Redistributing:\s+${REDISTRIBUTING}\s*$$ -> Record
+  ^\s*Distance:\s+${DISTANCE}\s*$$ -> Record
+  ^\s*Routing for Networks:\s*$$ -> Networks
+
+Networks
+  ^\s{4,}${NETWORK}\s*$$ -> Record
+  ^\s*Routing Information Sources:\s*$$ -> Start
+  ^\s*Distance:\s+${DISTANCE}\s*$$ -> Start
+  ^\s*Routing Protocol is "${PROTOCOL}"\s*$$ -> Start
+
+EOF

catalyst_config_auditor-1.4.0/Custom_Parsers/NTC/index

@@ -0,0 +1,9 @@
+Template, Hostname, Platform, Command
+cisco_ios_show_interfaces_counters_errors.textfsm, .*, cisco_ios, sh[[ow]] int[[erfaces]] cou[[nters]] er[[rors]]
+cisco_ios_show_ip_arp_inspection_interfaces.textfsm, .*, cisco_ios, sh[[ow]] ip arp insp[[ection]] int[[erfaces]]
+cisco_ios_show_device-tracking_database.textfsm, .*, cisco_ios, sh[[ow]] device-tracking database
+cisco_ios_show_interfaces_counters.textfsm, .*, cisco_ios, sh[[ow]] int[[erfaces]] cou[[nters]]
+cisco_ios_show_interfaces_trunk.textfsm, .*, cisco_ios, sh[[ow]] int[[erfaces]] trunk
+cisco_ios_show_environment_all.textfsm, .*, cisco_ios, sh[[ow]] env[[ironment]] all
+cisco_ios_show_ip_dhcp_snooping.textfsm, .*, cisco_ios, sh[[ow]] ip dhcp snoop[[ing]]$
+cisco_ios_show_ip_protocols.textfsm, .*, cisco_ios, sh[[ow]] ip prot[[ocols]]$

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/README.md

@@ -0,0 +1,6 @@
+# TTP templates
+
+Optional Text Template Parser templates from v1.3.8. Use the filenames `show_<command>.ttp`. These parsers run before NTC in auto mode **except** that proven built-in Python parsers for certain tables are preferred to avoid partial multi-section output.
+
+Test with `--parser-test "show ip arp" --input examples/show_ip_arp.txt --parser ttp`.
+Outputs vary by IOS-XE version; treat the supplied patterns as starting points, not guaranteed full coverage.

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_device_tracking_database.ttp

@@ -0,0 +1,4 @@
+<!-- Cisco IOS-XE show device-tracking database: IP MAC VLAN interface state. -->
+<group name="entries*" method="table">
+{{ ip | IP }} {{ mac | MAC }} {{ vlan | DIGIT }} {{ interface }} {{ state }}
+</group>

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_interfaces_counters_errors.ttp

@@ -0,0 +1,4 @@
+<!-- Cisco IOS-XE show interfaces counters errors: 7-column variant. -->
+<group name="interfaces*" method="table">
+{{ port | re("[A-Za-z]+[0-9][^ ]*") }} {{ align_err }} {{ fcs_err }} {{ xmit_err }} {{ rcv_err }} {{ undersize }} {{ outdiscards }}
+</group>

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_ip_arp.ttp

@@ -0,0 +1,5 @@
+<!-- Cisco IOS-XE show ip arp: supports standard IPv4 ARPA rows. -->
+<group name="entries*" method="table">
+Internet {{ ip | IP }} {{ age }} {{ mac }} ARPA {{ interface }}
+Internet {{ ip | IP }} {{ age }} {{ mac }} ARPA {{ interface }} *
+</group>

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_ip_arp_inspection_interfaces.ttp

@@ -0,0 +1,4 @@
+<!-- Cisco IOS-XE show ip arp inspection interfaces: tabular variant. -->
+<group name="interfaces*" method="table">
+{{ interface | re("[A-Za-z]+[0-9][^ ]*") }} {{ trust | re("(?:Trusted|Untrusted)") }} {{ rate }} {{ burst }}
+</group>

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_ip_dhcp_snooping_binding.ttp

@@ -0,0 +1,4 @@
+<!-- Cisco IOS-XE show ip dhcp snooping binding: six-field binding table. -->
+<group name="bindings*" method="table">
+{{ mac | MAC }} {{ ip | IP }} {{ lease }} {{ type }} {{ vlan | DIGIT }} {{ interface }}
+</group>

catalyst_config_auditor-1.4.0/Custom_Parsers/TTP/show_ip_interface_brief.ttp

@@ -0,0 +1,4 @@
+<!-- Cisco IOS-XE show ip interface brief; status can have multiple words. -->
+<group name="interfaces*" method="table">
+{{ interface | re("[A-Za-z]+[0-9][^ ]*") }} {{ ip }} {{ ok }} {{ method }} {{ status | ORPHRASE }} {{ protocol }}
+</group>

catalyst_config_auditor-1.4.0/LICENSE

@@ -0,0 +1,7 @@
+LICENSE STATUS: NOT YET SELECTED
+
+This file is a placeholder, NOT an open-source license or grant of permission.
+The project owner must select the applicable license, verify ownership of
+third-party and contributed code, and replace this file before representing
+the project as open source. In the absence of a license grant, all rights
+remain reserved by their respective owners.

catalyst_config_auditor-1.4.0/MANIFEST.in

@@ -0,0 +1,7 @@
+include Catalyst_Config_Auditor.py
+include README.md LICENSE CHANGELOG.md PROJECT_CONTEXT.md SECURITY.md CONTRIBUTING.md
+include requirements.txt cmd.txt variables_selection.yaml CLI_HELP_v1.4.0.txt
+recursive-include examples *.txt *.j2 *.xlsx
+recursive-include tests *.py
+recursive-include src/catalyst_config_auditor *.txt *.yaml *.ttp *.textfsm index
+recursive-include Custom_Parsers *.textfsm *.ttp *.md index