Development set-up

Having cloned the repository, build with make install (at the root; there’s a completely unrelated Makefile for the docs directory).

make setup-tests is a lighter-weight alternative if you want to run tests but need less of the tooling.

There’s some complexity in this; it will opt for homebrew or apt to install components.

Testing

make test runs uv run pytest. There’s a slow test that can be skipped: make test-fast.

Use make test to run rests, and make test-coverage for a coverage report.

Running the documentation

In docs: make run to launch the documentation site on port 8000.

Changes to the extension code will be picked up live.