Skip to main content

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

PyPI version Downloads Python versions License

EBOMB (email Behavioral Overload and Monitoring Benchmark) 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

pip install -U ebomb

Quick Start (CLI)

# 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
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.

Release files for ebomb 3.0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ebomb 3.0.2
File Size Uploaded
ebomb-3.0.2.tar.gz 9.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ebomb 3.0.2
File Interpreter ABI Platform
ebomb-3.0.2-py3-none-any.whl Python 3 none any Details

Total release size: 19.6 kB

Release files / ebomb-3.0.2.tar.gz

Download URL ebomb-3.0.2.tar.gz
Size 9.6 kB
Tags Source
SHA-256 checksum
How to use checksums
20f6c0f3493ba0cdaa8145fa78a69293e5eb194082d5d99bf3242e7c446d08fb
BLAKE2b-256 checksum
How to use checksums
f5feab76292e8f0a477f7cdad97cb665295a670fa88675e39fc0d9e60eefe5e8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.14 Linux/7.1.3-zen2

Release files / ebomb-3.0.2-py3-none-any.whl

Download URL ebomb-3.0.2-py3-none-any.whl
Size 10.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e37a9670087773e2b2694279a3ad0751f81b9841fb08dd4accc1af50a364b3bd
BLAKE2b-256 checksum
How to use checksums
dfcf86703fc8a3ea23dccafef203c7f48cd7d1ffb79e809f008e4918963c236e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/2.4.1 CPython/3.13.14 Linux/7.1.3-zen2

Release history Release notifications | RSS feed

This release

3.0.2 This release

2 release files

3.0.1

2 release files

3.0.0

2 release files

2.2.2

2 release files

2.2.1

2 release files

2.2.0

2 release files

2.1.6

2 release files

2.1.5

2 release files

2.1.4

2 release files

2.1.3

2 release files

2.1.2

2 release files

2.1.1

2 release files

2.1.0

2 release files

2.0.3

1 release file

2.0.2

1 release file

2.0.0

1 release file

1.2.1

1 release file

1.2.0

1 release file

1.1.0

1 release file

1.0.1

1 release file

1.0.0

1 release file

0.0.8

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page