Skip to content

quell ci

quell ci computes the share of requirements in a path that have a covering test and exits with code 1 when that share is below --threshold. Use it as the pass or fail step in a Python CI pipeline. It does not write tests.

What is the syntax?

quell ci [TARGET]
quell ci [TARGET] --threshold 0.75
OptionMeaning
TARGETFile or directory to check (default .).
--threshold FLOATMinimum score as a fraction between 0.0 and 1.0 (default 0.0, which always passes). 0.75 means 75%.
--root PATHProject root (default .).

The command has no --format or --no-write option, and it does not read a threshold from pyproject.toml: always pass --threshold.

What does it print?

Quell Score: 0% | Threshold: 50%
FAIL: 0% < 50% threshold
Quell Score: 100% | Threshold: 50%
PASS

What is the score?

The fraction of requirements that have a covering test, read from docstrings (Raises, parameter constraints, Returns) and type annotations (Pydantic Field constraints, Literal, Annotated). The coverage checker is conservative and counts a requirement as uncovered when unsure. This is the same SDK check used by the Python API and the MCP tool find_edge_cases; it is a different measure from the Production Readiness Score printed by quell find and quell score.

What are the exit codes?

CodeMeaning
0Score at or above the threshold.
1Score below the threshold.

How do I use it in GitHub Actions?

- uses: actions/setup-python@v5
  with:
    python-version: "3.11"
- run: pip install quelltest
- run: quell ci src/ --threshold 0.75

See the GitHub Actions guide and CI/CD integration. For JavaScript or TypeScript, use quell score --threshold and quell gate from the npm CI guide.