# ruhanazevedo/netizenship architecture

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

- Interactive diagram: https://gitdiagram.com/ruhanazevedo/netizenship
- Repository: https://github.com/ruhanazevedo/netizenship

## Overview

Netizenship is a command-line username-presence checker. Its single runtime module prompts for a username, checks configured profile URLs concurrently, interprets responses, and prints per-site outcomes and a summary. The README describes coverage of 38 websites; the sampled source shows the registry and checking logic in one file. Version checking also queries PyPI before the search. The map focuses on runtime behavior; no separate implementation for email lookup is present. Evidence is limited to the README and the sampled netizenship.py excerpt.

Main entry points: [`netizenship.py`](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py) (CLI workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and orchestration"]
  node_main["CLI workflow<br/>[netizenship.py]"]
  node_version["Version gate<br/>[netizenship.py]"]
  node_report["Results and summary<br/>[netizenship.py]"]
end

subgraph group_checks["Profile checks"]
  node_registry["Site registry<br/>[netizenship.py]"]
  node_workers["Concurrent checks<br/>[netizenship.py]"]
  node_fetch["Profile fetch<br/>[netizenship.py]"]
  node_interpret["Response interpretation<br/>[netizenship.py]"]
end

subgraph group_services["External services"]
  node_pypi["PyPI metadata"]
  node_profiles["Social websites"]
  node_httpstatus["HTTP status wiki"]
end

node_user(("CLI user"))

node_user -->|"starts and enters username"| node_main
node_main -->|"checks version"| node_version
node_version -->|"fetches releases"| node_pypi
node_main -->|"uses configured sites"| node_registry
node_main -->|"dispatches checks"| node_workers
node_workers -->|"runs per-site check"| node_fetch
node_fetch -->|"requests profile URLs"| node_profiles
node_fetch -->|"loads status descriptions"| node_httpstatus
node_fetch -->|"passes responses"| node_interpret
node_interpret -->|"prints outcomes"| node_report
node_main -->|"prints summary"| node_report

click node_main "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_version "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_registry "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_workers "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_fetch "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_interpret "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py"
click node_report "https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.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_main,node_version,node_report,node_user toneBlue
class node_registry,node_workers,node_fetch,node_interpret toneAmber
class node_pypi,node_profiles,node_httpstatus toneMint
```

## Components

### CLI and orchestration

- [CLI workflow](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`
- [Version gate](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`
- [Results and summary](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`

### Profile checks

- [Site registry](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`
- [Concurrent checks](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`
- [Profile fetch](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`
- [Response interpretation](https://github.com/ruhanazevedo/netizenship/blob/master/netizenship.py): `netizenship.py`

### External services

- **PyPI metadata**
- **Social websites**
- **HTTP status wiki**

### Other components

- **CLI user**

## Connections

- CLI user → CLI workflow: starts and enters username (evidence: `README.md`)
- CLI workflow → Version gate: checks version (evidence: `netizenship.py`)
- Version gate → PyPI metadata: fetches releases (evidence: `netizenship.py`)
- CLI workflow → Site registry: uses configured sites (evidence: `netizenship.py`)
- CLI workflow → Concurrent checks: dispatches checks (evidence: `netizenship.py`)
- Concurrent checks → Profile fetch: runs per-site check (evidence: `netizenship.py`)
- Profile fetch → Social websites: requests profile URLs (evidence: `netizenship.py`)
- Profile fetch → HTTP status wiki: loads status descriptions (evidence: `netizenship.py`)
- Profile fetch → Response interpretation: passes responses (evidence: `netizenship.py`)
- Response interpretation → Results and summary: prints outcomes (evidence: `netizenship.py`)
- CLI workflow → Results and summary: prints summary (evidence: `netizenship.py`)
