strobengine 0.2.0__tar.gz → 0.3.0__tar.gz

strobengine-0.3.0/.dockerignore

@@ -0,0 +1,34 @@
+# Git metadata
+.git/
+.gitignore
+
+# Rust build artifacts & cargo cache
+target/
+**/*.rs.bk
+
+# Python cache & virtual environments
+.venv/
+venv/
+env/
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+
+# IDE and OS metadata
+.idea/
+.vscode/
+*.swp
+.DS_Store
+
+# Test & benchmark output artifacts
+results/
+dist/
+*.egg-info/
+
+# Docker files
+Dockerfile
+.dockerignore

{strobengine-0.2.0 → strobengine-0.3.0}/.github/workflows/ci.yml

@@ -56,3 +56,7 @@ jobs:
         run: |
           uv run ruff check
           uv run ruff format --check
+
+      - name: Run Tests
+        run: |
+          uv run pytest -v

strobengine-0.3.0/.github/workflows/docker-release.yml

@@ -0,0 +1,53 @@
+---
+name: Build & Push Docker Image
+
+on:
+  release:
+    types: [published]
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+
+jobs:
+  docker-publish:
+    name: Build and Push Docker Image
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout Code
+        uses: actions/checkout@v7
+
+      - name: Set up QEMU (for multi-arch support)
+        uses: docker/setup-qemu-action@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v4
+
+      - name: Log in to Docker Hub
+        uses: docker/login-action@v4
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Extract Docker Metadata (Tags & Labels)
+        id: meta
+        uses: docker/metadata-action@v6
+        with:
+          images: ${{ secrets.DOCKERHUB_USERNAME }}/strobengine
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable=${{ github.ref == 'refs/heads/main' || startsWith(github.ref, 'refs/tags/v') }}
+
+      - name: Build and Push Docker Image
+        uses: docker/build-push-action@v7
+        with:
+          context: .
+          file: ./Dockerfile
+          push: true
+          platforms: linux/amd64,linux/arm64
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

{strobengine-0.2.0 → strobengine-0.3.0}/.github/workflows/publish-test.yml

@@ -6,11 +6,24 @@ on:
 
 jobs:
   build-wheels:
-    name: Build wheels on ${{ matrix.os }}
+    name: Build wheels on ${{ matrix.os }} (${{ matrix.target || 'native' }})
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        include:
+          # Linux
+          - os: ubuntu-latest
+            target: x86_64
+          # Windows
+          - os: windows-latest
+            target: x64
+          # macOS Apple Silicon (ARM64)
+          - os: macos-latest
+            target: aarch64
+          # macOS Intel (x86_64) cross-compiled on macos-latest
+          - os: macos-latest
+            target: x86_64
     steps:
       - uses: actions/checkout@v7
 
@@ -22,6 +35,7 @@ jobs:
       - name: Build wheels via Maturin
         uses: PyO3/maturin-action@v1
         with:
+          target: ${{ matrix.target }}
           args: --release --out dist --find-interpreter
           sccache: 'true'
           sdist: false
@@ -29,7 +43,7 @@ jobs:
       - name: Upload wheel artifacts
         uses: actions/upload-artifact@v7
         with:
-          name: wheels-${{ matrix.os }}
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
           path: dist/*.whl
 
   build-sdist:
@@ -71,3 +85,4 @@ jobs:
         with:
           repository-url: https://test.pypi.org/legacy/
           packages-dir: dist/
+          skip-existing: true  # Skips 400 errors for already uploaded files

{strobengine-0.2.0 → strobengine-0.3.0}/.github/workflows/publish.yml

@@ -9,11 +9,24 @@ on:
 
 jobs:
   build-wheels:
-    name: Build wheels on ${{ matrix.os }}
+    name: Build wheels on ${{ matrix.os }} (${{ matrix.target || 'native' }})
     runs-on: ${{ matrix.os }}
     strategy:
+      fail-fast: false
       matrix:
-        os: [ubuntu-latest, macos-latest, windows-latest]
+        include:
+          # Linux
+          - os: ubuntu-latest
+            target: x86_64
+          # Windows
+          - os: windows-latest
+            target: x64
+          # macOS Apple Silicon (ARM64)
+          - os: macos-latest
+            target: aarch64
+          # macOS Intel (x86_64) cross-compiled on macos-latest
+          - os: macos-latest
+            target: x86_64
     steps:
       - uses: actions/checkout@v7
 
@@ -25,6 +38,7 @@ jobs:
       - name: Build wheels via Maturin
         uses: PyO3/maturin-action@v1
         with:
+          target: ${{ matrix.target }}
           args: --release --out dist --find-interpreter
           sccache: 'true'
           sdist: false
@@ -32,7 +46,7 @@ jobs:
       - name: Upload wheel artifacts
         uses: actions/upload-artifact@v7
         with:
-          name: wheels-${{ matrix.os }}
+          name: wheels-${{ matrix.os }}-${{ matrix.target }}
           path: dist/*.whl
 
   build-sdist:

strobengine-0.3.0/.pre-commit-config.yaml

@@ -0,0 +1,47 @@
+---
+default_stages: [pre-push]
+
+repos:
+  - repo: local
+    hooks:
+      - id: cargo-fmt
+        name: cargo fmt
+        entry: cargo fmt --check
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+      - id: cargo-clippy
+        name: cargo clippy
+        entry: cargo clippy --all-targets --all-features -- -D warnings
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+      - id: cargo-test
+        name: cargo test
+        entry: cargo test
+        language: system
+        types: [rust]
+        pass_filenames: false
+
+      - id: ruff-check
+        name: ruff check
+        entry: uv run ruff check .
+        language: system
+        types: [python]
+        pass_filenames: false
+
+      - id: ruff-format
+        name: ruff format
+        entry: uv run ruff format --check .
+        language: system
+        types: [python]
+        pass_filenames: false
+
+      - id: pytest
+        name: pytest
+        entry: uv run pytest -v
+        language: system
+        types: [python]
+        pass_filenames: false

{strobengine-0.2.0 → strobengine-0.3.0}/CHANGELOG.md

@@ -4,6 +4,88 @@ 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.3.0] - 2026-08-13
+
+### Bug Fixes
+
+- *(logging)* Log warning on invalid EnvFilter string (#59)
+- *(logging)* Warn when log file creation fails (#60)
+- *(cli)* Auto-detect value-taking flags in positional arg detection (#61)
+- *(cli)* Map trace log level to custom level 5 instead of DEBUG (#63)
+
+### Documentation
+
+- *(readme)* Add custom HTTP headers usage examples (#55)
+- Add --form flag to README CLI reference
+- Update roadmap to reflect recent project changes (#62)
+- *(worker)* Document u64::MAX fallback for extreme latencies (#66)
+- Consolidate testing guide into docs/testing.md
+- *(docker)* Add Docker usage documentation
+
+### Features
+
+- *(rust)* Add form payload support to TestConfig and Content-Type logic
+- *(python)* Add --form flag and type stubs
+- *(cli)* Add --form payload support for URL-encoded request bodies (#56)
+- *(metrics)* Add latency distribution, status code aggregation, and structured JSON repor (#72)
+
+### Miscellaneous Tasks
+
+- *(dev)* Setup pre-commit hooks and Makefile for local pre-push checks (#58)
+- *(github)* Add Docker build and push workflow for releases
+
+### Other
+
+- *(deps)* Add urlencoding crate for form payload encoding
+- *(deps)* Add aiohttp dev dependency for e2e test server
+- *(docker)* Add multi-stage Dockerfile for Maturin package
+- *(docker)* Add .dockerignore to optimize build context
+- *(docker)* Switch runtime container execution to non-root user
+
+### Refactoring
+
+- *(engine)* Unify load test execution via ConcurrencyStrategy (#54)
+- *(worker)* Remove unused status_code and is_error from RequestMetric (#57)
+- *(progress)* Remove unused `_total_duration` param from `create_progress_bar` (#64)
+
+### Testing
+
+- Remove trivial allocator unit test (#65)
+- *(e2e)* Add async mock server with status, delay, echo, and flaky endpoints
+- Add e2e mock server (#67)
+- *(e2e)* Add `cli_bin` fixture to detect strobengine CLI path (#68)
+- *(e2e)* Harden mock server with AppKey types and header normalization
+- *(e2e)* Switch mock_server fixture to threaded AppRunner
+- *(e2e)* Add HTTP scenario tests against mock server
+- *(e2e)* Harden mock server and consolidate testing docs
+- *(e2e)* Add subprocess-based CLI interface tests (#70)
+- *(e2e)* Configure --e2e pytest flag and CI pipeline step (#71)
+## [0.2.1] - 2026-08-03
+
+### Bug Fixes
+
+- *(types)* Correct headers type in _strobengine.pyi from dict to list of tuples (#41)
+- Replace build_client panic with proper error propagation (#42)
+- Replace std::process::exit with safe PyKeyboardInterrupt on SIGINT (#43)
+- *(progress)* Guard against zero total_duration in progress bar calculation (#44)
+- Improve worker shutdown and panic handling (#45)
+- *(metrics)* Normalize counter types to AtomicU64 for 32-bit safety (#46)
+- *(cli)* Add type annotation to _output_results summary parameter (#48)
+
+### Documentation
+
+- Add comment explaining SystemExit re-raise pattern (#50)
+
+### Miscellaneous Tasks
+
+- Remove unnecessary clippy allow on run_load_test (#47)
+- Add multi-architecture matrix for macOS wheel builds (#52)
+- Prepare for release 0.2.1
+
+### Refactoring
+
+- Extract magic number 8192 to named constant METRIC_CHANNEL_BUFFER (#49)
+- Extract magic numbers to named constants across Rust and Python (#51)
 ## [0.2.0] - 2026-08-02
 
 ### Bug Fixes
@@ -20,6 +102,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Update roadmap to reflect changes (#34)
 - Add HTTP method, body, and header documentation
 - Add code examples (#37)
+- *(changelog)* Update CHANGELOG.md for v0.2.0 release
 
 ### Features
 
@@ -43,6 +126,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - *(release)* Prepare v0.1.0 changelog and tag
 - Add PyPI publish workflow with tag-based triggering (#26)
+- *(pyproject)* Add license metadata and project URLs, bump version
+- *(release)* Merge v0.2.0 release prep into main (#40)
 
 ### Performance
 

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

@@ -210,7 +210,7 @@ source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "39cab71617ae0d63f51a36d69f866391735b51691dbda63cf6f96d042b63efeb"
 dependencies = [
  "libc",
- "windows-sys 0.52.0",
+ "windows-sys 0.61.2",
 ]
 
 [[package]]
@@ -1273,7 +1273,7 @@ checksum = "6ce2be8dc25455e1f91df71bfa12ad37d7af1092ae736f3a6cd0e37bc7810596"
 
 [[package]]
 name = "strobengine"
-version = "0.2.0"
+version = "0.3.0"
 dependencies = [
  "bytes",
  "fastrand",
@@ -1286,6 +1286,7 @@ dependencies = [
  "tokio-util",
  "tracing",
  "tracing-subscriber",
+ "urlencoding",
 ]
 
 [[package]]
@@ -1616,6 +1617,12 @@ dependencies = [
  "serde",
 ]
 
+[[package]]
+name = "urlencoding"
+version = "2.1.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "daf8dba3b7eb870caf1ddeed7bc9d2a049f3cfdfae7cb521b087cc33ae4c49da"
+
 [[package]]
 name = "utf8_iter"
 version = "1.0.4"

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

@@ -1,6 +1,6 @@
 [package]
 name = "strobengine"
-version = "0.2.0"
+version = "0.3.0"
 edition = "2024"
 readme = "README.md"
 
@@ -23,5 +23,6 @@ tokio-util = { version = "0.7", features = ["rt"] }
 tracing = "0.1"
 tracing-subscriber = { version = "0.3", features = ["env-filter", "fmt", "registry"] }
 mimalloc = "0.1.52"
+urlencoding = "2"
 fastrand = "2.5"
 indicatif = "0.18.6"

strobengine-0.3.0/Dockerfile

@@ -0,0 +1,28 @@
+# Stage 1: Build wheel
+FROM python:3.11-slim AS builder
+RUN apt-get update && apt-get install -y curl build-essential
+RUN curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
+ENV PATH="/root/.cargo/bin:${PATH}"
+RUN pip install maturin
+
+WORKDIR /app
+COPY . .
+RUN maturin build --release --out dist
+
+# Stage 2: Minimal Runtime Image
+FROM python:3.11-slim
+
+# Create a non-privileged system user and group
+RUN groupadd -r appuser && useradd -r -g appuser appuser
+
+WORKDIR /app
+
+# Copy built wheels with proper ownership
+COPY --from=builder /app/dist/*.whl .
+RUN pip install --no-cache-dir *.whl && rm *.whl
+
+# Switch execution context away from root
+USER appuser
+
+ENTRYPOINT ["strobengine"]
+CMD ["--help"]

strobengine-0.3.0/Makefile

@@ -0,0 +1,11 @@
+.PHONY: check fix
+
+# Shortcut for manual pre-commit check
+check:
+	pre-commit run --hook-stage pre-push --all-files
+
+# Quick command to auto-fix formatting before pushing
+fix:
+	cargo fmt
+	uv run ruff check --fix .
+	uv run ruff format .

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

@@ -1,3 +1,19 @@
+Metadata-Version: 2.4
+Name: strobengine
+Version: 0.3.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/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 load testing engine with a Python API and a bare-metal Rust core.
@@ -36,6 +52,18 @@ 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.
 
+### Docker
+
+Alternatively, pull and run strobengine directly from Docker Hub:
+
+```bash
+docker pull strobeops/strobengine:latest
+docker run --rm -it strobeops/strobengine load http://host.docker.internal:8080/api/health -c 50 -d 30
+```
+
+> See [docs/docker.md](docs/docker.md) for full Docker documentation including
+> version tags, host networking, and building locally.
+
 ## Quick Start Usage
 
 ```python
@@ -46,27 +74,29 @@ from strobengine.reporter import print_summary
 engine = StrobEngine(url="http://localhost:8080/api/health", concurrency=50, duration=30)
 summary = engine.run()
 
-print_summary(summary, url=engine._url, duration_secs=30)
+print_summary(summary)
 
 # Ramp/stress test (10 -> 200 workers over 60s, hold 30s)
 engine = StrobEngine.stress_test(
     "http://localhost:8080/api/health",
     start_concurrency=10, max_concurrency=200,
     ramp_duration=60, hold_duration=30,
+    headers=[("Authorization", "Bearer token123")],
 )
 summary = engine.run()
 
-print_summary(summary, url=engine._url, duration_secs=30)
+print_summary(summary)
 
 # Spike test (baseline 5 -> peak 500 -> back to 5)
 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,
+    headers=[("X-Custom", "value")],
 )
 summary = engine.run()
 
-print_summary(summary, url=engine._url, duration_secs=30)
+print_summary(summary)
 
 # POST request with JSON body and custom headers
 engine = StrobEngine(
@@ -109,6 +139,16 @@ strobengine load http://localhost:8080/api/data --method POST --body '{"key": "v
 strobengine load http://localhost:8080/api/resource/1 \
   --method PUT --body '{"name": "updated"}' --header "Authorization: Bearer token"
 
+# Multiple headers (repeatable -H flag)
+strobengine load http://localhost:8080/api/data \
+  --method POST --body '{"key": "val"}' \
+  --header "Authorization: Bearer token" \
+  --header "X-Request-ID: abc-123"
+
+# POST with URL-encoded form data
+strobengine load http://localhost:8080/api/data \
+  --method POST --form "key1=value1&key2=value2"
+
 # DELETE
 strobengine load http://localhost:8080/api/resource/1 --method DELETE
 
@@ -119,7 +159,7 @@ strobengine load http://localhost:8080/api/health -vv
 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).
+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
 
@@ -138,6 +178,7 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `-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 |
@@ -157,6 +198,7 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `-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 |
@@ -177,6 +219,7 @@ By default, this spawns **10 concurrent workers** for **10 seconds** with a **10
 | `-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 |
@@ -230,7 +273,7 @@ strobengine separates configuration, execution, and metrics into clean Rust modu
 
 - **`config`** -- `TestConfig` for static load, `LoadProfile` enum for dynamic profiles (Constant, Ramp, Spike) with target concurrency interpolation.
 - **`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.
+- **`metrics`** -- Lock-free atomic counters (`AtomicUsize`) track total requests and errors without contention. An aggregator task collects raw latencies, then `calculate_summary` computes min, average, p50, p90, p95, p99, and max 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.
@@ -239,27 +282,21 @@ The Python GIL is released entirely via `py.detach()` during test execution, all
 
 ## Testing
 
-Run the full test suite with:
-
-```bash
-# Rust unit tests
-cargo test
-
-# Python unit tests
-uv run pytest -v
-```
+> See [docs/testing.md](docs/testing.md) for the full testing guide, including
+> e2e tests, CI/CD checks, and running individual test suites.
 
 ## How to Contribute
 
 1. Fork the repository
 2. Create a feature branch (`git checkout -b feat/my-feature`)
-3. Make your changes
-4. Run formatting, linting, and tests:
+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
-   cargo fmt
-   cargo clippy --all-targets -- -D warnings
-   cargo test
-   uv run pytest -v
+   make check
    ```
 5. Commit your changes following [Conventional Commits](https://www.conventionalcommits.org/)
 6. Push to your branch and open a Pull Request
@@ -267,3 +304,4 @@ uv run pytest -v
 ## License
 
 This project is licensed under the Apache License, Version 2.0. See [LICENSE](LICENSE) for the full text.
+