# martin-hoyle/networking architecture

> Architecture diagram of the GitHub repository martin-hoyle/networking, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martin-hoyle/networking
- Repository: https://github.com/martin-hoyle/networking

## Overview

This repository is a small collection of Python scripts for querying Cisco IOS XE devices and saving or displaying command results. The main multi-device workflows load hosts from a list, prompt for credentials, connect over Scrapli, and either write command output, parse interface data, or export a CSV. Separate scripts query one hard-coded device, while pandatest demonstrates CSV creation from sample data. The README is empty; relationships below are evidenced by the sampled scripts.

Main entry points: [`python/devicelist.py`](https://github.com/martin-hoyle/networking/blob/main/python/devicelist.py) (Command collection), [`python/scrapli_textfsm.py`](https://github.com/martin-hoyle/networking/blob/main/python/scrapli_textfsm.py) (Parsed collection), [`python/scrapli_panda.py`](https://github.com/martin-hoyle/networking/blob/main/python/scrapli_panda.py) (Interface CSV export), [`python/devices.txt`](https://github.com/martin-hoyle/networking/blob/main/python/devices.txt) (Device list)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Device collection"]
  node_devices["Device list<br/>[devices.txt]"]
  node_devicelist["Command collection<br/>[devicelist.py]"]
  node_raw_reports["Command reports<br/>[Router-01.txt]"]
end

subgraph group_processing["Parsing and export"]
  node_textfsm["Parsed collection<br/>[scrapli_textfsm.py]"]
  node_parsed_reports["Parsed reports<br/>[Router-02.txt]"]
  node_panda_export["Interface CSV export<br/>[scrapli_panda.py]"]
  node_environment_csv["Network CSV"]
  node_sample_export["Sample CSV demo<br/>[pandatest.py]"]
end

subgraph group_single["Single-device queries"]
  node_get_query["Prompted query<br/>[get.py]"]
  node_first_query["Fixed-credential query<br/>[first.py]"]
end

node_operator(("Operator"))
node_device_fleet["Cisco devices"]

node_operator -->|"provides credentials"| node_devicelist
node_devices -->|"lists hosts"| node_devicelist
node_devicelist -->|"queries devices"| node_device_fleet
node_devicelist -->|"writes reports"| node_raw_reports
node_operator -->|"provides credentials"| node_textfsm
node_devices -->|"lists hosts"| node_textfsm
node_textfsm -->|"queries devices"| node_device_fleet
node_textfsm -->|"writes reports"| node_parsed_reports
node_operator -->|"provides credentials"| node_panda_export
node_devices -->|"lists hosts"| node_panda_export
node_panda_export -->|"queries interfaces"| node_device_fleet
node_panda_export -->|"exports CSV"| node_environment_csv
node_sample_export -.->|"writes CSV"| node_environment_csv
node_operator -->|"provides credentials"| node_get_query
node_get_query -->|"queries device"| node_device_fleet
node_operator -->|"initiates query"| node_first_query
node_first_query -->|"queries device"| node_device_fleet

click node_devices "https://github.com/martin-hoyle/networking/blob/main/python/devices.txt"
click node_devicelist "https://github.com/martin-hoyle/networking/blob/main/python/devicelist.py"
click node_raw_reports "https://github.com/martin-hoyle/networking/blob/main/python/output/Router-01.txt"
click node_textfsm "https://github.com/martin-hoyle/networking/blob/main/python/scrapli_textfsm.py"
click node_parsed_reports "https://github.com/martin-hoyle/networking/blob/main/python/output/Router-02.txt"
click node_panda_export "https://github.com/martin-hoyle/networking/blob/main/python/scrapli_panda.py"
click node_environment_csv "https://github.com/martin-hoyle/networking/blob/main/python/output/network_environment.csv"
click node_sample_export "https://github.com/martin-hoyle/networking/blob/main/python/pandatest.py"
click node_get_query "https://github.com/martin-hoyle/networking/blob/main/python/get.py"
click node_first_query "https://github.com/martin-hoyle/networking/blob/main/python/first.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_devices,node_devicelist,node_raw_reports toneBlue
class node_textfsm,node_parsed_reports,node_panda_export,node_environment_csv,node_sample_export toneAmber
class node_get_query,node_first_query toneMint
class node_operator,node_device_fleet toneIndigo
```

## Components

### Device collection

- [Device list](https://github.com/martin-hoyle/networking/blob/main/python/devices.txt): `python/devices.txt`
- [Command collection](https://github.com/martin-hoyle/networking/blob/main/python/devicelist.py): `python/devicelist.py`
- [Command reports](https://github.com/martin-hoyle/networking/blob/main/python/output/Router-01.txt): `python/output/Router-01.txt`

### Parsing and export

- [Parsed collection](https://github.com/martin-hoyle/networking/blob/main/python/scrapli_textfsm.py): `python/scrapli_textfsm.py`
- [Parsed reports](https://github.com/martin-hoyle/networking/blob/main/python/output/Router-02.txt): `python/output/Router-02.txt`
- [Interface CSV export](https://github.com/martin-hoyle/networking/blob/main/python/scrapli_panda.py): `python/scrapli_panda.py`
- [Network CSV](https://github.com/martin-hoyle/networking/blob/main/python/output/network_environment.csv): `python/output/network_environment.csv`
- [Sample CSV demo](https://github.com/martin-hoyle/networking/blob/main/python/pandatest.py): `python/pandatest.py`

### Single-device queries

- [Prompted query](https://github.com/martin-hoyle/networking/blob/main/python/get.py): `python/get.py`
- [Fixed-credential query](https://github.com/martin-hoyle/networking/blob/main/python/first.py): `python/first.py`

### Other components

- **Operator**
- **Cisco devices**

## Connections

- Operator → Command collection: provides credentials (evidence: `python/devicelist.py`)
- Device list → Command collection: lists hosts (evidence: `python/devicelist.py`)
- Command collection → Cisco devices: queries devices (evidence: `python/devicelist.py`)
- Command collection → Command reports: writes reports (evidence: `python/devicelist.py`)
- Operator → Parsed collection: provides credentials (evidence: `python/scrapli_textfsm.py`)
- Device list → Parsed collection: lists hosts (evidence: `python/scrapli_textfsm.py`)
- Parsed collection → Cisco devices: queries devices (evidence: `python/scrapli_textfsm.py`)
- Parsed collection → Parsed reports: writes reports (evidence: `python/scrapli_textfsm.py`)
- Operator → Interface CSV export: provides credentials (evidence: `python/scrapli_panda.py`)
- Device list → Interface CSV export: lists hosts (evidence: `python/scrapli_panda.py`)
- Interface CSV export → Cisco devices: queries interfaces (evidence: `python/scrapli_panda.py`)
- Interface CSV export → Network CSV: exports CSV (evidence: `python/scrapli_panda.py`)
- Sample CSV demo → Network CSV: writes CSV
- Operator → Prompted query: provides credentials (evidence: `python/get.py`)
- Prompted query → Cisco devices: queries device (evidence: `python/get.py`)
- Operator → Fixed-credential query: initiates query (evidence: `python/first.py`)
- Fixed-credential query → Cisco devices: queries device (evidence: `python/first.py`)
