feat: add .gitignore and update conf.py for wheel build optimization

Author: CSSFrancis

.github/workflows/docs.yml

@@ -53,6 +53,20 @@ jobs:
       - name: Install Playwright browser
         run: uv run playwright install chromium --with-deps
 
+      # ── Build Pyodide wheel ───────────────────────────────────────────────
+      # Produces docs/_static/wheels/anyplotlib-0.0.0-py3-none-any.whl so the
+      # in-browser Pyodide bridge can install the exact source tree that built
+      # these docs — no PyPI release required.
+      - name: Build Pyodide wheel
+        run: |
+          mkdir -p docs/_static/wheels
+          uv build --wheel --out-dir docs/_static/wheels/
+          # Rename to the stable sentinel name micropip expects for URL installs.
+          cd docs/_static/wheels
+          for f in anyplotlib-*.whl; do
+            [ "$f" != "anyplotlib-0.0.0-py3-none-any.whl" ] && mv "$f" anyplotlib-0.0.0-py3-none-any.whl
+          done
+
       # ── Sphinx build ─────────────────────────────────────────────────────
       # -W turns warnings into errors; --keep-going collects all of them.
       - name: Build HTML documentation
@@ -110,6 +124,16 @@ jobs:
             echo "dest_dir=dev" >> "$GITHUB_OUTPUT"
           fi
 
+      # ── Build Pyodide wheel ───────────────────────────────────────────────
+      - name: Build Pyodide wheel
+        run: |
+          mkdir -p docs/_static/wheels
+          uv build --wheel --out-dir docs/_static/wheels/
+          cd docs/_static/wheels
+          for f in anyplotlib-*.whl; do
+            [ "$f" != "anyplotlib-0.0.0-py3-none-any.whl" ] && mv "$f" anyplotlib-0.0.0-py3-none-any.whl
+          done
+
       # ── Sphinx build ─────────────────────────────────────────────────────
       - name: Build HTML documentation
         env:

.gitignore

@@ -0,0 +1,45 @@
+# Python bytecode / caches
+__pycache__/
+*.py[cod]
+*$py.class
+*.pyo
+
+# Distribution / packaging
+dist/
+build/
+*.egg-info/
+*.egg
+.eggs/
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# Test / coverage artefacts
+.pytest_cache/
+.coverage
+coverage.xml
+htmlcov/
+
+# Jupyter notebooks checkpoints
+.ipynb_checkpoints/
+
+# Sphinx build output
+docs/_build/
+build/html/
+build/doctrees/
+
+# Generated Pyodide wheel (built by workflow / make html — never commit)
+docs/_static/wheels/
+
+# Editor / IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# macOS
+.DS_Store
+
+

docs/conf.py

@@ -123,14 +123,28 @@
 # pyodide_bridge.js derives the wheel URL from its own script src, which
 # already carries the version prefix.
 def setup(app):
-    """Build the anyplotlib wheel for the in-browser Pyodide bridge."""
+    """Build the anyplotlib wheel for the in-browser Pyodide bridge.
+
+    In CI the workflow pre-builds the wheel before sphinx-build runs, so we
+    skip the build step if ``anyplotlib-0.0.0-py3-none-any.whl`` is already
+    present.  This avoids a redundant ``pip wheel`` invocation and keeps the
+    local ``make html`` path working without needing ``uv build``.
+    """
     import subprocess
     import sys
     from pathlib import Path
 
     wheels_dir = Path(__file__).parent / "_static" / "wheels"
     wheels_dir.mkdir(parents=True, exist_ok=True)
 
+    stable = wheels_dir / "anyplotlib-0.0.0-py3-none-any.whl"
+
+    # If the wheel was already built by the workflow step (or a previous local
+    # build), reuse it rather than rebuilding.
+    if stable.exists():
+        print(f"[pyodide_bridge] wheel already present → {stable}")
+        return
+
     # Remove stale wheels from previous builds.
     for old in wheels_dir.glob("anyplotlib*.whl"):
         old.unlink(missing_ok=True)
@@ -153,13 +167,11 @@ def setup(app):
         print(f"\n[pyodide_bridge] WARNING: wheel build failed:\n{result.stderr}")
         return
 
-    # Rename to a stable, version-agnostic filename so pyodide_bridge.js can
-    # reference it without knowing the current version string.
-    # NOTE: "latest" is NOT a valid PEP 440 version; micropip rejects it.
-    # "0.0.0" is the simplest valid sentinel that micropip accepts when the
-    # wheel is installed via URL (no PyPI version-check happens for URL installs).
+    # Rename to the stable sentinel name micropip accepts for URL installs.
+    # "0.0.0" is a valid PEP 440 version; micropip skips PyPI checks for
+    # wheels installed by URL so the actual version number doesn't matter.
     wheels = sorted(wheels_dir.glob("anyplotlib*.whl"))
     if wheels:
-        stable = wheels_dir / "anyplotlib-0.0.0-py3-none-any.whl"
         stable.unlink(missing_ok=True)
         wheels[-1].rename(stable)
+        print(f"[pyodide_bridge] wheel → {stable}")