# tingoma89/check-gmail-live-cli architecture

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

- Interactive diagram: https://gitdiagram.com/tingoma89/check-gmail-live-cli
- Repository: https://github.com/tingoma89/check-gmail-live-cli

## Overview

This small Python CLI reads and normalizes addresses, submits them in batches to the Check Gmail Live API, then prints results as text or JSON and can write CSV. The API supplies the account-status classifications; the CLI handles input validation, batching, and presentation. All runtime behavior is implemented in one file. The README and source excerpt support the API endpoint and output options; no separate service internals are represented.

Main entry points: [`check_gmail_live.py`](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py) (CLI workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

node_user(("CLI user"))
node_input_file["Address file"]
node_cli["CLI workflow"]
node_address_reader["Address reader"]
node_batch_checker["Batch checker"]
node_gmail_api{{"Check Gmail API"}}
node_text_json["Text / JSON output"]
node_csv_output["CSV output"]

node_user -->|"runs"| node_cli
node_cli -->|"reads"| node_input_file
node_cli -->|"calls"| node_address_reader
node_address_reader -->|"returns addresses"| node_cli
node_cli -->|"calls per batch"| node_batch_checker
node_batch_checker -->|"posts batch"| node_gmail_api
node_gmail_api -->|"returns statuses"| node_batch_checker
node_cli -->|"prints results"| node_text_json
node_cli -->|"writes optionally"| node_csv_output

click node_cli "https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py"
click node_address_reader "https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py"
click node_batch_checker "https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py"
click node_text_json "https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py"
click node_csv_output "https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.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_input_file toneIndigo
class node_cli,node_address_reader,node_batch_checker,node_text_json,node_csv_output toneTeal
class node_gmail_api toneMint
```

## Components

### Other components

- **CLI user**
- **Address file**
- [CLI workflow](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py): `check_gmail_live.py`
- [Address reader](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py): `check_gmail_live.py`
- [Batch checker](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py): `check_gmail_live.py`
- **Check Gmail API**
- [Text / JSON output](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py): `check_gmail_live.py`
- [CSV output](https://github.com/tingoma89/check-gmail-live-cli/blob/master/check_gmail_live.py): `check_gmail_live.py`

## Connections

- CLI user → CLI workflow: runs (evidence: `README.md`)
- CLI workflow → Address file: reads (evidence: `check_gmail_live.py`)
- CLI workflow → Address reader: calls (evidence: `check_gmail_live.py`)
- Address reader → CLI workflow: returns addresses (evidence: `check_gmail_live.py`)
- CLI workflow → Batch checker: calls per batch (evidence: `check_gmail_live.py`)
- Batch checker → Check Gmail API: posts batch (evidence: `check_gmail_live.py`)
- Check Gmail API → Batch checker: returns statuses (evidence: `check_gmail_live.py`)
- CLI workflow → Text / JSON output: prints results (evidence: `check_gmail_live.py`)
- CLI workflow → CSV output: writes optionally (evidence: `check_gmail_live.py`)
