feat(ci): use uv for Python dependency management

Use uv (astral.sh/setup-uv@v2) instead of actions/setup-python for
managing Python build dependencies in CI. This simplifies Python
version management and speeds up CI builds.

Changes:
- Add .python-version (Python 3.12)
- Add pyproject.toml for build dependencies (setuptools, wheel)
- Update release.yml: replace setup-python with setup-uv across all 4 jobs
- Update CONTRIBUTING.md with Python/uv setup instructions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: yuzhichang

.github/workflows/release.yml

@@ -49,15 +49,18 @@ jobs:
           node-version: '22'
           cache: 'pnpm'
 
-      - name: Setup Python 3.11 for node-gyp
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
         with:
-          python-version: '3.11'
+          version: "0.11.3"
 
-      - name: Install Python build deps (setuptools shim for distutils)
+      - name: Set up Python
         run: |
-          python -m pip install --upgrade pip setuptools wheel
-          echo "python=$(which python3)" >> $GITHUB_ENV
+          uv python install
+          echo "python=$(uv python find)" >> $GITHUB_ENV
+
+      - name: Install Python build deps
+        run: uv pip install .
 
       - name: Install dependencies (strict lockfile)
         env:
@@ -192,15 +195,18 @@ jobs:
           node-version: '22'
           cache: 'pnpm'
 
-      - name: Setup Python 3.11 for node-gyp
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
         with:
-          python-version: '3.11'
+          version: "0.11.3"
 
-      - name: Install Python build deps (setuptools)
+      - name: Set up Python
         run: |
-          python -m pip install --upgrade pip setuptools wheel
-          echo "python=$(which python3)" >> $GITHUB_ENV
+          uv python install
+          echo "python=$(uv python find)" >> $GITHUB_ENV
+
+      - name: Install Python build deps
+        run: uv pip install .
 
       - name: Install system build dependencies
         run: |
@@ -305,16 +311,20 @@ jobs:
           node-version: '20'
           cache: 'pnpm'
 
-      - name: Setup Python 3.11 for node-gyp
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
         with:
-          python-version: '3.11'
+          version: "0.11.3"
 
-      - name: Install Python build deps (setuptools shim for distutils)
+      - name: Set up Python
         shell: bash
         run: |
-          python -m pip install --upgrade pip setuptools wheel
-          echo "python=$(which python)" >> "$GITHUB_ENV"
+          uv python install
+          echo "python=$(uv python find)" >> "$GITHUB_ENV"
+
+      - name: Install Python build deps
+        shell: bash
+        run: uv pip install .
 
       - name: Install dependencies (strict lockfile)
         shell: bash
@@ -479,15 +489,18 @@ jobs:
           node-version: '22'
           cache: 'pnpm'
 
-      - name: Setup Python 3.11 for node-gyp
-        uses: actions/setup-python@v5
+      - name: Install uv
+        uses: astral-sh/setup-uv@v2
         with:
-          python-version: '3.11'
+          version: "0.11.3"
 
-      - name: Install Python build deps (setuptools shim for distutils)
+      - name: Set up Python
         run: |
-          python -m pip install --upgrade pip setuptools wheel
-          echo "python=$(which python3)" >> $GITHUB_ENV
+          uv python install
+          echo "python=$(uv python find)" >> $GITHUB_ENV
+
+      - name: Install Python build deps
+        run: uv pip install .
 
       - name: Install dependencies (strict lockfile)
         env:

.python-version

@@ -0,0 +1 @@
+3.12

CONTRIBUTING.md

@@ -7,10 +7,26 @@ Thanks for your interest in contributing! We favor small, focused PRs and clear
 Prerequisites
 
 - **Node.js 20.0.0+ (recommended: 22.20.0)** and Git
+- **Python 3.11+** with [uv](https://docs.astral.sh/uv/) (for native module builds)
 - Optional (recommended for end‑to‑end testing):
   - GitHub CLI (`brew install gh`; then `gh auth login`)
   - At least one supported coding agent CLI (see docs for list)
 
+### Python Setup
+
+This project uses [uv](https://docs.astral.sh/uv/) to manage Python build dependencies. Install uv first, then the project will automatically use the Python version specified in `.python-version`:
+
+```bash
+# Install uv (Linux/macOS)
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Or on Windows (PowerShell)
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+
+# Python dependencies are installed automatically via 'pnpm install'
+# or manually: uv pip install .
+```
+
 Setup
 
 ```bash

pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "emdash-build-deps"
+version = "0.0.0"
+requires-python = ">=3.12"
+dependencies = [
+    "setuptools>=67.0",
+    "wheel",
+]
+
+[build-system]
+requires = ["setuptools>=67.0", "wheel"]
+build-backend = "setuptools.build_meta"