writing-ratchet-tests

What problem does it solve?

Ratchet tests prevent the accumulation of common code anti-patterns by tracking their presence in the codebase and enforcing improvements via snapshots.

Core Features & Use Cases

• Define measurable ratchets for patterns like TODO comments, inline imports, use of eval or exec, and broad exception handling.
• Generate and compare inline snapshot data to detect increases and allow decreases as improvements.
• Provide scaffolding and guidance to integrate tests into CI and development workflows.

Quick Start

Create a test_ratchets.py in your project and follow this guide to start tracking a chosen anti-pattern.