tdd-ratchet 0.1.0

Enforce strict TDD in Rust projects — new tests must fail before they can pass, verified by git history
Documentation

tdd-ratchet

TDD ratchet for pure Rust projects — enforces failing-first test workflow via git history.

What it does

A dev dependency binary that wraps cargo test / cargo nextest. It tracks per-test states in a committed .test-status.json and enforces that new tests must fail before they can pass, verified by git history introspection.

See VISION.md for full requirements and PLAN.md for stories and design decisions.

Install

cargo install tdd-ratchet

This installs the cargo-ratchet binary, enabling cargo ratchet as a subcommand.

Usage

cargo ratchet

Do not run cargo test directly — the ratchet enforces this.

Developing

cargo test

Prerequisites: Rust toolchain.