use uv to manage development environments

.gitignore

@@ -6,3 +6,4 @@ __pycache__/
 /loam/_version.py
 /loam.egg-info/
 /docs/_build/
+/uv.lock

justfile

@@ -0,0 +1,24 @@
+# check style, typing, and run tests
+check-all: lint typecheck test
+
+# check style and format
+lint:
+    uv run -- ruff check --extend-select I .
+    uv run -- ruff format --check .
+
+# format code and sort imports
+format:
+    uv run -- ruff check --select I --fix .
+    uv run -- ruff format .
+
+# check static typing annotations
+typecheck:
+    uv run -- mypy loam/ tests/
+
+# run test suite
+test:
+    uv run -- pytest --cov=./loam --cov-report term-missing
+
+# invoke mkdocs with appropriate dependencies
+mkdocs *FLAGS:
+    uv run --with-requirements=docs/requirements.txt -- mkdocs {{FLAGS}}

pyproject.toml

@@ -53,3 +53,13 @@ module = [
     "pytest.*",
 ]
 ignore_missing_imports = true
+
+[tool.uv]
+dev-dependencies = [
+    "pytest>=8.3.2",
+    "pytest-cov>=5.0.0",
+    "ruff>=0.6.2",
+    "mypy>=1.11.1",
+    # type stubs for mypy
+    "types-toml>=0.10.8.20240310",
+]