tdd-guard-pytest

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 on this page — 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

tdd-guard-pytest on PyPI

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

Evidence: tdd_guard_pytest-0.1.2-py3-none-any.whl

Keywords: tdd, test-driven-development, testing, pytest, claude

Tags

More Testing packages