pytest-intent

The @intent decorator for pytest - links a test function to one or more CSD intent claims.

Published on PyPI as csd-pytest-intent - the bare name pytest-intent belongs to an unrelated plugin there. The import name is pytest_intent either way.

CSD (Cognitive Software Delivery) is a language-agnostic methodology. This package is one specific implementation, scoped to Python projects using pytest.

What this package is

A tiny library (~40 LOC) that exposes a single decorator:

from pytest_intent import intent

@intent("INT-001")
def test_resource_ids_unique(data_dir):
    ...

@intent("INT-021", "INT-022")  # one test serves two claims
def test_referential_integrity(data_dir):
    ...

That's the entire public surface.

What it is NOT

• Not a validator. Schema checks (CSD-INTENT-01), orphan detection (test references unknown claim), and cross-runtime coverage all live in the standalone csd-intent CLI - point it at any project to audit.
• Not a pytest plugin. Just a decorator. No fixtures, no entry points, no autoloading. Drop the import in your tests and you're done.
• Not a generator. You write your tests; this annotates them.

Why split the decorator from the auditor?

• One concern per package. The decorator runs inside pytest; the auditor is cross-language and runs standalone (CI step, pre-commit, ad-hoc).
• No coupling. Other test runners (vitest-intent, playwright-intent) expose the same intent() marker shape. The auditor reads all of them, regardless of which decorator package put the marker there.
• Tiny install. pytest-intent has no dependency on PyYAML or anything beyond pytest. The auditor pulls those in only when you actually need to audit.

Install

# From PyPI (the distribution is csd-pytest-intent; the import stays pytest_intent):
pip install csd-pytest-intent

# Local dev against a csd-library checkout:
pip install -e path/to/csd-library/pytest-intent

Companion: csd-intent

To validate your intent.yaml against CSD-INTENT-01 and check that every claim has a test:

pip install csd-intent
csd-intent /path/to/your/project

See csd-intent README for full options.

License

MIT.