# adnan-1618/phishing-url-awareness architecture

> Architecture diagram of the GitHub repository adnan-1618/phishing-url-awareness, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adnan-1618/phishing-url-awareness
- Repository: https://github.com/adnan-1618/phishing-url-awareness

## Overview

This is a small educational command-line URL awareness checker. The user enters URL text in a repeat-until-quit loop; the checker parses it without opening it, evaluates visible warning signs, and prints findings. Parsing and warning rules are implemented inside one inspection function, so they are represented as stages rather than separate modules. The repository contains no network scanning or external integrations.

Main entry points: [`phishing_checker.py`](https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py) (Interactive CLI)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("User"))
node_cli["Interactive CLI"]
node_parse["URL Parsing"]
node_checks["Warning Checks"]
node_findings["Findings Output"]

node_user -->|"enters URL"| node_cli
node_cli -->|"inspects URL"| node_parse
node_parse -->|"provides parsed host"| node_checks
node_checks -->|"returns findings"| node_parse
node_cli -->|"prints findings"| node_findings

click node_cli "https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py"
click node_parse "https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py"
click node_checks "https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py"
click node_findings "https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.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_user toneBlue
class node_cli,node_parse,node_checks,node_findings toneTeal
```

## Components

### Other components

- **User**
- [Interactive CLI](https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py): `phishing_checker.py`
- [URL Parsing](https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py): `phishing_checker.py`
- [Warning Checks](https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py): `phishing_checker.py`
- [Findings Output](https://github.com/adnan-1618/phishing-url-awareness/blob/main/phishing_checker.py): `phishing_checker.py`

## Connections

- User → Interactive CLI: enters URL (evidence: `phishing_checker.py`)
- Interactive CLI → URL Parsing: inspects URL (evidence: `phishing_checker.py`)
- URL Parsing → Warning Checks: provides parsed host (evidence: `phishing_checker.py`)
- Warning Checks → URL Parsing: returns findings (evidence: `phishing_checker.py`)
- Interactive CLI → Findings Output: prints findings (evidence: `phishing_checker.py`)
