Quickstart

Find your first untested edge case in under 5 minutes.

1. Install

pip install quelltest

Requires Python 3.11+. Rule engine, no API key needed (~75% of cases).

2. Run on your code

quell find src/payments.py

Quell scans your docstrings, type annotations, and Pydantic models and shows you every testable requirement it found — and which ones have no test.

3. Write tests for verified cases

quell find src/payments.py --fix

Quell generates tests, runs each through the 5-gate pipeline, and writes only the verified ones to your test file. Unverifiable cases become stubs or flagged items.

4. Check your score

quell score src/

Your Production Readiness Score (PRS) measures how well your tests actually catch edge-case bugs — not just which lines ran.

Example output

✓  WRITTEN   test_payment_rejects_zero_amount        gates: 5/5
✓  WRITTEN   test_payment_rejects_negative_amount    gates: 5/5
~  SCAFFOLDED test_refund_idempotency                gates: 1-3 (external state)
✗  FLAGGED   test_stripe_gateway_timeout             reason: calls stripe.Charge.create()

PRS: 84 / 100 — Production Ready
2 WRITTEN · 1 SCAFFOLDED · 1 FLAGGED

Next steps

• CLI Reference — full command documentation
• How It Works — the 5-gate pipeline explained
• Configuration — pyproject.toml options