ByteBomber 1.2.4__py3-none-any.whl → 2.1.0__py3-none-any.whl

{bytebomber-1.2.4.dist-info → bytebomber-2.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ByteBomber
-Version: 1.2.4
+Version: 2.1.0
 Summary: ZIP bomb generator (for educational purposes only)
 License: MIT
 Project-URL: Homepage, https://github.com/luckalgorithm/ByteBomber
@@ -24,6 +24,14 @@ Dynamic: license-file
 
 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.
 
+## 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.
@@ -61,17 +69,17 @@ When you run the script, you'll be prompted for the following:
 
 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
+| 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.
@@ -105,5 +113,4 @@ Inside the ZIP there are tens of thousands to millions of identical files like:
 
 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.**
+> [!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.0.dist-info/RECORD

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

bytebomber-1.2.4.dist-info/RECORD

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