code-ratchets

You can prevent deprecated Python patterns from increasing by applying configurable ratchets that count occurrences and block pre-commit checks when counts exceed expected thresholds, stopping uncontrolled proliferation while tracking code health.

A ratchet in static analysis is a guardrail that snapshots the current count of deprecated patterns and enforces that the number never increases, allowing gradual refactoring without requiring an immediate full cleanup of the codebase.

Set up pre-commit hooks to fail when TODO comments or type ignore annotations increase by defining ratchets with pattern, expected count, and glob, then running the init workflow to snapshot current counts and enforce limits in Python projects.

Yes, code ratchets integrate with existing Python pre-commit hooks and static analysis tools by applying a Python-based counting engine with configurable pattern matching and optional verbose output to enforce code quality limits.

Initialize counts for deprecated patterns to match your current codebase state by running the init workflow, which snapshots existing pattern occurrences to establish a baseline for pre-commit checks and creates a historical audit of code health.