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
| Option | Meaning |
|---|---|
TARGET | File or directory to check (default .). |
--threshold FLOAT | Minimum score as a fraction between 0.0 and 1.0 (default 0.0, which always passes). 0.75 means 75%. |
--root PATH | Project 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?
| Code | Meaning |
|---|---|
| 0 | Score at or above the threshold. |
| 1 | Score 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.