Sphinx-anywidget

.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
+
+

Examples/Interactive/plot_interactive_fft.py

@@ -178,7 +178,4 @@ def _roi_released(event):
     v_fft.set_data(log_mag, x_axis=freq_x, y_axis=freq_y, units="1/\u00c5")
 
 
-fig
-
-
-
+fig  # Interactive

Examples/Interactive/plot_interactive_fitting.py

@@ -19,6 +19,9 @@
 and the sum curve will jump to the optimal fit.
 Click a component line again to hide its widgets.
 """
+# Packages required when running interactively in Pyodide (docs live mode).
+_PYODIDE_PACKAGES = ["scipy"]
+
 import numpy as np
 from scipy.optimize import curve_fit
 import anyplotlib as apl
@@ -289,4 +292,4 @@ def _on_fit(event):
     def _clicked(event, c=comp):
         c.toggle()
 
-fig
+fig # Interactive

Examples/Interactive/plot_key_bindings.py

@@ -118,5 +118,4 @@ def log_key(event):
     print(f"[on_key] key={event.key!r}  img={pos}"
           f"  last_widget={event.last_widget_id!r}")
 
-fig
-
+fig  # Interactive

Examples/Interactive/plot_point_widget.py

@@ -105,5 +105,5 @@ def _settled(event):
     _draw_tangent(event.x)
 
 
-fig
+fig  # Interactive
 

Examples/Interactive/plot_segment_by_contrast.py

@@ -232,6 +232,6 @@ def _delete_nearest(event):
         _refresh()
 
 
-fig
+fig # Interactive