ByteBomber 2.3.0__py3-none-any.whl → 2.3.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {bytebomber-2.3.0.dist-info → bytebomber-2.3.1.dist-info}/METADATA +26 -3
- bytebomber-2.3.1.dist-info/RECORD +8 -0
- bytebomber-2.3.1.dist-info/entry_points.txt +2 -0
- bytebomber-2.3.0.dist-info/RECORD +0 -8
- bytebomber-2.3.0.dist-info/entry_points.txt +0 -2
- {bytebomber-2.3.0.dist-info → bytebomber-2.3.1.dist-info}/WHEEL +0 -0
- {bytebomber-2.3.0.dist-info → bytebomber-2.3.1.dist-info}/licenses/LICENSE +0 -0
- {bytebomber-2.3.0.dist-info → bytebomber-2.3.1.dist-info}/top_level.txt +0 -0
|
@@ -1,10 +1,10 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: ByteBomber
|
|
3
|
-
Version: 2.3.
|
|
3
|
+
Version: 2.3.1
|
|
4
4
|
Summary: ZIP bomb generator (for educational purposes only)
|
|
5
5
|
License: MIT
|
|
6
|
-
Project-URL: Source, https://github.com/
|
|
7
|
-
Project-URL: Documentation, https://
|
|
6
|
+
Project-URL: Source, https://github.com/redkitlab/ByteBomber
|
|
7
|
+
Project-URL: Documentation, https://github.com/redkitlab/ByteBomber/blob/main/README.md
|
|
8
8
|
Classifier: Programming Language :: Python :: 3
|
|
9
9
|
Classifier: License :: OSI Approved :: MIT License
|
|
10
10
|
Classifier: Operating System :: OS Independent
|
|
@@ -28,6 +28,10 @@ You can then use it in your project: `from bytebomber import build_zip_bomb`
|
|
|
28
28
|
|
|
29
29
|
## Usage
|
|
30
30
|
|
|
31
|
+
You can use ByteBomber as a Python module or directly from your command line.
|
|
32
|
+
|
|
33
|
+
### As a Python Module
|
|
34
|
+
|
|
31
35
|
Call `build_zip_bomb()` to create a ZIP bomb. You can pass several arguments to customize the behavior:
|
|
32
36
|
|
|
33
37
|
```
|
|
@@ -50,6 +54,25 @@ build_zip_bomb(
|
|
|
50
54
|
| `verbose` | If `True`, shows config + summary output. Default: `True`. |
|
|
51
55
|
| `show_progress` | If `True`, shows a live progress bar. Default: `True`. |
|
|
52
56
|
|
|
57
|
+
### Command-Line Usage
|
|
58
|
+
|
|
59
|
+
When you run ByteBomber from your terminal, you can optionally use flags to customize its behavior:
|
|
60
|
+
|
|
61
|
+
```
|
|
62
|
+
bytebomber --target-size "100 GB" --payload-size "500 KB" --output "my_bomb.zip"
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
| **Flag** | **Long Flag** | Description |
|
|
66
|
+
|----------|---------------|--------------------------------------------------------------------|
|
|
67
|
+
| `-t` | `--target-size` | Total uncompressed size of the ZIP bomb (e.g., `"500 GB"`). Default: `"500 GB"`. |
|
|
68
|
+
| `-p` | `--payload-size` | Size of each file inside the ZIP (e.g., `"1 MB"`). Default: `"1 MB"`. |
|
|
69
|
+
| `-o` | `--output` | Output ZIP file name. Default: `"bomb.zip"`. |
|
|
70
|
+
| `-f` | `--folder` | Internal folder name for the payload files. Default: `"bomb-dir"`. |
|
|
71
|
+
| `-n` | `--no-progress` | Disable the live progress bar. |
|
|
72
|
+
| `-q` | `--quiet` | Silence all output messages. |
|
|
73
|
+
|
|
74
|
+
---
|
|
75
|
+
|
|
53
76
|
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 usually more than enough to stress a system. Values above TB are astronomical data zizes far more than most systems can handle.
|
|
54
77
|
|
|
55
78
|
> [!NOTE]
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
bytebomber/__init__.py,sha256=ry7B_o4gtFbUp_z8D3UsaoB0yO26eiUN9YDfk67ui2E,36
|
|
2
|
+
bytebomber/__main__.py,sha256=qep0feiQNhtgkoJQVrSnK3hWeurLHQWxgf6q4Wf_c4E,2983
|
|
3
|
+
bytebomber-2.3.1.dist-info/licenses/LICENSE,sha256=ZOBy1MmbOFhWGjGe0xv_g9T7SCiiq5JafpBBBp280ss,1496
|
|
4
|
+
bytebomber-2.3.1.dist-info/METADATA,sha256=UtxtTweGEt70qvLAjgV-bmSRbfI76IgU9fiA-mODP18,3859
|
|
5
|
+
bytebomber-2.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
6
|
+
bytebomber-2.3.1.dist-info/entry_points.txt,sha256=ujmBvN_aEG4BSrmzKlpsC9XNNB7goQ9m_ddUvKM9vnY,56
|
|
7
|
+
bytebomber-2.3.1.dist-info/top_level.txt,sha256=bDtIXh70vdwT8VslZsHHLGkV7VBuZXxk0fzN0lWv4Y4,11
|
|
8
|
+
bytebomber-2.3.1.dist-info/RECORD,,
|
|
@@ -1,8 +0,0 @@
|
|
|
1
|
-
bytebomber/__init__.py,sha256=ry7B_o4gtFbUp_z8D3UsaoB0yO26eiUN9YDfk67ui2E,36
|
|
2
|
-
bytebomber/__main__.py,sha256=qep0feiQNhtgkoJQVrSnK3hWeurLHQWxgf6q4Wf_c4E,2983
|
|
3
|
-
bytebomber-2.3.0.dist-info/licenses/LICENSE,sha256=ZOBy1MmbOFhWGjGe0xv_g9T7SCiiq5JafpBBBp280ss,1496
|
|
4
|
-
bytebomber-2.3.0.dist-info/METADATA,sha256=MOPFSN-zPqtlyxf075c-dFzj1L44KTedxgQ4qPeEmCg,2803
|
|
5
|
-
bytebomber-2.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
|
|
6
|
-
bytebomber-2.3.0.dist-info/entry_points.txt,sha256=v7HnIUxttlBwYp_xC0K0YpXrEzIbEybt6tmbPjj8pKg,66
|
|
7
|
-
bytebomber-2.3.0.dist-info/top_level.txt,sha256=bDtIXh70vdwT8VslZsHHLGkV7VBuZXxk0fzN0lWv4Y4,11
|
|
8
|
-
bytebomber-2.3.0.dist-info/RECORD,,
|
|
File without changes
|
|
File without changes
|
|
File without changes
|