# ciscodevnet/sure architecture

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

- Interactive diagram: https://gitdiagram.com/ciscodevnet/sure
- Repository: https://github.com/ciscodevnet/sure

## Overview

SURE is a standalone SD-WAN upgrade-readiness CLI, provided as separate Python 2 and Python 3 scripts selected by vManage version. The user supplies credentials; the script runs checks against vManage and its overlay, then presents findings and writes a TXT report, logs, and JSON summary. The excerpts show check orchestration and API/command-based checks, but are partial, so the graph groups check domains rather than claiming a complete internal sequence. Both implementations are single files, not separate service layers.

Main entry points: [`python2/py2_sure.py`](https://github.com/ciscodevnet/sure/blob/main/python2/py2_sure.py) (Python 2 runner), [`python3/py3_sure.py`](https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py) (Python 3 runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runners["CLI runners"]
  node_py2["Python 2 runner<br/>[py2_sure.py]"]
  node_py3["Python 3 runner<br/>[py3_sure.py]"]
end

subgraph group_assessment["Readiness assessment"]
  node_checks["Readiness checks<br/>[py3_sure.py]"]
end

subgraph group_results["Results"]
  node_outputs["Reports and logs<br/>[py3_sure.py]"]
end

node_operator(("vManage operator"))
node_platform["vManage overlay"]

node_operator -->|"runs for older versions"| node_py2
node_operator -->|"runs for newer versions"| node_py3
node_py2 -->|"runs checks"| node_checks
node_py3 -->|"runs checks"| node_checks
node_checks -->|"queries APIs and commands"| node_platform
node_py3 -->|"writes results"| node_outputs
node_py2 -->|"writes results"| node_outputs

click node_py2 "https://github.com/ciscodevnet/sure/blob/main/python2/py2_sure.py"
click node_py3 "https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py"
click node_checks "https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py"
click node_outputs "https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.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_py2,node_py3 toneBlue
class node_checks toneAmber
class node_outputs toneMint
class node_operator,node_platform toneIndigo
```

## Components

### CLI runners

- [Python 2 runner](https://github.com/ciscodevnet/sure/blob/main/python2/py2_sure.py): `python2/py2_sure.py`
- [Python 3 runner](https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py): `python3/py3_sure.py`

### Readiness assessment

- [Readiness checks](https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py): `python3/py3_sure.py`

### Results

- [Reports and logs](https://github.com/ciscodevnet/sure/blob/main/python3/py3_sure.py): `python3/py3_sure.py`

### Other components

- **vManage operator**
- **vManage overlay**

## Connections

- vManage operator → Python 2 runner: runs for older versions (evidence: `README.md`)
- vManage operator → Python 3 runner: runs for newer versions (evidence: `README.md`)
- Python 2 runner → Readiness checks: runs checks (evidence: `python2/py2_sure.py`)
- Python 3 runner → Readiness checks: runs checks (evidence: `python3/py3_sure.py`)
- Readiness checks → vManage overlay: queries APIs and commands (evidence: `README.md`)
- Python 3 runner → Reports and logs: writes results (evidence: `README.md`)
- Python 2 runner → Reports and logs: writes results (evidence: `README.md`)
