ojhunt-testing - SKILL.md Agent Skill

name: ojhunt-testing description: General pytest conventions for non-crawler tests — CI scope, web route tests, markdown doc tests. For crawler test conventions see ojhunt-crawlers; for Playwright see ojhunt-e2e.

Pytest conventions

Crawler-specific test conventions live in the ojhunt-crawlers skill. Playwright e2e tests live in the ojhunt-e2e skill.

Running tests

# Single file
uv run pytest tests/<path>/<name>_test.py

# CI scope (excludes network + Playwright tests)
uv run pytest -m "not network and not playwright"

# Full suite
uv run pytest

CI runs pytest -m "not network and not playwright" — never run crawler (network) tests when debugging CI failures.

Test structure

Type	Location	Convention	Requires server
Crawler unit tests	`tests/crawlers/<name>_test.py`	`*_test.py`	No
Web unit tests	`tests/web/<module>_test.py`	`*_test.py`	No
Web e2e tests	`tests/e2e/test_*.py`	`test_*.py`	Yes (`localhost:8080`)

Do not put unit tests in tests/e2e/ — that folder is exclusively for Playwright tests.

Page route unit tests

New page routes must have a corresponding unit test. Use TestClient with monkeypatching:

from starlette.testclient import TestClient
client = TestClient(app, follow_redirects=False)

# File upload syntax:
files={"field": ("name.pdf", bytes_content, "application/pdf")}

Markdown doc tests

Python fenced blocks in README.md and docs/ are collected by pytest-markdown-docs and run as part of the standard CI suite (not network and not playwright).

Use python notest in the fence header to exclude a block (network calls, incomplete templates)
notest is the correct keyword — NOT skip (which is silently ignored)