strobengine 0.1.0__tar.gz → 0.2.0__tar.gz

strobengine-0.2.0/CHANGELOG.md

@@ -0,0 +1,103 @@
+# Changelog
+
+All notable changes to `strobengine` will be documented in this file.
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.2.0] - 2026-08-02
+
+### Bug Fixes
+
+- *(progress)* Downgrade expected HTTP errors from warn to debug
+- *(cli)* Move logging flags to subcommands for natural syntax
+- *(engine)* Resolve null options and attribute access bugs (#38)
+
+### Documentation
+
+- Add benchmark methodology, infrastructure setup, and project roadmap
+- Add tool versions to benchmark methodology (#29)
+- Document verbosity, progress bar, and CLI flags
+- Update roadmap to reflect changes (#34)
+- Add HTTP method, body, and header documentation
+- Add code examples (#37)
+
+### Features
+
+- *(reporter)* Add metric descriptions to CLI summary output (#30)
+- Add chaos testing engine (#32)
+- Add indicatif dependency for progress bar rendering
+- Add progress bar module and live render loop
+- *(metrics)* Add atomic fields to LiveCounters for active workers and latency tracking
+- *(worker)* Track active workers and update live request metrics
+- *(config)* Support no_progress flag in TestConfig
+- *(engine)* Spawn live progress bar during load test runs
+- *(cli)* Add --no-progress option to suppress live progress bar
+- Progress indicators (#33)
+- Add HTTP request configuration
+- Support custom HTTP requests
+- *(cli)* Add HTTP request options
+- Add support for HTTP methods, request bodies, and custom headers (#35)
+- Implement graceful shutdown on SIGINT (#39)
+
+### Miscellaneous Tasks
+
+- *(release)* Prepare v0.1.0 changelog and tag
+- Add PyPI publish workflow with tag-based triggering (#26)
+
+### Performance
+
+- Switch global allocator to mimalloc for reduced lock contention (#28)
+- Optimize connection pooling with tcp_nodelay, pre-warming, and body consumption (#31)
+
+### Refactoring
+
+- *(engine)* Encapsulate request options into RequestOptions dataclass (#36)
+
+### Testing
+
+- *(config)* Simplify header setup in custom config test
+## [0.1.0] - 2026-07-23
+
+### Bug Fixes
+
+- *(tests)* Fix backward-compat tests to go through main()
+- *(docs)* Correct print_summary import and add results display to examples
+- *(docs)* Correct print_summary import and add results display to examples (#23)
+
+### Documentation
+
+- *(changelog)* Configure git-cliff and generate initial CHANGELOG.md (#16)
+- Add logging flags and tracing crates to README
+
+### Features
+
+- *(config)* Add TestConfig pyclass with Python default arguments (#5)
+- *(metrics)* Add TestSummary pyclass and calculate_summary (#6)
+- Add StrobEngine class with sync and async interfaces (#11)
+- Dynamic load profiling (#17)
+- *(cli)* Add -V/--version flag with importlib.metadata
+- *(rust)* Add tracing instrumentation and init_logging binding
+- *(cli)* Add -v/-q/--log-file flags with stderr logging
+- *(logging)* Unify system logging (#20)
+
+### Miscellaneous Tasks
+
+- Add Python environment and build artifacts to .gitignore
+- Initialize strobengine hybrid workspace architecture
+- *(cargo)* Fix formatting and wrap comment for abi3-py38 feature (#1)
+- *(python)* Add __all__ to package init for explicit public API (#8)
+- Add GitHub Actions workflow for Rust and Python checks (#10)
+- Update minimum Python version to 3.13 for abi3-py313
+- *(lint)* Add ruff rules and auto-fix pyupgrade suggestions
+- Bump minimum python version to 3.13 and expand ruff rules (#21)
+- Add TestPyPI publish workflow with OIDC trusted publishing
+- Lower minimum Python version to 3.11 for broader compatibility
+- Lower minimum Python version to 3.11 for broader compatibility (#24)
+- Add testpypi environment to publish workflow
+- Add testpypi environment to publish workflow (#25)
+- Add PyPI publish workflow with tag-based triggering
+
+### Refactoring
+
+- Clean up __init__.py public API exports (#14)
+- *(cli)* Migrate CLI from argparse to typer (#18)

{strobengine-0.1.0 → strobengine-0.2.0}/Cargo.lock

@@ -118,6 +118,18 @@ dependencies = [
  "memchr",
 ]
 
+[[package]]
+name = "console"
+version = "0.16.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4fe5f465a4f6fee88fad41b85d990f84c835335e85b5d9e6e63e0d06d28cba7c"
+dependencies = [
+ "encode_unicode",
+ "libc",
+ "unicode-width",
+ "windows-sys 0.61.2",
+]
+
 [[package]]
 name = "core-foundation"
 version = "0.9.4"
@@ -170,6 +182,12 @@ version = "1.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "92773504d58c093f6de2459af4af33faa518c13451eb8f2b5698ed3d36e7c813"
 
+[[package]]
+name = "encode_unicode"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "34aa73646ffb006b8f5147f3dc182bd4bcb190227ce861fc4a4844bf8e3cb2c0"
+
 [[package]]
 name = "encoding_rs"
 version = "0.8.35"
@@ -185,6 +203,22 @@ version = "1.0.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "877a4ace8713b0bcf2a4e7eec82529c029f1d0619886d18145fea96c3ffe5c0f"
 
+[[package]]
+name = "errno"
+version = "0.3.14"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
+dependencies = [
+ "libc",
+ "windows-sys 0.52.0",
+]
+
+[[package]]
+name = "fastrand"
+version = "2.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "da7c62ceae207dd37ea5b845da6a0696c799f85e97da1ab5b7910be3c1c80223"
+
 [[package]]
 name = "find-msvc-tools"
 version = "0.1.9"
@@ -534,6 +568,19 @@ dependencies = [
  "hashbrown",
 ]
 
+[[package]]
+name = "indicatif"
+version = "0.18.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9433806cd6b4ec1aba79c021c7e4c58fb4c3b9977c085062e611ac929998fb0c"
+dependencies = [
+ "console",
+ "portable-atomic",
+ "unicode-width",
+ "unit-prefix",
+ "web-time",
+]
+
 [[package]]
 name = "ipnet"
 version = "2.12.0"
@@ -628,6 +675,15 @@ version = "0.2.186"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "68ab91017fe16c622486840e4c83c9a37afeff978bd239b5293d61ece587de66"
 
+[[package]]
+name = "libmimalloc-sys"
+version = "0.1.49"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6a45a52f43e1c16f667ccfe4dd8c85b7f7c204fd5e3bf46c5b0db9a5c3c0b8e9"
+dependencies = [
+ "cc",
+]
+
 [[package]]
 name = "litemap"
 version = "0.8.2"
@@ -661,6 +717,15 @@ version = "2.8.3"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
+[[package]]
+name = "mimalloc"
+version = "0.1.52"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2d4139bb28d14ad1facf21d5eb8825051b326e172d216b39f6d31df53cc97862"
+dependencies = [
+ "libmimalloc-sys",
+]
+
 [[package]]
 name = "mime"
 version = "0.3.17"
@@ -1152,6 +1217,16 @@ version = "2.0.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "f8fadd59c855ef2080decdef8ff161eb6661b86933c9d82e5ba29dc602a55aba"
 
+[[package]]
+name = "signal-hook-registry"
+version = "1.4.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c4db69cba1110affc0e9f7bcd48bbf87b3f4fc7c61fc9155afd4c469eb3d6c1b"
+dependencies = [
+ "errno",
+ "libc",
+]
+
 [[package]]
 name = "simd_cesu8"
 version = "1.2.0"
@@ -1198,8 +1273,13 @@ checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
 
 [[package]]
 name = "strobengine"
-version = "0.1.0"
+version = "0.2.0"
 dependencies = [
+ "bytes",
+ "fastrand",
+ "http",
+ "indicatif",
+ "mimalloc",
  "pyo3",
  "reqwest",
  "tokio",
@@ -1347,10 +1427,23 @@ dependencies = [
  "libc",
  "mio",
  "pin-project-lite",
+ "signal-hook-registry",
  "socket2",
+ "tokio-macros",
  "windows-sys 0.61.2",
 ]
 
+[[package]]
+name = "tokio-macros"
+version = "2.7.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "6328af13490e73a9b4694030fafd93f8c8c6a9dede33e821c3fc63eddf8042ba"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "syn 2.0.119",
+]
+
 [[package]]
 name = "tokio-rustls"
 version = "0.26.4"
@@ -1493,6 +1586,18 @@ version = "1.0.24"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "e6e4313cd5fcd3dad5cafa179702e2b244f760991f45397d14d4ebf38247da75"
 
+[[package]]
+name = "unicode-width"
+version = "0.2.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "b4ac048d71ede7ee76d585517add45da530660ef4390e49b098733c6e897f254"
+
+[[package]]
+name = "unit-prefix"
+version = "0.5.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "81e544489bf3d8ef66c953931f56617f423cd4b5494be343d9b9d3dda037b9a3"
+
 [[package]]
 name = "untrusted"
 version = "0.9.0"

{strobengine-0.1.0 → strobengine-0.2.0}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "strobengine"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2024"
 readme = "README.md"
 
@@ -16,8 +16,12 @@ crate-type = ["cdylib", "rlib"]
 # minimum Python version 3.11
 pyo3 = { version = "0.29", features = ["extension-module", "abi3-py311"] }
 reqwest = { version = "0.13.4" }
-tokio = { version = "1.53.0", features = ["sync", "time", "rt", "rt-multi-thread"] }
+http = "1"
+bytes = "1"
+tokio = { version = "1.53.0", features = ["sync", "time", "rt", "rt-multi-thread", "macros", "signal"] }
 tokio-util = { version = "0.7", features = ["rt"] }
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt", "registry"] }
-# pyo3-async-runtimes = { version = "0.29.0", features = ["tokio-runtime"] }
+mimalloc = "0.1.52"
+fastrand = "2.5"
+indicatif = "0.18.6"

strobengine-0.1.0/README.md → strobengine-0.2.0/PKG-INFO

@@ -1,3 +1,19 @@
+Metadata-Version: 2.4
+Name: strobengine
+Version: 0.2.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.27.0
+License-File: LICENSE
+Summary: A load testing framework with a Python UI and a bare-metal Rust engine core.
+Author-email: riccione <28346232+riccione@users.noreply.github.com>
+License-Expression: Apache-2.0
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Changelog, https://github.com/strobe-ops/strobengine/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/strobe-ops/strobengine
+Project-URL: Homepage, https://github.com/strobe-ops/strobengine
+Project-URL: Source, https://github.com/strobe-ops/strobengine
+
 # strobengine
 
 A high-performance HTTP load testing engine with a Python API and a bare-metal Rust core.
@@ -18,6 +34,10 @@ A high-performance HTTP load testing engine with a Python API and a bare-metal R
 | tokio-util | 0.7 | CancellationToken for graceful worker shutdown |
 | tracing | 0.1 | Structured logging instrumentation |
 | tracing-subscriber | 0.3 | Log formatting and output (stderr/file) |
+| indicatif | 0.17 | Terminal progress bar rendering |
+| fastrand | 2 | Fast random number generation for chaos injection |
+| http | 1 | HTTP method types and header primitives |
+| bytes | 1 | Zero-copy byte buffer for request payloads |
 
 ## Installation & Compilation
 
@@ -63,6 +83,15 @@ engine = StrobEngine.spike_test(
 summary = engine.run()
 
 print_summary(summary, url=engine._url, duration_secs=30)
+
+# POST request with JSON body and custom headers
+engine = StrobEngine(
+    url="http://localhost:8080/api/data",
+    method="POST",
+    body='{"name": "test", "value": 42}',
+    headers=[("Authorization", "Bearer token123")],
+)
+summary = engine.run()
 ```
 
 For async contexts (FastAPI, Typer, etc.):
@@ -85,6 +114,25 @@ strobengine spike http://localhost:8080/api/health --baseline 5 --peak 1000 --pr
 
 # JSON output for CI/CD
 strobengine load http://localhost:8080/api/health --json
+
+# Chaos/fault injection test (~10% of requests get faults)
+strobengine load http://localhost:8080/api/health --chaos
+
+# POST with JSON body
+strobengine load http://localhost:8080/api/data --method POST --body '{"key": "val"}'
+
+# PUT with custom headers
+strobengine load http://localhost:8080/api/resource/1 \
+  --method PUT --body '{"name": "updated"}' --header "Authorization: Bearer token"
+
+# DELETE
+strobengine load http://localhost:8080/api/resource/1 --method DELETE
+
+# Verbose debug output
+strobengine load http://localhost:8080/api/health -vv
+
+# Quiet mode (suppress logs, keep progress bar)
+strobengine load http://localhost:8080/api/health -q
 ```
 
 By default, this spawns **10 concurrent workers** for **10 seconds** with a **10-second request timeout**. Results are displayed as a formatted table with total requests, errors, requests/sec, and latency percentiles (avg, p95, p99).
@@ -104,6 +152,14 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `-c`, `--concurrency` | `10` | Number of concurrent workers |
 | `-d`, `--duration` | `10` | Duration in seconds |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON instead of formatted table |
 
 ### Stress Subcommand Options
@@ -115,6 +171,14 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--ramp` | `60` | Ramp duration in seconds |
 | `--hold` | `30` | Hold duration at target concurrency |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON |
 
 ### Spike Subcommand Options
@@ -127,16 +191,48 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--spike-duration` | `10` | Spike duration in seconds |
 | `--post-spike` | `5` | Post-spike duration in seconds |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON |
 
 ### Global Options
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
-| `-q`, `--quiet` | off | Suppress all output |
-| `--log-file <path>` | none | Write logs to file |
-| `-V`, `--version` | off | Show version and exit |
+| Flag | Description |
+|------|-------------|
+| `-V`, `--version` | Show version and exit |
+
+> **HTTP Methods, Bodies & Headers:** See [docs/http_methods.md](docs/http_methods.md) for detailed documentation on supported HTTP methods, request body handling, custom headers, and performance characteristics.
+
+### Live Progress Bar
+
+During test execution, a live progress bar displays on stderr with real-time telemetry:
+
+```
+⠋ [00:00:05] [==============>-------------] 40% | 1250 req/s | 20 VUs | 12 err | avg 4.2ms
+```
+
+- **RPS**: Instantaneous requests per second (sampled every 200ms)
+- **VUs**: Active virtual users / concurrent workers
+- **Errors**: Total error count
+- **Avg latency**: Running average across all completed requests
+
+The progress bar auto-detects non-TTY environments (CI/CD, piped output) and suppresses itself. Use `--no-progress` to explicitly disable it on interactive terminals.
+
+### Verbosity Levels
+
+| Flag | Level | Shows |
+|------|-------|-------|
+| (default) | `warn` | Errors and warnings only |
+| `-v` | `info` | Engine start/stop, test configuration |
+| `-vv` | `debug` | Worker spawn, HTTP errors, connection events |
+| `-vvv` | `trace` | Per-request latency, status codes, chaos injection |
+| `-q` | off | Suppress all log output (progress bar remains) |
 
 Logs stream to **stderr** by default, keeping stdout clean for JSON output piping:
 
@@ -149,8 +245,10 @@ strobengine load http://localhost:8080/api/health -vv --json > results.json
 strobengine separates configuration, execution, and metrics into clean Rust modules, exposed to Python via PyO3:
 
 - **`config`** -- `TestConfig` for static load, `LoadProfile` enum for dynamic profiles (Constant, Ramp, Spike) with target concurrency interpolation.
-- **`worker`** -- Async worker loops accepting `CancellationToken` for graceful shutdown. Workers finish in-flight requests before exiting.
+- **`worker`** -- Async worker loops with method-aware request building, static payload reuse (Bytes), and zero-allocation header management via `ClientBuilder::default_headers()`.
 - **`metrics`** -- Lock-free atomic counters (`AtomicUsize`) track total requests and errors without contention. An aggregator task collects raw latencies, then `calculate_summary` computes average, p95, and p99 percentiles in Rust at bare-metal speed.
+- **`chaos`** -- Protocol-agnostic fault injection engine with `ChaosEngine` evaluator and `ChaosFault` enum (LatencySpike, CorruptedPayload, MetadataCorruption, ConnectionDrop).
+- **`progress`** -- Background Tokio render task sampling atomic metrics every 200ms, displaying live RPS, active VUs, and latency via indicatif.
 - **Orchestrator** -- Supervisor task ticks every 200ms, calculates target concurrency from the active profile curve, spawns/aborts workers dynamically.
 
 The Python GIL is released entirely via `py.detach()` during test execution, allowing the full Tokio thread pool to run concurrently without throttling Python.
@@ -185,3 +283,4 @@ uv run pytest -v
 ## License
 
 This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.
+

strobengine-0.1.0/PKG-INFO → strobengine-0.2.0/README.md

@@ -1,14 +1,3 @@
-Metadata-Version: 2.4
-Name: strobengine
-Version: 0.1.0
-Requires-Dist: rich>=13.0.0
-Requires-Dist: typer>=0.27.0
-License-File: LICENSE
-Summary: A load testing framework with a Python UI and a bare-metal Rust engine core.
-Author-email: riccione <28346232+riccione@users.noreply.github.com>
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
-
 # strobengine
 
 A high-performance HTTP load testing engine with a Python API and a bare-metal Rust core.
@@ -29,6 +18,10 @@ A high-performance HTTP load testing engine with a Python API and a bare-metal R
 | tokio-util | 0.7 | CancellationToken for graceful worker shutdown |
 | tracing | 0.1 | Structured logging instrumentation |
 | tracing-subscriber | 0.3 | Log formatting and output (stderr/file) |
+| indicatif | 0.17 | Terminal progress bar rendering |
+| fastrand | 2 | Fast random number generation for chaos injection |
+| http | 1 | HTTP method types and header primitives |
+| bytes | 1 | Zero-copy byte buffer for request payloads |
 
 ## Installation & Compilation
 
@@ -74,6 +67,15 @@ engine = StrobEngine.spike_test(
 summary = engine.run()
 
 print_summary(summary, url=engine._url, duration_secs=30)
+
+# POST request with JSON body and custom headers
+engine = StrobEngine(
+    url="http://localhost:8080/api/data",
+    method="POST",
+    body='{"name": "test", "value": 42}',
+    headers=[("Authorization", "Bearer token123")],
+)
+summary = engine.run()
 ```
 
 For async contexts (FastAPI, Typer, etc.):
@@ -96,6 +98,25 @@ strobengine spike http://localhost:8080/api/health --baseline 5 --peak 1000 --pr
 
 # JSON output for CI/CD
 strobengine load http://localhost:8080/api/health --json
+
+# Chaos/fault injection test (~10% of requests get faults)
+strobengine load http://localhost:8080/api/health --chaos
+
+# POST with JSON body
+strobengine load http://localhost:8080/api/data --method POST --body '{"key": "val"}'
+
+# PUT with custom headers
+strobengine load http://localhost:8080/api/resource/1 \
+  --method PUT --body '{"name": "updated"}' --header "Authorization: Bearer token"
+
+# DELETE
+strobengine load http://localhost:8080/api/resource/1 --method DELETE
+
+# Verbose debug output
+strobengine load http://localhost:8080/api/health -vv
+
+# Quiet mode (suppress logs, keep progress bar)
+strobengine load http://localhost:8080/api/health -q
 ```
 
 By default, this spawns **10 concurrent workers** for **10 seconds** with a **10-second request timeout**. Results are displayed as a formatted table with total requests, errors, requests/sec, and latency percentiles (avg, p95, p99).
@@ -115,6 +136,14 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `-c`, `--concurrency` | `10` | Number of concurrent workers |
 | `-d`, `--duration` | `10` | Duration in seconds |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON instead of formatted table |
 
 ### Stress Subcommand Options
@@ -126,6 +155,14 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--ramp` | `60` | Ramp duration in seconds |
 | `--hold` | `30` | Hold duration at target concurrency |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON |
 
 ### Spike Subcommand Options
@@ -138,16 +175,48 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `--spike-duration` | `10` | Spike duration in seconds |
 | `--post-spike` | `5` | Post-spike duration in seconds |
 | `-t`, `--timeout` | `10` | Per-request timeout in seconds |
+| `--method` | `GET` | HTTP method (GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS) |
+| `--body` | none | Request body (raw string) |
+| `--header` | none | Custom header key:value (repeatable) |
+| `--chaos` | off | Enable fault injection (~10% of requests) |
+| `--no-progress` | off | Suppress live progress bar |
+| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
+| `-q`, `--quiet` | off | Suppress all output |
+| `--log-file <path>` | none | Write logs to file |
 | `--json` | off | Output raw JSON |
 
 ### Global Options
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-v`, `-vv`, `-vvv` | warn | Increase verbosity (INFO, DEBUG, TRACE) |
-| `-q`, `--quiet` | off | Suppress all output |
-| `--log-file <path>` | none | Write logs to file |
-| `-V`, `--version` | off | Show version and exit |
+| Flag | Description |
+|------|-------------|
+| `-V`, `--version` | Show version and exit |
+
+> **HTTP Methods, Bodies & Headers:** See [docs/http_methods.md](docs/http_methods.md) for detailed documentation on supported HTTP methods, request body handling, custom headers, and performance characteristics.
+
+### Live Progress Bar
+
+During test execution, a live progress bar displays on stderr with real-time telemetry:
+
+```
+⠋ [00:00:05] [==============>-------------] 40% | 1250 req/s | 20 VUs | 12 err | avg 4.2ms
+```
+
+- **RPS**: Instantaneous requests per second (sampled every 200ms)
+- **VUs**: Active virtual users / concurrent workers
+- **Errors**: Total error count
+- **Avg latency**: Running average across all completed requests
+
+The progress bar auto-detects non-TTY environments (CI/CD, piped output) and suppresses itself. Use `--no-progress` to explicitly disable it on interactive terminals.
+
+### Verbosity Levels
+
+| Flag | Level | Shows |
+|------|-------|-------|
+| (default) | `warn` | Errors and warnings only |
+| `-v` | `info` | Engine start/stop, test configuration |
+| `-vv` | `debug` | Worker spawn, HTTP errors, connection events |
+| `-vvv` | `trace` | Per-request latency, status codes, chaos injection |
+| `-q` | off | Suppress all log output (progress bar remains) |
 
 Logs stream to **stderr** by default, keeping stdout clean for JSON output piping:
 
@@ -160,8 +229,10 @@ strobengine load http://localhost:8080/api/health -vv --json > results.json
 strobengine separates configuration, execution, and metrics into clean Rust modules, exposed to Python via PyO3:
 
 - **`config`** -- `TestConfig` for static load, `LoadProfile` enum for dynamic profiles (Constant, Ramp, Spike) with target concurrency interpolation.
-- **`worker`** -- Async worker loops accepting `CancellationToken` for graceful shutdown. Workers finish in-flight requests before exiting.
+- **`worker`** -- Async worker loops with method-aware request building, static payload reuse (Bytes), and zero-allocation header management via `ClientBuilder::default_headers()`.
 - **`metrics`** -- Lock-free atomic counters (`AtomicUsize`) track total requests and errors without contention. An aggregator task collects raw latencies, then `calculate_summary` computes average, p95, and p99 percentiles in Rust at bare-metal speed.
+- **`chaos`** -- Protocol-agnostic fault injection engine with `ChaosEngine` evaluator and `ChaosFault` enum (LatencySpike, CorruptedPayload, MetadataCorruption, ConnectionDrop).
+- **`progress`** -- Background Tokio render task sampling atomic metrics every 200ms, displaying live RPS, active VUs, and latency via indicatif.
 - **Orchestrator** -- Supervisor task ticks every 200ms, calculates target concurrency from the active profile curve, spawns/aborts workers dynamically.
 
 The Python GIL is released entirely via `py.detach()` during test execution, allowing the full Tokio thread pool to run concurrently without throttling Python.
@@ -196,4 +267,3 @@ uv run pytest -v
 ## License
 
 This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.
-