Metadata-Version: 2.4
Name: ebomb
Version: 3.0.0
Summary: Email Behavioral Overload & Monitoring Benchmark
License-Expression: MIT
License-File: LICENSE
Author: Nikita Denissov
Author-email: n.denissov@proton.me
Requires-Python: >=3.9
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Internet
Classifier: Topic :: Communications :: Email :: Filters
Classifier: Typing :: Typed
Requires-Dist: fake-useragent (>=2.2.0,<3.0.0)
Requires-Dist: httpx[socks] (>=0.28.1,<0.29.0)
Requires-Dist: rich (>=15.0.0,<16.0.0)
Requires-Dist: spys (>=1.1.0,<2.0.0)
Project-URL: Homepage, https://github.com/ndenissov/ebomb
Project-URL: Repository, https://github.com/ndenissov/ebomb
Description-Content-Type: text/markdown

# Email Behavioral Overload & Monitoring Benchmark (E.B.O.M.B.)

**EBOMB** (**e**mail **B**ehavioral **O**verload and **M**onitoring **B**enchmark) is an open-source benchmarking tool
designed to evaluate email server resilience, inbox rate-limiting, and spam filtering behaviors under synthetic
high-volume load.

The tool automates incoming subscription request flows to help system administrators, QA engineers, and security
auditors measure how mail infrastructure behaves under traffic spikes and concurrent delivery stress.

⚠️ **Disclaimer:** This software is intended strictly for authorized security auditing, benchmarking, and load testing
of infrastructure you own or have explicit written permission to test. Unauthorized automated traffic generation against
third-party services is strictly prohibited.

## Core Capabilities

* **Inbound Load Benchmarking:** Simulates concurrent subscription requests across configurable endpoints to test queue
  handling and buffer limits.
* **Filter Behavior Analysis:** Evaluates spam filter classification accuracy (e.g., SpamAssassin, Rspamd) when subject
  to automated request flows.
* **Multi-threaded Execution:** Utilizes configurable thread pools (`multiprocessing.dummy.ThreadPool`) for scalable
  concurrency testing.
* **Network & Proxy Support:** Includes optional SOCKS5 proxy rotation (including Tor support) to simulate distributed
  client traffic patterns.

## Installation

```bash
pip install -U ebomb
```

## Quick Start (CLI)

```bash
# Display CLI parameters and benchmark options
python -m ebomb --help

# Run a benchmark test against authorized target mailboxes
python -m ebomb benchmark-user1@example.com benchmark-user2@example.com -tc 4 --proxy --verbose
```

```bash
python -m ebomb --help
usage: ebomb [-h] [--threads-count THREADS_COUNT] [--proxy | --no-proxy] [--forever | --no-forever] [--verbose | --no-verbose] targets [targets ...]

Email Behavioral Overload & Monitoring Benchmark (E.B.O.M.B.)

positional arguments:
  targets               Email addresses separated by spaces.

options:
  -h, --help            show this help message and exit
  --threads-count, -tc THREADS_COUNT
  --proxy, --no-proxy   Use proxy.
  --forever, --no-forever
                        Run forever, otherwise only one circle.
  --verbose, --no-verbose
                        Display something on the screen.
```
