Testing Overview

The pytest framework makes it easy to write small tests yet scales to support complex functional testing. A couple of add-ons are installed (pytest-cov, pytest-django, pytest-mock, pytest-xdist) to improve the experience.

The project includes a comprehensive test suite organized by test type:

tests/
├── e2e/               # End-to-end tests using Playwright
├── integration/       # Integration tests for component interactions
├── security/          # Security vulnerability tests
└── unit/              # Unit tests for individual components

This project uses pytest-xdist, a pytest plugin for distributed testing and loop-on-failures modes. pytest-xdist shards your test suite across all available CPU cores for faster performance. Sometimes it can generate flaky tests, but it’s rare. Just re-run the tests and you should be fine.

There is a minimal set of e2e tests using Playwright.

Running Tests

Execute the complete test suite:

uv run playwright install --with-deps       # Install additional playwright dependencies
uv run pytest                               # Run the whole test suite
uv run pytest tests/unit/test_models.py     # Run a single test file
uv run pytest --cov=src                     # Generate code coverage reports
uv run pytest -m unit                       # Specific marker