---
id: tdd-guard-pytest
version: "0.1.2"
license: MIT
license_treatment: permissive
maintenance: active
---

# tdd-guard-pytest — Pytest plugin for TDD Guard - enforces Test-Driven Development principles

License: permissive · Maintenance: active · Downloads: 168.9K/mo

## What it is and what it does

This is a pytest plugin that automatically captures test results during test runs and exports them in a format TDD Guard can consume for validation. It integrates seamlessly into pytest's test execution pipeline and requires minimal setup—mainly configuring an absolute path to your project root in a standard pytest configuration file.

The plugin is designed to work with TDD Guard, a separate tool that enforces Test-Driven Development practices. After you install the plugin, it activates automatically and writes test results to a specific location (.claude/tdd-guard/data/test.json) where TDD Guard can access them. It supports Python 3.8 through 3.13 and depends only on pytest itself, keeping the dependency footprint small.

Use it for:

- Integrate pytest test results with TDD Guard for automated TDD principle enforcement in CI/CD pipelines
- Capture test execution data to validate that tests are written before implementation code
- Monitor test-driven development compliance across a project using pytest as the test runner
- Export test metadata for TDD Guard analysis without modifying existing test code
- Enforce development workflow rules by feeding pytest results into TDD Guard validation

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A pytest plugin that captures test results and integrates them with TDD Guard for enforcing Test-Driven Development principles during test execution.

Yes, if you are already using TDD Guard and pytest together. The plugin is actively maintained, has no known vulnerabilities, and adds minimal friction—it requires only pytest and a one-time configuration of your project root. Install it to automate test result capture for TDD Guard validation. If you are not using TDD Guard, this plugin has no standalone value.

## Install

pip install tdd-guard-pytest
uv add tdd-guard-pytest
poetry add tdd-guard-pytest

## Installing tdd-guard-pytest

Before you install: Low install friction with a single runtime dependency on pytest. The package is actively maintained with recent releases and no known vulnerabilities. Requires Python 3.8+ and pytest 6.0+, both widely available.

License in practice: MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for both open-source and commercial projects.

Quickstart:

pip install tdd-guard-pytest

# Configure in pyproject.toml, pytest.ini, or setup.cfg:
# [tool.pytest.ini_options]
# tdd_guard_project_root = "/absolute/path/to/project/root"

# Plugin activates automatically; test results saved to .claude/tdd-guard/data/test.json

Requires TDD Guard installed globally and an absolute path to project root configured in pytest configuration file; current directory must be within the configured project root.

Verify before relying:

- Exact behavior and constraints when TDD Guard is not installed globally
- How test results are used by TDD Guard after capture
- Whether the plugin works with pytest plugins that also modify test result handling

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 168.9K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

pytest plugin tdd guard, test-driven development enforcement, pytest test result capture, tdd validation pytest, test result reporting pytest, tdd guard integration, pytest quality assurance, tdd-enforcement, pytest-plugin, test-automation

[View on SkillFed](https://skillfed.io/packages/tdd-guard-pytest) · [View on PyPI](https://pypi.org/project/tdd-guard-pytest/)