Pymetrica

Pymetrica is a static analysis tool for Python codebases that combines classical software metrics with architecture-aware reporting.

It parses source files with the Python AST, groups code by top-level layers, and produces reports that help you reason about complexity, maintainability, and coupling.

What You Can Do

• Run a full metrics sweep with pymetrica run-all.
• Inspect parser and codebase statistics with pymetrica base-stats.
• Generate Mermaid .mmd dependency diagrams for a codebase.
• Fail CI with the BASIC_HOOK report backend and configurable thresholds from pyproject.toml.
• Reuse the parser and metric calculators directly from Python.
• Install bundled pre-commit hooks for automated metric checks.
• Drill into individual metrics such as ALOC, CC, HV, PO, MC, and instability.

Quick Start

bash pip install pymetrica pymetrica run-all path/to/project

Pymetrica requires Python 3.10 or newer.

Read Next

• Getting Started for installation, first commands, and example output.
• CLI Reference for every public command and supported option.
• Configuration for thresholds, exclusions, hooks, exit codes, and CI usage.
• Metrics for metric definitions, output formats, and interpretation guidance.
• Architecture for parsing, layering, and diagram behavior.
• API Reference for the package's public Python surface and extension points.

Source

The project source, issue tracker, and release history live in the GitHub repository.