mayhem-cli 0.5.1__tar.gz

mayhem_cli-0.5.1/.github/workflows/release.yml

@@ -0,0 +1,58 @@
+name: Release to PyPI
+on:
+  push:
+    tags:
+      # Both conventions fire the release: `v0.5.0` and the repo's
+      # existing numeric tags (`0.5.0`, `0.5.0dev`). hatch-vcs strips a
+      # leading `v`, so either produces a clean PEP 440 version.
+      - "v*"
+      - "[0-9]*"
+
+permissions:
+  contents: read
+  id-token: write # trusted publishing (OIDC) — no PyPI token secret required
+
+jobs:
+  test:
+    name: Test (unit + integration)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install uv
+        run: python -m pip install --quiet uv
+      - name: Sync dev dependencies
+        run: uv sync --group dev
+      - name: Run tests
+        run: uv run pytest tests/unit tests/integration
+      # NOTE: `ruff check src/` is NOT gated here — the repository's committed
+      # ruff config currently reports 30-49 pre-existing violations under every
+      # ruff generation (0.8-0.16); the project has no lint-green baseline in
+      # its history. Land a lint-cleanup first, then re-add `ruff check src/`.
+      - name: Architectural contracts
+        run: uv run lint-imports
+
+  build-and-publish:
+    name: Build and publish to PyPI
+    needs: test
+    runs-on: ubuntu-latest
+    steps:
+      # Full history so hatch-vcs can resolve the invoking tag.
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Build wheel + sdist
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      # Trusted Publishing: authenticates via OIDC against the Trusted
+      # Publisher configured on pypi.org for this repository (owner
+      # magichrist, repo Mayhem, workflow release.yml). Do NOT add a
+      # username/password here — the action would try token auth.
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

mayhem_cli-0.5.1/.gitignore

@@ -0,0 +1,17 @@
+# Byte-compiled / cache
+__pycache__/
+*.py[cod]
+
+# Test / tooling caches
+.pytest_cache/
+.ruff_cache/
+tests/unit/__pycache__
+
+# Virtual environments
+.venv/
+venv/
+
+# Local artifacts
+*.db
+*.sqlite
+*.sqlite3

mayhem_cli-0.5.1/Justfile

@@ -0,0 +1,204 @@
+# ─────────────────────────────────────────────────────────────────────────────
+# Mayhem justfile — test every capability against examples/testCase
+# ─────────────────────────────────────────────────────────────────────────────
+# Usage:  just --list           (show all recipes)
+#         just e2e              (full automated run)
+#         just smoke            (quick sanity check)
+
+set shell := ["bash", "-euo", "pipefail", "-c"]
+
+_testcase  := "examples/testCase"
+_compose   := _testcase / "docker-compose.yml"
+_config    := _testcase / "mayhem.yml"
+_spec      := _testcase / "mayhem.yaml"
+_db        := ".mayhem/e2e.db"
+
+# ── setup ────────────────────────────────────────────────────────────────────
+
+[private]
+setup:
+    rm -f {{ _db }}
+    mkdir -p .mayhem
+    @echo "✓ setup"
+
+# ── topology ─────────────────────────────────────────────────────────────────
+
+# Discover topology from compose + live runtime (containers, processes, services)
+topology:
+    @echo "=== topology discover ==="
+    mayhem topology discover --compose {{ _compose }} | python3 -m json.tool > /dev/null
+    @echo "✓ topology discover"
+
+# Topology with prefix shorthand
+topology-prefix:
+    @echo "=== topology prefix ==="
+    mayhem top d --compose {{ _compose }} | python3 -m json.tool > /dev/null
+    @echo "✓ topology prefix"
+
+# ── toolkit ──────────────────────────────────────────────────────────────────
+
+# List available faults and capabilities
+toolkit:
+    @echo "=== toolkit ==="
+    mayhem toolkit faults
+    mayhem toolkit list --json | python3 -m json.tool > /dev/null
+    @echo "✓ toolkit"
+
+# ── config ───────────────────────────────────────────────────────────────────
+
+# Show and validate effective config (default + testCase)
+config:
+    @echo "=== config ==="
+    mayhem config show --json | python3 -m json.tool > /dev/null
+    mayhem --config {{ _config }} config show --json | python3 -m json.tool > /dev/null
+    mayhem config validate
+    mayhem --config {{ _config }} config validate
+    @echo "✓ config"
+
+# ── experiment ───────────────────────────────────────────────────────────────
+
+# Show and validate experiment spec
+# Validate the drill spec through the experiment group alias
+experiment:
+    @echo "=== experiment ==="
+    mayhem experiment validate {{ _spec }} --compose {{ _compose }}
+    @echo "✓ experiment"
+
+# ── lifecycle: validate → plan → run → status → history → recover ────────────
+
+# Validate spec against live topology
+validate: setup
+    @echo "=== validate ==="
+    mayhem --db {{ _db }} validate {{ _spec }} --compose {{ _compose }}
+    @echo "✓ validate"
+
+# Validate with explicit process topology (no compose auto-detect)
+validate-process:
+    @echo "=== validate --process ==="
+    mayhem validate {{ _spec }} \
+        --process "download-1=10001" --process "download-2=10002"
+    @echo "✓ validate --process"
+
+# Plan the experiment
+plan:
+    @echo "=== plan ==="
+    mayhem plan {{ _spec }} --compose {{ _compose }}
+    @echo "✓ plan"
+
+# Full run: inject faults, record events, compensate
+run: setup
+    @echo "=== run ==="
+    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }}
+    @echo "✓ run"
+
+# Show run status (JSON + text)
+status: setup
+    @echo "=== status ==="
+    mayhem --db {{ _db }} status
+    @echo "✓ status"
+
+# Show detailed run history (JSON + text)
+history:
+    @echo "=== history ==="
+    @run_id=$$(sqlite3 {{ _db }} "SELECT id FROM runs ORDER BY rowid DESC LIMIT 1" 2>/dev/null || echo ""); \
+    if [ -z "$$run_id" ]; then \
+        echo "⚠ no runs in DB — skipping history"; \
+    else \
+        mayhem --db {{ _db }} history "$$run_id"; \
+        echo "✓ history"; \
+    fi
+
+# Recovery sweep (orphaned fault leases)
+recover: setup
+    @echo "=== recover ==="
+    mayhem --db {{ _db }} recover
+    @echo "✓ recover"
+
+# Janitor sweep (stale runs / resources)
+janitor: setup
+    @echo "=== janitor ==="
+    mayhem --db {{ _db }} janitor sweep
+    @echo "✓ janitor"
+
+# ── campaign CRUD ────────────────────────────────────────────────────────────
+
+# Create, list, show, start, abort, delete a campaign
+campaign: setup
+    @echo "=== campaign ==="
+    mayhem --db {{ _db }} campaign create --name "e2e-campaign" --hypothesis "stack survives chaos"
+    mayhem --db {{ _db }} campaign list
+    @cid=$$(sqlite3 {{ _db }} "SELECT id FROM campaigns ORDER BY rowid DESC LIMIT 1"); \
+    mayhem --db {{ _db }} campaign show "$$cid"; \
+    mayhem --db {{ _db }} campaign status "$$cid"; \
+    mayhem --db {{ _db }} campaign start "$$cid" || true; \
+    mayhem --db {{ _db }} campaign abort "$$cid" || true; \
+    mayhem --db {{ _db }} campaign delete "$$cid"
+    @echo "✓ campaign"
+
+# ── full round-trip ─────────────────────────────────────────────────────────
+
+# Full lifecycle: validate → plan → run → status → history → recover
+full: setup
+    @echo "=== full round-trip ==="
+    mayhem --db {{ _db }} validate {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} plan {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} run {{ _spec }} --compose {{ _compose }}
+    mayhem --db {{ _db }} status
+    @run_id=$$(sqlite3 {{ _db }} "SELECT id FROM runs ORDER BY rowid DESC LIMIT 1"); \
+    mayhem --db {{ _db }} history "$$run_id"
+    mayhem --db {{ _db }} recover
+    @echo "✓ full round-trip"
+
+# ── stack management ─────────────────────────────────────────────────────────
+
+# Start the testCase compose stack
+stack-up:
+    @echo "=== stack up ==="
+    cd {{ _testcase }} && podman compose up -d 2>/dev/null || docker compose up -d
+    @sleep 3
+    @echo "✓ stack up"
+
+# Stop the testCase compose stack
+stack-down:
+    @echo "=== stack down ==="
+    cd {{ _testcase }} && podman compose down -v 2>/dev/null || docker compose down -v
+    @echo "✓ stack down"
+
+# ── tests ────────────────────────────────────────────────────────────────────
+
+# Run unit tests
+test-unit:
+    @echo "=== unit tests ==="
+    python3 -m pytest tests/unit/ -v --tb=short
+    @echo "✓ unit tests"
+
+# Run e2e tests (in-process, no containers needed)
+test-e2e:
+    @echo "=== e2e tests ==="
+    python3 -m pytest tests/e2e/ -v --tb=short
+    @echo "✓ e2e tests"
+
+# Run all tests
+test:
+    @echo "=== all tests ==="
+    python3 -m pytest tests/ -v --tb=short
+    @echo "✓ all tests"
+
+# Run linter
+lint:
+    @echo "=== lint ==="
+    ruff check src/ tests/
+    @echo "✓ lint"
+
+# ── aggregate targets ────────────────────────────────────────────────────────
+
+# Quick smoke: topology + toolkit + config + experiment + validate + plan
+smoke: topology toolkit config experiment validate plan
+    @echo "✓ smoke"
+
+# Full automated run: stack → topology → config → experiment → full lifecycle → campaign → tests
+e2e: stack-up topology toolkit config experiment full campaign test
+    @echo ""
+    @echo "╔══════════════════════════════════════════════╗"
+    @echo "║   ALL E2E RECIPES PASSED                     ║"
+    @echo "╚══════════════════════════════════════════════╝"