Codebase Stats#

Project metrics, complexity analysis, and health indicators. Pure Python, zero deps, 40+ languages.

Quick Start#

bash

# Analyze current directory
python3 scripts/codebase_stats.py

# Analyze specific project
python3 scripts/codebase_stats.py /path/to/project

# Markdown report
python3 scripts/codebase_stats.py /path/to/project --format markdown

# JSON (for CI/CD dashboards)
python3 scripts/codebase_stats.py /path/to/project --format json

# Filter by language
python3 scripts/codebase_stats.py --language Python

# Save report
python3 scripts/codebase_stats.py --format markdown --output stats.md

What It Measures#

CategoryMetricsSizeTotal files, code/comment/blank lines, lines per fileLanguagesDistribution by code lines and file count (40+ languages)ComplexityPer-function cyclomatic complexity estimate, top complex functionsQualityCode-to-comment ratio, test file coverage indicatorDependenciesnpm, pip, Go modules, Cargo crate countsTech DebtTODO/FIXME/HACK/XXX counts across codebaseFilesTop 10 largest files by line count

Supported Languages#

Python, JavaScript, TypeScript, Java, Go, Rust, Ruby, PHP, C, C++, C#, Swift, Kotlin, Scala, R, Lua, Perl, Shell, SQL, HTML, CSS, SCSS, Vue, Svelte, Dart, Elixir, Erlang, Zig, Nim, V, Solidity, Terraform, Protobuf, and more.

Exit Codes#

• 0 — Success
• 1 — Error (directory not found, language not found)