Run Tests¶

This guide shows you how to run the Sunflare test suite and generate coverage reports.

Prerequisites¶

Make sure you have installed Sunflare with development dependencies.

Run All Tests¶

You can run the tests by running the following command from the project root:

pytest

Generate Coverage Report¶

You can obtain a test coverage report by running:

pytest --cov=sunflare --cov-report=html

This will generate an htmlcov/ directory with the test coverage report. Open htmlcov/index.html in your browser to view it.

Run Tests on Multiple Python Versions¶

Sunflare provides a noxfile.py to run tests with nox on all supported Python versions.

If you use uv, you can run tests as follows:

# Install nox globally
uv tool install nox

# Run tests on all Python versions
nox -s tests

This will test against all supported Python versions (3.10, 3.11, 3.12, 3.13).

Run Specific Tests¶

To run specific test files or test functions:

# Run a specific test file
pytest tests/test_config.py

# Run a specific test function
pytest tests/test_config.py::test_function_name

# Run tests matching a pattern
pytest -k "test_model"

Verbose Output¶

For more detailed output, use the -v flag:

pytest -v

Stop on First Failure¶

To stop at the first failing test:

pytest -x