Skip to content

gz arb coverage

Run coverage via ARB and emit a step receipt.


Usage

Bash
gz arb coverage [ARGS...]

Runs coverage.py under the ARB step wrapper. Forwards every argument directly to coverage.


Options

Option Description
argv Arguments to forward to coverage

Examples

Bash
gz arb coverage run -m unittest discover -s tests -t .
gz arb coverage report --fail-under=40

Exit Codes

Code Meaning
0 coverage run succeeded; receipt created
1 coverage reported a failure (e.g. fail-under breached); receipt created
2 ARB internal error

Receipt

  • Schema: gzkit.arb.step_receipt.v1
  • Prefix: arb-step-coverage-<timestamp>
  • Canonical for attestation claim "Coverage floor" per AGENTS.md § Attestation.

See Also

  • gz arb — ARB parent reference
  • gz test — unwrapped test runner
  • Rule: AGENTS.md § Attestation (binding) / docs/governance/arb-middleware.md (deep-dive)