build: add uv.lock for reproducible Python builds

Add uv.lock file and update workflow to use uv's dependency groups
for reproducible, locked dependency installation in CI and local dev.

Changes:
- Add dependency-groups.dev in pyproject.toml (maturin, pytest)
- Generate uv.lock with locked dependency versions
- Update CI to use 'uv sync --group dev' instead of 'uv pip install'
- Update all documentation to use 'uv sync --group dev'

Benefits:
- Reproducible builds across environments
- Faster CI runs with locked dependencies
- Automatic venv creation with 'uv sync'
- No manual pip install or venv creation needed

The lock file ensures all developers and CI use identical dependency
versions, preventing "works on my machine" issues.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: aepfli

.github/workflows/ci.yml

@@ -131,8 +131,7 @@ jobs:
       - name: Install dependencies and build package
         run: |
           cd python
-          uv venv
-          uv pip install maturin pytest
+          uv sync --group dev
           source .venv/bin/activate
           maturin develop
 

CLAUDE.md

@@ -328,11 +328,10 @@ python/
 # Install uv
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# Set up development environment
+# Set up development environment (installs deps and creates venv)
 cd python
-uv venv
+uv sync --group dev
 source .venv/bin/activate
-uv pip install maturin pytest
 
 # Build and install locally
 maturin develop

README.md

@@ -194,9 +194,8 @@ curl -LsSf https://astral.sh/uv/install.sh | sh
 
 # Set up development environment
 cd python
-uv venv
+uv sync --group dev
 source .venv/bin/activate
-uv pip install maturin pytest
 maturin develop
 pytest tests/ -v
 ```

python/README.md

@@ -166,17 +166,14 @@ See [benchmarks/bench_vs_wasm.py](benchmarks/bench_vs_wasm.py) for detailed comp
 # Install uv (if not already installed)
 curl -LsSf https://astral.sh/uv/install.sh | sh
 
-# Create virtual environment
+# Install dependencies (creates venv automatically)
 cd python
-uv venv
+uv sync --group dev
 
 # Activate virtual environment
 source .venv/bin/activate  # On Unix/macOS
 # .venv\Scripts\activate   # On Windows
 
-# Install dependencies and build package
-uv pip install maturin pytest
-
 # Build and install the package in development mode
 maturin develop
 

python/pyproject.toml

@@ -22,3 +22,9 @@ classifiers = [
 
 [tool.maturin]
 features = ["pyo3/extension-module"]
+
+[dependency-groups]
+dev = [
+    "maturin>=1.0,<2.0",
+    "pytest>=7.0",
+]