agentic-crap-py

Analyze function-level CRAP scores for Python using LCOV line coverage.

Quick start

python -m pip install agentic-crap-py
agentic-crap-py --source src --lcov coverage/lcov.info --threshold 10

For a local checkout, run python -m pip install . and then agentic-crap-py --source src --lcov coverage/lcov.info.

Coverage generation

Pass coverage generation as a JSON argv array. It is executed directly without a shell, so shell syntax, pipelines, and interpolation are intentionally not supported.

agentic-crap-py --source src --coverage-command '["python","-m","coverage","lcov","-o","coverage/lcov.info"]' --lcov coverage/lcov.info --json

An existing LCOV file is removed before this command runs. The command must create the requested LCOV file or analysis fails, preventing stale coverage from being accepted.

Output and exit codes

Use --json for deterministic compact JSON, sorted by file, line, and function.

Score

For cyclomatic complexity CC and line coverage ratio C, the score is:

CRAP = CC^2 * (1 - C)^3 + CC

Nested function bodies are excluded from an enclosing function's coverage and complexity calculation. A function with no mapped LCOV lines is reported as N/A and fails rather than passing.

Development

python -m unittest discover -s tests -v

Python 3.10 or newer is required. The runtime uses only the Python standard library; generate LCOV using the coverage tooling already used by your project.