docs: move to newest pyodide toolchain

.github/workflows/docs.yml

@@ -13,7 +13,8 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  PYTHON_VERSION: "3.10.6"
+  WASM_PYTHON_VERSION: "3.11.2"
+  X86_64_PYTHON_VERSION: "3.10.6"
   SOURCE_DATE_EPOCH: "1668811211"
 
 jobs:
@@ -28,7 +29,7 @@ jobs:
     - name: Setup Python
       uses: actions/setup-python@v4
       with:
-        python-version: "${{ env.PYTHON_VERSION }}"
+        python-version: "${{ env.WASM_PYTHON_VERSION }}"
 
     - name: Generate build files
       run: pipx run nox -s prepare -- --headers --signatures
@@ -38,21 +39,35 @@ jobs:
       uses: actions/cache@v3
       with:
         path: ./awkward-cpp/dist
-        key: ${{ runner.os }}-${{ env.PYTHON_VERSION }}-awkward-cpp-wasm-${{ hashFiles('awkward-cpp/**') }}
+        key: ${{ runner.os }}-${{ env.WASM_PYTHON_VERSION }}-awkward-cpp-wasm-${{ hashFiles('awkward-cpp/**') }}-CACHEBUST
+
+    - name: Install dependencies
+      if: steps.cache-awkward-cpp-wasm-wheel.outputs.cache-hit != 'true'
+      run: python3 -m pip install -r docs/requirements-wasm.txt
+
+    - name: Install dependencies
+      if: steps.cache-awkward-cpp-wasm-wheel.outputs.cache-hit != 'true'
+      id: compute-emsdk-version
+      run: |
+        # Prepare xbuild environment (side-effect)
+        pyodide config list
+        # Save EMSDK version
+        EMSCRIPTEN_VERSION=$(pyodide config get emscripten_version)
+        echo "emsdk-version=$EMSCRIPTEN_VERSION" >> $GITHUB_OUTPUT
+      working-directory: awkward-cpp
 
     - name: Install EMSDK
       uses: mymindstorm/setup-emsdk@v12
       if: steps.cache-awkward-cpp-wasm-wheel.outputs.cache-hit != 'true'
       with:
-        version: 3.1.14
+        version: ${{ steps.compute-emsdk-version.outputs.emsdk-version }}
 
     - name: Build wheel
       if: steps.cache-awkward-cpp-wasm-wheel.outputs.cache-hit != 'true'
+      id: build-awkward-cpp-wasm-wheel
       run: |
         # pyodide-build doesn't work out of the box with pipx
-        python3 -m pip install pyyaml pyodide-build==0.21.0
-        export CMAKE_ARGS="-DEMSCRIPTEN=1"
-        pyodide build --exports whole_archive
+        CMAKE_ARGS="-DEMSCRIPTEN=1 -DCMAKE_FIND_ROOT_PATH_MODE_PACKAGE=BOTH" pyodide build --exports whole_archive
       working-directory: awkward-cpp
 
     - name: Upload wheel
@@ -64,6 +79,10 @@ jobs:
   awkward-cpp-x86-64:
     runs-on: ubuntu-22.04
     name: Build C++ x86
+    defaults:
+      run:
+        # Ensure conda env is activated
+        shell: "bash -l {0}"
     steps:
     - uses: actions/checkout@v3
       with:
@@ -88,8 +107,9 @@ jobs:
         cache-downloads: true
         environment-file: docs/environment.yml
         create-args: >-
-           python=${{ env.PYTHON_VERSION }}
+           python=${{ env.X86_64_PYTHON_VERSION }}
            doxygen
+           python-build
 
     - name: Generate build files
       run: pipx run nox -s prepare -- --headers --signatures
@@ -99,11 +119,11 @@ jobs:
       uses: actions/cache@v3
       with:
         path: ./awkward-cpp/dist
-        key: ${{ runner.os }}-${{ env.PYTHON_VERSION }}-awkward-x86-64-wasm-${{ hashFiles('awkward-cpp/**') }}
+        key: ${{ runner.os }}-${{ env.X86_64_PYTHON_VERSION }}-awkward-x86-64-wasm-${{ hashFiles('awkward-cpp/**') }}
 
     - name: Build wheel
       if: steps.cache-awkward-cpp-x86-64-wheel.outputs.cache-hit != 'true'
-      run: pipx run build -w ./awkward-cpp
+      run: python -m build -w ./awkward-cpp
 
     - name: Upload wheel
       uses: actions/upload-artifact@v3
@@ -164,7 +184,7 @@ jobs:
         cache-downloads: true
         environment-file: docs/environment.yml
         create-args: >-
-           python=${{ env.PYTHON_VERSION }}
+           python=${{ env.X86_64_PYTHON_VERSION }}
            doxygen
 
     - name: Download awkward wheel

awkward-cpp/pyproject.toml

@@ -69,3 +69,9 @@ sdist.include = [
     "tests-spec-explicit",
     "tests-cpu-kernels"
 ]
+
+# This activates verbose builds
+cmake.verbose = true
+
+# Display logs at or above this level.
+logging.level = "DEBUG"

docs/requirements-wasm.txt

@@ -0,0 +1 @@
+pyodide-build==0.23.1

docs/requirements.txt

@@ -1,3 +1,8 @@
+# JupyterLite (kernel requires specific pyodide version)
+jupyterlite-pyodide-kernel==0.0.7
+jupyterlite[piplite]==0.1.0
+jupyterlite-sphinx==0.8.0
+
 sphinx>=4.5.0,<5.0.0
 PyYAML
 black
@@ -9,12 +14,10 @@ sphinx-sitemap
 pydata-sphinx-theme
 myst-nb
 sphinx-external-toc
-jupyterlite-sphinx==0.7.3
 ipyleaflet
-jupyterlite[piplite]==0.1.0b16
 
 numpy>=1.13.1
-numba>=0.50.0
+numba>=0.50.0;python_version<"3.11"
 pandas>=0.24.0
 numexpr
 pyarrow>=7.0.0