Developer Guide

Environment setup

uv venv
uv sync --dev
source .venv/bin/activate

Formatting and tests

uv run black .
uv run pytest

Run a single test by name:

uv run pytest -k test_package_manager_init_package_a_only

Package builds

The root workspace (spm-workspace) is a development umbrella that pulls in library and test fixtures. It is not intended for release builds.

Build the spm-slang library package from the repo root with:

uv build libs/spm_slang

Build artifacts land under libs/spm_slang/dist/.

Documentation

Sphinx uses Markdown via MyST. Build docs locally with:

uv run sphinx-build -b html docs docs/_build