tdd-guide

TDD Guide

Test-driven development across Jest, Pytest, JUnit, and Vitest: generate tests, analyze coverage gaps, and drive the red-green-refactor cycle with a single CLI.

---

Input Checklist

Input	Required	Description
Source code / requirement	Yes	A source file, req.json, or a feature-requirement description.
Target framework	No	jest | pytest | junit | vitest | mocha (auto-detected).
Coverage report	No	LCOV / JSON / XML path, for gap analysis.
Coverage threshold	No	Percentage (default 80).
Phase (workflow)	No	red | green | refactor.

When a required input is missing, ask only once:

Please provide: (1) the source code or requirement description to test; (2) the target test framework (Jest/Pytest/JUnit/Vitest/Mocha). I'll use the rest as defaults: coverage-threshold=80%, phase advanced automatically by the workflow.

Pre-flight Checks

# 1. Does the entry script exist?
test -f scripts/tdd_cli.py || { echo "ERROR: scripts/tdd_cli.py missing"; exit 1; }
# 2. Is Python available?
command -v python3 >/dev/null 2>&1 || { echo "ERROR: python3 not found"; exit 1; }
# 3. If a coverage report is supplied, confirm the file exists:
test -z "$REPORT" || test -f "$REPORT" || { echo "ERROR: report $REPORT not found"; exit 1; }

Unified CLI (scripts/tdd_cli.py)

All library modules are invoked through a single entry point (exit codes: 0 = ok, 2 = input error, 1 = internal error):

python scripts/tdd_cli.py workflow --requirement "implement user login"            # red-green-refactor cycle + phase guidance
python scripts/tdd_cli.py detect --file examples/src/service.py                  # language/framework/test-pattern detection (bundled sample)
python scripts/tdd_cli.py gen-tests --requirements examples/req.json --framework pytest   # requirement → test cases (bundled sample)
python scripts/tdd_cli.py fixtures --mode boundary --type int           # boundary-value / edge-case / mock data
python scripts/tdd_cli.py coverage --report examples/coverage.xml --threshold 80 # coverage summary/gaps/suggestions (bundled sample cobertura)
python scripts/tdd_cli.py metrics --source examples/src/service.py --test examples/tests/test_service.py      # quality metrics (bundled sample)
python scripts/tdd_cli.py stub --framework pytest --name test_login     # render a test skeleton