Try deploying jupyterlite

Author: 777arc

.github/workflows/build-and-deploy.yml

@@ -97,6 +97,15 @@ jobs:
         env:
           CREATOR_ID: ${{ secrets.CREATOR_ID }}
 
+      # Build a self-hosted JupyterLite environment into _build/jupyterlite so the
+      # interactive "run this code" links in the book point at our own deployment
+      # rather than a third-party demo site. Done last so its pip installs can't
+      # disturb the Sphinx builds above.
+      - name: Build JupyterLite
+        run: |
+          pip install -r requirements-jupyterlite.txt
+          jupyter lite build --contents jupyterlite --output-dir _build/jupyterlite
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3.0.1
         with:

content/intro.rst

@@ -49,6 +49,8 @@ PySDR purposefully does not include a custom Python library or any wrapper funct
 
 Note that while Python is "slower" than C/C++ in general, most functions within Python/NumPy are actually implemented in C/C++ under the hood and heavily optimized, so you might be surprised how fast CPU-based DSP can run in Python.  Likewise, the SDR APIs we use (e.g., UHD) are simply a set of Python bindings for C/C++ functions/classes.  For fielded RF systems, high-rate signal processing is typically implemented in the FPGA anyway!
 
+Some PySDR chapters contain example code that can be opened as a web-based Jupyter notebook (using JupyterLite), allowing you to play with and run the Python examples entirely from your browser without installing anything.  To check if it works on your browser, try opening `this example <../jupyterlite/notebooks/index.html?path=example.ipynb>`_.
+
 ************
 Contributing
 ************

jupyterlite/example.ipynb

@@ -0,0 +1,27 @@
+{
+ "cells": [
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "example-cell",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "import numpy as np\n",
+    "print(np.arange(10))"
+   ]
+  }
+ ],
+ "metadata": {
+  "kernelspec": {
+   "display_name": "Python (Pyodide)",
+   "language": "python",
+   "name": "python"
+  },
+  "language_info": {
+   "name": "python"
+  }
+ },
+ "nbformat": 4,
+ "nbformat_minor": 5
+}

requirements-jupyterlite.txt

@@ -0,0 +1,5 @@
+# Used only to build the self-hosted JupyterLite environment deployed at /jupyterlite/
+# Kept separate from requirements.txt so it can't disturb the (older) Sphinx pins.
+jupyterlite-core==0.8.1
+jupyterlite-pyodide-kernel==0.8.1
+jupyter-server==2.20.0  # required for `jupyter lite build --contents` to bundle the notebook(s) in jupyterlite/

spelling_wordlist.txt

@@ -12,6 +12,7 @@ sc
 np
 NumPy
 numpy
+JupyterLite
 Arg
 frontend
 dBm