Metadata-Version: 2.4
Name: ByteBomber
Version: 2.2.1
Summary: ZIP bomb generator (for educational purposes only)
License: MIT
Project-URL: Source, https://github.com/luckalgorithm/ByteBomber
Project-URL: Documentation, https://luckalgorithm.github.io/ByteBomber
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Security
Classifier: Topic :: Utilities
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Development Status :: 5 - Production/Stable
Requires-Python: <4.0,>=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

ByteBomber is a Python tool for creating ZIP bombs. It demonstrates how compression algorithms (specifically ZIP's DEFLATE) can exploit redundancy to create highly compressed files that expand drastically when extracted. It’s primarily for educational purposes to understand the impact of such files.

## Installation

Install ByteBomber via pip: `pip install bytebomber`

You can then use it in your project: `from bytebomber import build_zip_bomb`

## Usage

Call `build_zip_bomb()` to create a ZIP bomb. You can pass several arguments to customize the behavior:

```
build_zip_bomb(
    target_input="500 GB",
    payload_input="1 MB",
    zip_name="bomb.zip",
    folder_name="bomb-dir",
    verbose=True,
    show_progress=True
)
```

| **Parameter** | Description |
|----------------| ----------------------------------------------------------------------------------|
| `target_input` | Total uncompressed size of the ZIP bomb. Default: prompts user or uses `"500 GB"`. |
| `payload_input` | Size of each file inside the ZIP. Smaller values = more files. Default: prompts user or uses `"1 MB"`. |
| `zip_name` | Output ZIP file name. Default: prompts user or uses `"bomb.zip"`. |
| `folder_name` | Internal folder name for the payload files. Default: prompts user or uses `"bomb_dir"`. |
| `verbose` | If `True`, shows config + summary output. Default: `True`. |
| `show_progress` | If `True`, shows a live progress bar. Default: `True`. |

Use the format `<number> <unit>` when entering values (e.g., `500 GB`, `1 TB`). ByteBomber supports B, KB, MB, GB, TB, PB, EB, ZB, and YB. Valuse in the GB-TB range are usaully more than enough to stress a system. Values above TB are astronomical data zizes far more than most systems can handle.

> [!NOTE]
> The program accepts values using standard units (e.g., MB, GB), but internally it treats them as binary units (e.g., MiB, GiB).

**ByteBomber is for educational purposes only. Do not deploy ZIP bombs on systems you do not own or have permission to test. Misuse can result in data loss or system damage.**