Py Cq

CQ - Python Code Quality Analysis Tool

[](https://github.com/rhiza-fr/py-cq/actions/workflows/ci.yml) [](https://codecov.io/gh/rhiza-fr/py-cq) [](https://pypi.org/project/python-code-quality/) [](https://pypi.org/project/python-code-quality/) [](LICENSE)

Run 11+ code quality tools, aggregate results into one score, and surface the single most critical defect as a focused markdown prompt — ready to pipe to any LLM.

This can dramatically reduce the amount of noise for LLMs (and humans) and remove the need for them to know about these tools.

Note: It never edits your files. This is a job for you or an LLM. You may wish to run `ruff check --fix` and `ruff format` first.

cq check . -o llm     # top defect as markdown, pipe to an LLM
cq check .            # table overview of all scores
cq check . -o score   # numeric score only, exits 1 on errors (CI gate)


Install

# install the `cq` command line tool from PyPi
uv tool install python-code-quality

# or, clone it then install 
git clone https://github.com/rhiza-fr/py-cq.git
cd py-cq
uv tool install .

Tools

These tools are run in **parallel** except: When running '-o llm', we run sequentially and exit early at the first error. `coverage` is a special case: it starts alongside `pytest` and is cancelled if `pytest` fails, scoring `0%` without a second test run.

Order	Tool	Measures
1	compileall	Syntax errors
2	ruff	Lint / style
3	ty	Type errors
4	bandit	Security vulnerabilities
5	pytest	Test pass rate
6	coverage