codemri 0.1.0

Instant code quality reports for your Python projects — style, complexity, and an overall health score in one command

CodeMRI

Instant code quality reports for your Python projects.

CodeMRI scans your codebase and gives you a single, easy-to-read health score — combining style violations and code complexity into one number, so you know exactly how healthy your code is and where to focus first.

Why CodeMRI?

Most linters dump a wall of warnings and leave you to figure out what matters. CodeMRI instead gives you:

• One overall health score (0–100) with a letter grade — like an MRI scan for your code
• A "Worst Offenders" leaderboard — the exact functions and files causing the most pain, ranked by severity
• A clean, shareable HTML report — perfect for pasting into a PR or sharing with your team
• Score history tracking — see whether your codebase is improving or rotting over time, right from the CLI

Installation

pip install codemri

Usage

Scan the current directory:

codemri scan .

Scan a specific file or folder:

codemri scan path/to/project

Generate a shareable HTML report:

codemri scan . --html

View your score history over time:

codemri history .

Check the installed version:

codemri --version

Example output

────────────────── Overall Code Health ──────────────────╮ │ 69/100 Grade: C │ ╰────────────────────────────────────────────────────────╯ Style score: 39/100 (9 issues across 59 lines) Complexity score: 98/100 (1 files analyzed)

How scoring works

• Style score — based on the density of style/lint issues (via ruff) relative to lines of code
• Complexity score — based on cyclomatic complexity rankings (via radon) across all functions
• Overall score — a 50/50 weighted average of the two, mapped to a letter grade (A–F)

License

MIT