# thespeedx/tbomb architecture

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

- Interactive diagram: https://gitdiagram.com/thespeedx/tbomb
- Repository: https://github.com/thespeedx/tbomb

## Overview

TBomb is a command-line messaging and calling tool. Users choose an SMS, call, or mail mode, provide a target and run settings, and the program dispatches requests through configured APIs and reports outcomes. The map also includes documented update and notification behavior. Source excerpts show the main dispatch and provider mechanics; mail handling and some CLI details are documented but not fully excerpted.

Main entry points: [`bomber.py`](https://github.com/thespeedx/tbomb/blob/master/bomber.py) (CLI and mode selection), [`utils/provider.py`](https://github.com/thespeedx/tbomb/blob/master/utils/provider.py) (API provider), [`apidata.json`](https://github.com/thespeedx/tbomb/blob/master/apidata.json) (API definitions), [`isdcodes.json`](https://github.com/thespeedx/tbomb/blob/master/isdcodes.json) (Country codes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI workflow"]
  node_entry["CLI and mode selection<br/>[bomber.py]"]
  node_target["Target validation<br/>[bomber.py]"]
  node_settings["Run settings<br/>[bomber.py]"]
  node_results["Run status and results<br/>[bomber.py]"]
end

subgraph group_dispatch["Request dispatch"]
  node_worker["Concurrent worker<br/>[bomber.py]"]
  node_provider["API provider<br/>[provider.py]"]
  node_api_config["API definitions<br/>[apidata.json]"]
end

subgraph group_support["Runtime support"]
  node_country_data["Country codes<br/>[isdcodes.json]"]
  node_messages["Console formatting<br/>[decorators.py]"]
  node_update_notify["Updates and notices<br/>[bomber.py]"]
end

node_user(("CLI user"))
node_api_services{{"Messaging APIs"}}
node_remote_repo{{"GitHub resources"}}

node_user -->|"chooses mode"| node_entry
node_entry -->|"requests target"| node_target
node_target -->|"checks country code"| node_country_data
node_entry -->|"collects run settings"| node_settings
node_entry -->|"starts selected mode"| node_worker
node_worker -->|"submits concurrent hits"| node_provider
node_provider -->|"loads definitions"| node_api_config
node_provider -->|"sends requests"| node_api_services
node_worker -->|"reports outcomes"| node_results
node_entry -->|"formats console output"| node_messages
node_entry -->|"checks updates and notices"| node_update_notify
node_update_notify -->|"fetches resources"| node_remote_repo

click node_entry "https://github.com/thespeedx/tbomb/blob/master/bomber.py"
click node_target "https://github.com/thespeedx/tbomb/blob/master/bomber.py"
click node_settings "https://github.com/thespeedx/tbomb/blob/master/bomber.py"
click node_worker "https://github.com/thespeedx/tbomb/blob/master/bomber.py"
click node_provider "https://github.com/thespeedx/tbomb/blob/master/utils/provider.py"
click node_api_config "https://github.com/thespeedx/tbomb/blob/master/apidata.json"
click node_results "https://github.com/thespeedx/tbomb/blob/master/bomber.py"
click node_country_data "https://github.com/thespeedx/tbomb/blob/master/isdcodes.json"
click node_messages "https://github.com/thespeedx/tbomb/blob/master/utils/decorators.py"
click node_update_notify "https://github.com/thespeedx/tbomb/blob/master/bomber.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_entry,node_target,node_settings,node_results,node_user toneBlue
class node_worker,node_provider,node_api_config toneAmber
class node_country_data,node_messages,node_update_notify,node_api_services toneMint
class node_remote_repo toneIndigo
```

## Components

### CLI workflow

- [CLI and mode selection](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`
- [Target validation](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`
- [Run settings](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`
- [Run status and results](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`

### Request dispatch

- [Concurrent worker](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`
- [API provider](https://github.com/thespeedx/tbomb/blob/master/utils/provider.py): `utils/provider.py`
- [API definitions](https://github.com/thespeedx/tbomb/blob/master/apidata.json): `apidata.json`

### Runtime support

- [Country codes](https://github.com/thespeedx/tbomb/blob/master/isdcodes.json): `isdcodes.json`
- [Console formatting](https://github.com/thespeedx/tbomb/blob/master/utils/decorators.py): `utils/decorators.py`
- [Updates and notices](https://github.com/thespeedx/tbomb/blob/master/bomber.py): `bomber.py`

### Other components

- **CLI user**
- **Messaging APIs**
- **GitHub resources**

## Connections

- CLI user → CLI and mode selection: chooses mode (evidence: `README.md`)
- CLI and mode selection → Target validation: requests target (evidence: `bomber.py`)
- Target validation → Country codes: checks country code (evidence: `bomber.py`)
- CLI and mode selection → Run settings: collects run settings (evidence: `README.md`)
- CLI and mode selection → Concurrent worker: starts selected mode (evidence: `bomber.py`)
- Concurrent worker → API provider: submits concurrent hits (evidence: `bomber.py`)
- API provider → API definitions: loads definitions (evidence: `utils/provider.py`)
- API provider → Messaging APIs: sends requests (evidence: `utils/provider.py`)
- Concurrent worker → Run status and results: reports outcomes (evidence: `bomber.py`)
- CLI and mode selection → Console formatting: formats console output (evidence: `bomber.py`)
- CLI and mode selection → Updates and notices: checks updates and notices (evidence: `bomber.py`)
- Updates and notices → GitHub resources: fetches resources (evidence: `bomber.py`)
