Skip to main content

Troubleshooting FAQ

How do I validate that examples still work?​

Use the smallest matching test suite from the testing guide:

uv run pytest tests/e2e/test_quickstart_examples.py -q
uv run pytest tests/e2e/test_recovery_examples.py -q

See Testing Guide.

Why do local scripts sometimes need PYTHONPATH=src?​

When running directly against the repository source tree without installing the package, PYTHONPATH=src makes local imports resolve to the working tree. Installed environments do not need it.

How do I check the installed version?​

python -c "import contexta; print(contexta.__version__)"

Where should I look next?​