Testing

Quick Start

uv run pytest provider/tests/ -v

With a coverage report:

uv run pytest provider/tests/ -v --cov=provider/ --cov-report=term-missing

CI Pipeline

Every push and PR triggers two parallel jobs via test.yml:

Job	What it does
test-*	Runs pytest with coverage checks, uploads report to Codecov
lint-*	Runs ruff, mypy, codespell, pre-commit

Tests run against music-assistant/server@dev (no fork — lightweight CI).

Tools

Tool	Purpose
uv	Virtual environment and dependency management
Python 3.12	Target language version
pytest	Test framework
pytest-cov	Coverage data collection
Codecov	Coverage report upload (automatic in CI)
ruff	Python linter and formatter
mypy	Static type analysis
codespell	Spell checking in source code
pre-commit	Pre-commit hooks

Running Linters Locally

Run all pre-commit hooks (recommended before a PR):

uv run pre-commit run --all-files

Type checking only:

uv run mypy provider/

Linting only:

uv run ruff check provider/
uv run ruff format --check provider/

Coverage

Coverage reports are automatically uploaded to Codecov on every push in CI. To view coverage locally:

uv run pytest provider/tests/ --cov=provider/ --cov-report=html
open htmlcov/index.html

If CI Fails

If tests or linters fail in CI, a GitHub issue is automatically created with the incident:ci label. For more on the incident workflow, see Incident Management.