PRJ-netapi-tui: Network API Testing & Automation Companion
1. Project Summary
| Field | Value |
|---|---|
PRJ ID |
PRJ-2025-TOOL-001 |
Date Created |
~2025 |
Owner |
Evan Rosado |
Priority |
P1 (Companion to netapi/Kora) |
Category |
Network Automation / API Testing / Companion Tooling |
Status |
Active (low velocity) |
Commits |
10 |
Repository |
|
Local Path |
|
2. Purpose
netapi-tui is the operational companion to the netapi Python API library. While netapi provides the programmatic interface, netapi-tui houses the practical artifacts: HTTP request collections for direct API testing, automation scripts across multiple languages, SQL queries for ISE DataConnect, Ansible playbooks, and vendor-specific automation workflows.
This repository is the hands-on testing ground where API interactions are prototyped before being formalized into netapi or Kora.
3. Scope
3.1. Directory Structure
| Directory | Content |
|---|---|
|
API discovery archives, tooling references (xq), TUI documentation, setup guides |
|
HTTP request collections organized by vendor and technology |
|
Automation scripts organized by vendor, framework, and language |
|
SQL queries, data analysis, reporting |
3.2. API Coverage (01_APIS/)
| Category | Vendors/Technologies |
|---|---|
NAC |
Cisco ISE (ERS, MNT, OpenAPI, pxGrid, DataConnect, Diagnostic), Aruba ClearPass |
Firewalls |
Cisco FTD/FMC, Palo Alto, pfSense, Fortinet, Juniper, SonicWall |
Switches |
Cisco 3850, 9300, 9500, Nexus 3K/9K |
Wireless |
Cisco 9800 WLC |
Identity |
Windows AD / Graph API |
DNS/DHCP |
Infoblox |
Full Stack |
Domus Digitalis API |
3.3. Automation Frameworks (02_AUTOMATA/)
-
Languages: Python, Go, Rust, Shell, PowerShell, Ansible
-
Frameworks: Netmiko, NAPALM, Nornir, pyATS, Scrapli, NETCONF, RESTCONF, gNMI
-
Vendors: Cisco (ISE, switches, wireless, IOS, firewalls), Infoblox, Microsoft, Arista, Palo Alto
3.4. Analytics & Data Science (02_AUTOMATA/)
Beyond automation scripts, the 02_AUTOMATA/ directory includes data science pipelines for network intelligence:
ISE Analytics:
-
MSCHAPv2 Migration Analytics (
cisco/ise/python/analytics/mschapv2/)-
4-tier analytics: descriptive, temporal, network, migration intelligence
-
13 visualizations (plotly interactive + seaborn/matplotlib static)
-
Processes 6K+ device dataset from ISE DataConnect
-
Generates HTML dashboard for migration wave planning
-
Technical Stack:
-
Data: pandas, numpy, regex-based parsing
-
Visualization: plotly (interactive HTML), seaborn, matplotlib
-
Output: HTML dashboards, PNG charts, migration planning tables
4. Status
| Aspect | Status |
|---|---|
Active Use |
Active — used for API prototyping and testing |
Commits |
10 (content-heavy, large batch commits) |
Maintenance |
Ongoing as new APIs are explored |
Value |
Primary API testing surface and automation recipe library |
4.1. Relationship to netapi & Kora
| Phase | Tool | Role |
|---|---|---|
Prototype |
netapi-tui |
Test HTTP requests, discover API behavior |
Library |
netapi |
Formalize as Python client with Atomic Design |
CLI |
Kora |
Ship as universal Go CLI for end users |
6. Metadata
| Field | Value |
|---|---|
PRJ ID |
PRJ-2025-TOOL-001 |
Author |
Evan Rosado |
Date Created |
~2025 |
Last Updated |
2026-03-30 |
Status |
Active |
Next Review |
2026-04-15 |