# seleste3580-dev/aetheris architecture

> Architecture diagram of the GitHub repository seleste3580-dev/aetheris, 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/seleste3580-dev/aetheris
- Repository: https://github.com/seleste3580-dev/aetheris

## Overview

Aetheris is a command-line TCP port scanner. The user supplies a target and scan options; the program validates the target, expands the requested ports, probes them concurrently with timeouts, and reports open ports. It also provides live progress and can serialize results to JSON. The README describes asynchronous scanning, terminal progress, and JSON export; the available source shows these implemented together in `main.rs`.

Main entry points: [`aetheris/src/main.rs`](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs) (Scan Orchestrator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and Setup"]
  node_main["Scan Orchestrator<br/>[main.rs]"]
  node_port_parser["Port Range Parser<br/>[main.rs]"]
end

subgraph group_scan["Port Scanning"]
  node_probe["TCP Port Probe<br/>[main.rs]"]
  node_progress["Live Progress<br/>[main.rs]"]
end

subgraph group_results["Results and Output"]
  node_console["Terminal Results<br/>[main.rs]"]
  node_json_export["JSON Export<br/>[main.rs]"]
  node_output_file["Output File"]
end

node_user(("Scanner User"))
node_target(("Target Host"))

node_user -->|"provides options"| node_main
node_main -->|"parses ports"| node_port_parser
node_main -->|"dispatches probes"| node_probe
node_probe -->|"connects to"| node_target
node_main -->|"updates progress"| node_progress
node_main -->|"prints results"| node_console
node_main -->|"serializes results"| node_json_export
node_json_export -->|"writes JSON"| node_output_file

click node_main "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"
click node_port_parser "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"
click node_probe "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"
click node_progress "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"
click node_console "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"
click node_json_export "https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs"

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_main,node_port_parser,node_user toneBlue
class node_probe,node_progress toneAmber
class node_console,node_json_export,node_output_file toneMint
class node_target toneIndigo
```

## Components

### CLI and Setup

- [Scan Orchestrator](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`
- [Port Range Parser](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`

### Port Scanning

- [TCP Port Probe](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`
- [Live Progress](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`

### Results and Output

- [Terminal Results](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`
- [JSON Export](https://github.com/seleste3580-dev/aetheris/blob/main/aetheris/src/main.rs): `aetheris/src/main.rs`
- **Output File**

### Other components

- **Scanner User**
- **Target Host**

## Connections

- Scanner User → Scan Orchestrator: provides options (evidence: `aetheris/src/main.rs`)
- Scan Orchestrator → Port Range Parser: parses ports (evidence: `aetheris/src/main.rs`)
- Scan Orchestrator → TCP Port Probe: dispatches probes (evidence: `aetheris/src/main.rs`)
- TCP Port Probe → Target Host: connects to (evidence: `aetheris/src/main.rs`)
- Scan Orchestrator → Live Progress: updates progress (evidence: `aetheris/src/main.rs`)
- Scan Orchestrator → Terminal Results: prints results (evidence: `aetheris/src/main.rs`)
- Scan Orchestrator → JSON Export: serializes results (evidence: `aetheris/src/main.rs`)
- JSON Export → Output File: writes JSON (evidence: `aetheris/src/main.rs`)
