strobengine 0.4.0__tar.gz → 0.4.1__tar.gz

{strobengine-0.4.0 → strobengine-0.4.1}/CHANGELOG.md

@@ -4,6 +4,27 @@ 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.4.1] - 2026-08-26
+
+### Bug Fixes
+
+- *(pypi)* Configure readme base-url for relative link resolution
+- *(cli)* Validate ws_mode with StrEnum to reject invalid strings
+- *(cli)* URL-decode form values before passing to Rust
+- *(websocket)* Count actual Pong payload size and fix PingPong status code
+- *(reporter)* Handle GB and TB in _format_bytes
+
+### Documentation
+
+- Add dependencies and installation guides
+- Add quick start guide and CLI reference
+- Update table of contents with new pages
+- Slim README and link to documentation pages
+- Add multi-target, reporting, SSE, messaging, and caching epics to roadmap
+
+### Testing
+
+- *(e2e)* Remove bytes_received assertion from PingPong mode test
 ## [0.4.0] - 2026-08-23
 
 ### Bug Fixes
@@ -105,6 +126,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add rust-toolchain.toml for reproducible builds
 - Remove e2e test from pre commit hooks
 - *(ci)* Pin github actions to full commit SHAs
+- *(release)* Bump version to 0.4.0
+- Bump to 0.4.0 in uv.lock
 
 ### Other
 

{strobengine-0.4.0 → strobengine-0.4.1}/Cargo.lock

@@ -1781,7 +1781,7 @@ checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
 
 [[package]]
 name = "strobengine"
-version = "0.4.0"
+version = "0.4.1"
 dependencies = [
  "async-trait",
  "base64",

{strobengine-0.4.0 → strobengine-0.4.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "strobengine"
-version = "0.4.0"
+version = "0.4.1"
 edition = "2024"
 readme = "README.md"
 

strobengine-0.4.1/PKG-INFO

@@ -0,0 +1,83 @@
+Metadata-Version: 2.4
+Name: strobengine
+Version: 0.4.1
+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
+Project-URL: Changelog, https://github.com/strobeops/strobengine/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/strobeops/strobengine
+Project-URL: Homepage, https://github.com/strobeops/strobengine
+Project-URL: Source, https://github.com/strobeops/strobengine
+
+# strobengine
+
+A high-performance HTTP, WebSocket, and gRPC load testing engine with a Python API and a bare-metal Rust core.
+
+## Install
+
+```bash
+pip install strobengine
+# or from source
+git clone https://github.com/strobeops/strobengine.git && cd strobengine && uv sync
+```
+
+> See [Installation Guide](docs/install.md) for Docker, PyPI, and development setup.
+
+## Quick Start
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporter import print_summary
+
+engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
+summary = engine.run()
+print_summary(summary)
+```
+
+```bash
+strobengine load http://localhost:8080/api/health -c 50 -d 30
+```
+
+> See [Quick Start Guide](docs/quickstart.md) for Python API and CLI examples.
+
+## Documentation
+
+| Section | Description |
+|---------|-------------|
+| [Installation](docs/install.md) | Build from source, Docker, PyPI |
+| [Dependencies](docs/dependencies.md) | System requirements, Rust crates, Python packages |
+| [Quick Start](docs/quickstart.md) | Python API and CLI usage examples |
+| [CLI Reference](docs/cli.md) | All subcommands, flags, and options |
+| [HTTP Methods](docs/http_methods.md) | Supported methods, request bodies, headers |
+| [WebSocket](docs/websockets.md) | WS/WSS modes, pub/sub broadcasting, metrics |
+| [gRPC](docs/grpc.md) | Unary calls, protobuf, deadline, chaos |
+| [HTTP/3](docs/http3.md) | QUIC transport, 0-RTT resumption, loss recovery |
+| [Docker](docs/docker.md) | Pulling images, running containers |
+| [Testing](docs/testing.md) | Test structure, e2e, CI/CD |
+| [Roadmap](docs/roadmap.md) | Planned features |
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/my-feature`)
+3. Install dependencies and set up pre-push Git hooks:
+   ```bash
+   uv sync
+   uv run pre-commit install --hook-type pre-push
+   ```
+4. Run formatting, linting, and tests manually (or let git push run them automatically):
+   ```bash
+   make check
+   ```
+5. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
+6. Push to your branch and open a Pull Request
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.
+

strobengine-0.4.1/README.md

@@ -0,0 +1,66 @@
+# strobengine
+
+A high-performance HTTP, WebSocket, and gRPC load testing engine with a Python API and a bare-metal Rust core.
+
+## Install
+
+```bash
+pip install strobengine
+# or from source
+git clone https://github.com/strobeops/strobengine.git && cd strobengine && uv sync
+```
+
+> See [Installation Guide](docs/install.md) for Docker, PyPI, and development setup.
+
+## Quick Start
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporter import print_summary
+
+engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
+summary = engine.run()
+print_summary(summary)
+```
+
+```bash
+strobengine load http://localhost:8080/api/health -c 50 -d 30
+```
+
+> See [Quick Start Guide](docs/quickstart.md) for Python API and CLI examples.
+
+## Documentation
+
+| Section | Description |
+|---------|-------------|
+| [Installation](docs/install.md) | Build from source, Docker, PyPI |
+| [Dependencies](docs/dependencies.md) | System requirements, Rust crates, Python packages |
+| [Quick Start](docs/quickstart.md) | Python API and CLI usage examples |
+| [CLI Reference](docs/cli.md) | All subcommands, flags, and options |
+| [HTTP Methods](docs/http_methods.md) | Supported methods, request bodies, headers |
+| [WebSocket](docs/websockets.md) | WS/WSS modes, pub/sub broadcasting, metrics |
+| [gRPC](docs/grpc.md) | Unary calls, protobuf, deadline, chaos |
+| [HTTP/3](docs/http3.md) | QUIC transport, 0-RTT resumption, loss recovery |
+| [Docker](docs/docker.md) | Pulling images, running containers |
+| [Testing](docs/testing.md) | Test structure, e2e, CI/CD |
+| [Roadmap](docs/roadmap.md) | Planned features |
+
+## How to Contribute
+
+1. Fork the repository
+2. Create a feature branch (`git checkout -b feat/my-feature`)
+3. Install dependencies and set up pre-push Git hooks:
+   ```bash
+   uv sync
+   uv run pre-commit install --hook-type pre-push
+   ```
+4. Run formatting, linting, and tests manually (or let git push run them automatically):
+   ```bash
+   make check
+   ```
+5. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
+6. Push to your branch and open a Pull Request
+
+## License
+
+This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.

strobengine-0.4.1/docs/cli.md

@@ -0,0 +1,147 @@
+# CLI Reference
+
+strobengine provides a CLI for running load tests from the terminal.
+
+## Default Behavior
+
+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 (min, avg, p50, p90, p95, p99, max).
+
+## Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `load` | Constant load test (default if no subcommand given) |
+| `stress` | Ramp from starting to target concurrency, then hold |
+| `spike` | Baseline -> peak -> baseline |
+
+## Load Subcommand Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `-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) |
+| `--form` | none | Form data body (e.g. key1=val1&key2=val2) |
+| `--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 |
+| `--ws-mode` | `handshake` | WebSocket mode: `handshake`, `ping_pong`, `stream` |
+| `--ws-payload` | none | WebSocket text payload for stream mode |
+| `--ws-role` | none | WebSocket Pub/Sub role: `publisher`, `subscriber` |
+| `--ws-publish-interval` | none | Publisher send interval in milliseconds |
+| `--ws-subscribers` | none | Number of subscriber workers |
+| `--grpc-service` | none | gRPC service name (e.g. helloworld.Greeter) |
+| `--grpc-method` | none | gRPC method name (e.g. SayHello) |
+| `--grpc-payload` | none | Base64-encoded protobuf payload |
+| `--grpc-deadline-ms` | none | gRPC deadline in milliseconds |
+| `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
+| `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
+| `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+
+## Stress Subcommand Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--from` | `10` | Starting concurrency |
+| `--to` | `200` | Target concurrency |
+| `--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) |
+| `--form` | none | Form data body (e.g. key1=val1&key2=val2) |
+| `--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 |
+| `--ws-mode` | `handshake` | WebSocket mode: `handshake`, `ping_pong`, `stream` |
+| `--ws-payload` | none | WebSocket text payload for stream mode |
+| `--ws-role` | none | WebSocket Pub/Sub role: `publisher`, `subscriber` |
+| `--ws-publish-interval` | none | Publisher send interval in milliseconds |
+| `--ws-subscribers` | none | Number of subscriber workers |
+| `--grpc-service` | none | gRPC service name (e.g. helloworld.Greeter) |
+| `--grpc-method` | none | gRPC method name (e.g. SayHello) |
+| `--grpc-payload` | none | Base64-encoded protobuf payload |
+| `--grpc-deadline-ms` | none | gRPC deadline in milliseconds |
+| `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
+| `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
+| `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+
+## Spike Subcommand Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--baseline` | `5` | Baseline concurrency |
+| `--peak` | `500` | Peak concurrency |
+| `--pre-spike` | `5` | Pre-spike duration in seconds |
+| `--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) |
+| `--form` | none | Form data body (e.g. key1=val1&key2=val2) |
+| `--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 |
+| `--ws-mode` | `handshake` | WebSocket mode: `handshake`, `ping_pong`, `stream` |
+| `--ws-payload` | none | WebSocket text payload for stream mode |
+| `--ws-role` | none | WebSocket Pub/Sub role: `publisher`, `subscriber` |
+| `--ws-publish-interval` | none | Publisher send interval in milliseconds |
+| `--ws-subscribers` | none | Number of subscriber workers |
+| `--grpc-service` | none | gRPC service name (e.g. helloworld.Greeter) |
+| `--grpc-method` | none | gRPC method name (e.g. SayHello) |
+| `--grpc-payload` | none | Base64-encoded protobuf payload |
+| `--grpc-deadline-ms` | none | gRPC deadline in milliseconds |
+| `--http3/--no-http3` | off | Enable HTTP/3 over QUIC |
+| `--quic-zero-rtt` | off | Enable QUIC 0-RTT connection testing |
+| `--quic-max-idle-timeout` | none | QUIC max idle timeout in ms |
+
+## Global Options
+
+| Flag | Description |
+|------|-------------|
+| `-V`, `--version` | Show version and exit |
+
+## 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:
+
+```bash
+strobengine load http://localhost:8080/api/health -vv --json > results.json
+```
+
+## 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.

strobengine-0.4.1/docs/dependencies.md

@@ -0,0 +1,39 @@
+# Dependencies
+
+## System Requirements
+
+- **Python** >= 3.11
+- **Rust** stable (with `cargo`)
+- **uv** (Python package manager)
+
+## Rust Crates
+
+| Crate | Version | Purpose |
+|-------|---------|---------|
+| pyo3 | 0.29 | Python FFI bindings (stable ABI, abi3-py311) |
+| reqwest | 0.13 | HTTP client with connection pooling |
+| tonic | 0.14 | gRPC framework with TLS support |
+| quinn | 0.11 | QUIC transport for HTTP/3 |
+| h3 | 0.0.8 | HTTP/3 protocol implementation |
+| h3-quinn | 0.0.10 | h3-Quinn bridge |
+| tokio | 1.53 | Multi-threaded async runtime |
+| 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 |
+| tokio-tungstenite | 0.26 | WebSocket client with TLS support |
+| prost / prost-reflect | 0.14 / 0.16 | Protobuf encoding/decoding and reflection |
+| base64 | 0.22 | Base64 payload decoding for gRPC |
+| hex | 0.4 | Hex payload decoding for gRPC |
+
+## Python Dependencies
+
+| Package | Version | Purpose |
+|---------|---------|---------|
+| pytest | >= 8.0 | Test runner |
+| pytest-asyncio | >= 0.24 | Async test support |
+| aiohttp | >= 3.14 | Mock server for E2E tests |
+| ruff | >= 0.15 | Linting and formatting |

strobengine-0.4.1/docs/install.md

@@ -0,0 +1,52 @@
+# Installation
+
+## From Source (Recommended)
+
+```bash
+# Clone the repository
+git clone https://github.com/strobeops/strobengine.git
+cd strobengine
+
+# Build the native extension and install the package
+uv sync
+```
+
+`uv sync` invokes [maturin](https://github.com/PyO3/maturin) under the hood, which compiles the Rust code into a native Python extension module and installs it into your virtual environment.
+
+## From Docker
+
+Pull and run strobengine directly from Docker Hub:
+
+```bash
+# Latest release
+docker pull strobeops/strobengine:latest
+docker run --rm -it strobeops/strobengine load http://host.docker.internal:8080/api/health -c 50 -d 30
+
+# Specific version
+docker pull strobeops/strobengine:0.3.0
+```
+
+> See [Docker documentation](docker.md) for version tags, host networking, and building locally.
+
+## Verify Installation
+
+```bash
+# Check version
+strobengine --version
+
+# Or via Python
+uv run python -c "from strobengine import StrobEngine; print('OK')"
+```
+
+## Development Setup
+
+```bash
+# Install with dev dependencies
+uv sync
+
+# Install pre-commit hooks (optional)
+uv run pre-commit install --hook-type pre-push
+
+# Run the full check suite
+make check
+```

strobengine-0.4.1/docs/quickstart.md

@@ -0,0 +1,116 @@
+# Quick Start
+
+## Python API
+
+### Constant Load Test
+
+```python
+from strobengine import StrobEngine
+from strobengine.reporter import print_summary
+
+engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
+summary = engine.run()
+print_summary(summary)
+```
+
+### Ramp/Stress Test
+
+```python
+engine = StrobEngine.stress_test(
+    "http://localhost:8080/api/health",
+    start_concurrency=10,
+    max_concurrency=200,
+    ramp_duration=60,
+    hold_duration=30,
+)
+summary = engine.run()
+print_summary(summary)
+```
+
+### Spike Test
+
+```python
+engine = StrobEngine.spike_test(
+    "http://localhost:8080/api/health",
+    baseline=5,
+    peak_concurrency=500,
+    pre_spike_duration=5,
+    spike_duration=10,
+    post_spike_duration=5,
+)
+summary = engine.run()
+print_summary(summary)
+```
+
+### POST with JSON Body
+
+```python
+from strobengine import StrobEngine, RequestOptions
+
+engine = StrobEngine(
+    url="http://localhost:8080/api/data",
+    options=RequestOptions(
+        method="POST",
+        body='{"name": "test", "value": 42}',
+        headers=[("Authorization", "Bearer token123")],
+    ),
+)
+summary = engine.run()
+print_summary(summary)
+```
+
+### gRPC Unary Call
+
+```python
+engine = StrobEngine(
+    url="grpc://localhost:50051",
+    concurrency=10,
+    duration=30,
+    options=RequestOptions(
+        grpc_service="helloworld.Greeter",
+        grpc_method="SayHello",
+        grpc_payload="CgR0ZXN0",
+    ),
+)
+summary = engine.run()
+print_summary(summary)
+```
+
+### Async Execution
+
+For async contexts (FastAPI, Typer, etc.):
+
+```python
+summary = await engine.run_async()
+```
+
+## CLI Usage
+
+```bash
+# Constant load test (default subcommand)
+strobengine http://localhost:8080/api/health -c 50 -d 30
+
+# Ramp/stress test
+strobengine stress http://localhost:8080/api/health --from 10 --to 500 --ramp 60 --hold 30
+
+# Spike test
+strobengine spike http://localhost:8080/api/health --baseline 5 --peak 1000 --pre-spike 5 --spike-duration 10 --post-spike 5
+
+# 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"}'
+
+# gRPC unary call
+strobengine load grpc://localhost:50051 \
+  --grpc-service helloworld.Greeter \
+  --grpc-method SayHello \
+  --grpc-payload CgR0ZXN0 \
+  -c 10 -d 30
+```
+
+> See [CLI Reference](cli.md) for all available flags and options.

{strobengine-0.4.0 → strobengine-0.4.1}/docs/roadmap.md

@@ -55,6 +55,35 @@ This document outlines the planned trajectory and upcoming feature epics for **s
 
 ---
 
+## Multi-Target Parallel Execution
+
+### Epic: Multi-Target Parallel Execution
+*Target Focus: Concurrent Load Generation & Scripted Parallelism*
+
+- [x] Intra-test worker task concurrency (`-c`/`--workers` mapped to Tokio async threads). `[v0.1.0]`
+- [ ] Multi-target script orchestrator (`asyncio.gather` execution across multiple concurrent `StrobEngine` instances).
+- [ ] Native multi-URL target parsing & concurrent execution via CLI.
+- [ ] Process-level parallel execution runner integration (`pytest-xdist` parallel test pool orchestration).
+
+---
+
+## Reporting, Storage & Analytics
+
+### Epic: Test Persistence & Visual Reporting
+*Target Focus: Long-Term Benchmark Tracking & Visualization*
+
+- [ ] **Artifact Persistence Engine**
+  - [ ] Automatic disk storage for raw JSON execution metrics (`--output-dir`, `--save-report`).
+  - [ ] Standardized report schema featuring execution metadata (timestamps, CLI flags, system specs, latency percentiles).
+- [ ] **HTML / Visual Report Generator**
+  - [ ] Standalone HTML report output with embedded latency distribution charts (p50, p90, p95, p99).
+  - [ ] Summary dashboards comparing current runs against historical baseline artifacts.
+- [ ] **Export Formats**
+  - [ ] Markdown summary generation for CI/CD Pull Request integration (GitHub Actions step comments).
+  - [ ] CSV/JUnit XML exports for standard test runner ingestion.
+
+---
+
 ## Modern Web APIs
 
 ### Epic: Modern Web APIs
@@ -73,20 +102,32 @@ This document outlines the planned trajectory and upcoming feature epics for **s
 - [x] **HTTP/3 (QUIC)** `[v0.4.0] - 2026-08-23`
   - [x] UDP-based QUIC transport layer support. `[v0.4.0] - 2026-08-23`
   - [x] Zero-RTT connection testing and loss recovery benchmarking. `[v0.4.0] - 2026-08-23`
+- [ ] **Server-Sent Events (SSE / HTTP Streaming)**
+  - [ ] Persistent HTTP streaming response parsing (Time-to-First-Byte, chunk latency, LLM stream benchmarking).
 
 ---
 
 ## Infrastructure & Streaming Protocols
 
-### Epic: Infrastructure & Low-Level Transport
-*Target Focus: Enterprise & Deep Performance Testing*
+### Epic: Event-Driven Infrastructure & Message Queues
+*Target Focus: Async Microservices & IoT Protocols*
 
+- [ ] **MQTT (IoT / Telemetry)**
+  - [ ] Async MQTT client integration (`rumqttc`) for QoS 0/1/2 pub/sub benchmarking.
 - [ ] **Event Brokers**
-  - [ ] **Apache Kafka**: High-throughput producer load testing and message ingestion benchmarking.
-  - [ ] **MQTT**: IoT publish/subscribe message broker stress testing.
+  - [ ] **Apache Kafka / Redpanda**: Producer load testing and partition ingestion benchmarking.
+  - [ ] **RabbitMQ (AMQP)**: Queue message publish throughput and acknowledgment latencies.
+
+---
+
+### Epic: Infrastructure & Low-Level Transport
+*Target Focus: Network Layers & Caching Tiers*
+
 - [ ] **Low-Level Transport**
-  - [ ] **Raw TCP Socket Testing**: Custom payload socket streaming.
-  - [ ] **Raw UDP Socket Testing**: High-frequency datagram hammering and packet loss evaluation.
+  - [ ] **Raw TCP / TLS Socket Streaming**: Custom binary payload socket streaming (`tokio::net::TcpStream`).
+  - [ ] **UDP / QUIC Raw Sockets**: High-frequency datagram hammering, jitter evaluation, and packet loss tracking.
+- [ ] **In-Memory Caching Protocols**
+  - [ ] **Redis / RESP Protocol**: High-concurrency GET/SET operation benchmarking and connection pool stress testing.
 
 ---
 

{strobengine-0.4.0 → strobengine-0.4.1}/docs/table_of_contents.md

@@ -2,10 +2,14 @@
 
 ## Overview
 
-- [README](../README.md) -- Project overview, installation, quick start, CLI reference
+- [README](../README.md) -- Project overview, quick start, and links
+- [Installation](install.md) -- Build from source, Docker, PyPI
+- [Dependencies](dependencies.md) -- System requirements, Rust crates, Python packages
 
 ## Features
 
+- [Quick Start](quickstart.md) -- Python API and CLI usage examples
+- [CLI Reference](cli.md) -- All subcommands, flags, and options
 - [HTTP Methods](http_methods.md) -- Supported HTTP methods, request bodies, headers, performance
 - [WebSocket Load Testing](websockets.md) -- WS/WSS modes, pub/sub broadcasting, custom payloads, headers, metrics
 - [gRPC Load Testing](grpc.md) -- Unary calls, protobuf payloads, deadline, chaos
@@ -21,3 +25,4 @@
 - [Infrastructure](infrastructure.md) -- Build system, dependencies, architecture
 - [Roadmap](roadmap.md) -- Planned features and project direction
 - [Benchmarks](benchmarks.md) -- Performance benchmarks and methodology
+- [Release](release.md) -- Maintainer releases and versioning workflows

{strobengine-0.4.0 → strobengine-0.4.1}/pyproject.toml

@@ -1,8 +1,8 @@
 [project]
 name = "strobengine"
-version = "0.4.0"
+version = "0.4.1"
 description = "A load testing framework with a Python UI and a bare-metal Rust engine core."
-readme = "README.md"
+readme = { file = "README.md", content-type = "text/markdown", base-url = "https://github.com/strobeops/strobengine/blob/main/" }
 license = "Apache-2.0"
 license-files = [
   "LICENSE",