running-tests

name	running-tests
description	How to run unit tests for workstream. Use when writing, modifying, or verifying tests before submitting a PR.

Running Tests

Quick Start

make test
# or directly:
python -m pytest tests/ -v

Python Testing

Run a specific test file:

pytest tests/test_config.py

Run a specific test function:

pytest tests/test_config.py::test_config_defaults

Run with verbose output and coverage:

pytest tests/ -v --cov=. --cov-report=term

Test Locations

• tests/ -- all test files

Linting (run before committing)

make lint
# or: ruff check . && black --check .

Tips

• Always run the full test suite before submitting a PR
• If adding new functionality, write tests alongside the code
• Check CI workflow definitions in .github/workflows/ for the exact test matrix