TDD Guard Pytest Reporter

July 28, 2025 ยท View on GitHub

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

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

Development

When developing the pytest reporter, you need to configure the project root to ensure test results are saved to the correct location:

  1. Copy the example configuration:

    cp pytest.ini.example pytest.ini

  2. Edit pytest.ini and set the absolute path to your TDD Guard project root:

    [pytest]
tdd_guard_project_root = /absolute/path/to/tdd-guard

Note: pytest.ini is gitignored to avoid committing machine-specific paths.

More Information

License

MIT