Skip to content

Local Development

Run the CLI from the checkout:

uv run module-manager --help

Run checks:

uv run ruff check .
uv run ruff format --check .
uv run pytest

Run the real uv tool install integration test with:

uv run pytest tests/test_integration.py -m integration --no-cov

CI runs this integration test on Linux and macOS.

Build distributions:

uv build

macOS .venv Notes

On some macOS systems, a .venv tree can acquire the filesystem hidden flag. Python 3.14 skips hidden .pth files, which can break editable installs.

One robust local workaround is to keep the real environment in venv/ and point .venv at it:

UV_PROJECT_ENVIRONMENT=venv uv sync
ln -s venv .venv

The project ignores both .venv and venv/.