tdd-guard-pytest 0.1.1

Pytest plugin for TDD Guard - enforces Test-Driven Development principles

TDD Guard Pytest Reporter

Pytest plugin that captures test results for TDD Guard validation.

Requirements

• Python 3.8+
• pytest 6.0+
• TDD Guard installed globally

Installation

pip install tdd-guard-pytest

The plugin activates automatically when installed.

Configuration

TDD Guard needs consistent test result locations. Two configurations ensure this:

1. Environment variable - Keeps Claude Code in the project root
2. Pytest setting - Tells the reporter where to save results

Environment Setup

Set Claude Code to maintain the project root:

# In ~/.zshrc or ~/.bashrc
export CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1

This returns Claude Code to the project root after each command. See environment variables documentation for details.

Restart your terminal or run source ~/.zshrc after adding.

Project Root Configuration

Set tdd_guard_project_root to your project root using any ONE of these methods:

Option 1: pyproject.toml

[tool.pytest.ini_options]
tdd_guard_project_root = "/absolute/path/to/project/root"

Option 2: pytest.ini

[pytest]
tdd_guard_project_root = /absolute/path/to/project/root

Option 3: setup.cfg

[tool:pytest]
tdd_guard_project_root = /absolute/path/to/project/root

Configuration Rules

• Path must be absolute
• Current directory must be within the configured project root
• Falls back to current directory if configuration is invalid

More Information

• Test results are saved to .claude/tdd-guard/data/test.json
• See TDD Guard documentation for complete setup

License

MIT