Code Metrics#

Analyze code quality and complexity metrics across your project. Supports 17+ languages.

Quick Start#

bash

# Analyze current project
python3 scripts/code_metrics.py

# Analyze specific directory
python3 scripts/code_metrics.py /path/to/project

# JSON output
python3 scripts/code_metrics.py --json

# Skip complexity analysis (faster)
python3 scripts/code_metrics.py --no-complexity

# Exclude additional directories
python3 scripts/code_metrics.py --exclude migrations fixtures

Metrics Provided#

• Lines of Code — total, code, comments, blank lines per language
• Comment-to-code ratio — overall documentation density
• Function & class counts — per language
• Cyclomatic complexity — per-function for Python files (AST-based)
• Largest files — top N files ranked by code lines
• High complexity warnings — flags functions with complexity ≥5

Complexity Scale (Python)#

RangeRiskMeaning1-4🟢 LowSimple, well-structured5-9🟢 ModerateAcceptable10-14🟡 HighConsider refactoring15+🔴 Very HighRefactor strongly recommended

Dependencies#

• Python 3.8+ (stdlib only, no pip packages needed)