automaze-proof

Python SDK for proof -- capture visual evidence of test execution.

Thin wrapper around the proof CLI. Requires the binary on PATH.

Install

pip install automaze-proof

The proof binary must be installed separately:

curl -fsSL https://automaze.io/install/proof | sh

Usage

from proof import Proof

p = Proof(app_name="my-app", proof_dir="./evidence")

recording = p.capture(
    command="pytest tests/ -v",
    mode="terminal",
    label="unit-tests",
)

print(recording.path)       # /abs/path/unit-tests-143012.html
print(recording.duration)   # 4300
print(recording.exit_code)  # 0 (exit code of the wrapped command)

p.report()

# capture() records the run even when the command fails — gate on the code:
if recording.exit_code != 0:
    raise SystemExit(recording.exit_code)

pytest fixture

# conftest.py
import pytest
from proof import Proof

@pytest.fixture(scope="session", autouse=True)
def proof_session():
    p = Proof(app_name="my-app", proof_dir="./evidence")
    yield p
    p.report()

API

Proof(app_name, proof_dir=None, run=None, description=None)

proof.capture(command, mode="terminal", label=None, description=None) -> Recording

proof.report(format=None) -> str | list[str]

Recording (dataclass)

• path: str
• mode: str
• duration: int
• label: str | None
• exit_code: int | None — wrapped command's exit code (0 = success; None only from a proof CLI predating this field)