Update Emscripten instructions to match xeus-cpp in where dependencies are installed from + mount tag files (no longer preloaded in xeus-cpp) (#618)

Author: mcbarton

.github/workflows/deploy-pages.yml

@@ -238,10 +238,15 @@ jobs:
       shell: bash -l {0}
       run: |
           cd ./xeus-cpp/
-          micromamba create -n xeus-lite-host jupyterlite-core -c conda-forge
+          micromamba create -n xeus-lite-host jupyterlite-core=0.6 jupyterlite-xeus jupyter_server jupyterlab notebook python-libarchive-c -c conda-forge
           micromamba activate xeus-lite-host
-          python -m pip install jupyterlite-xeus jupyterlite-core jupyterlab notebook libarchive-c
-          jupyter lite build --XeusAddon.prefix=${{ env.PREFIX }} --contents notebooks/xeus-cpp-lite-demo.ipynb --contents notebooks/smallpt.ipynb --contents notebooks/images/marie.png --contents notebooks/audio/audio.wav --output-dir dist
+          jupyter lite build --XeusAddon.prefix=${{ env.PREFIX }} \
+                             --contents notebooks/xeus-cpp-lite-demo.ipynb \
+                             --contents notebooks/smallpt.ipynb \
+                             --contents notebooks/images/marie.png \
+                             --contents notebooks/audio/audio.wav \
+                             --XeusAddon.mounts="${{ env.PREFIX }}/share/xeus-cpp/tagfiles:/share/xeus-cpp/tagfiles" \
+                             --XeusAddon.mounts="${{ env.PREFIX }}/etc/xeus-cpp/tags.d:/etc/xeus-cpp/tags.d" --output-dir dist
 
     - name: Upload artifact
       uses: actions/upload-pages-artifact@v3

.github/workflows/emscripten.yml

@@ -830,3 +830,12 @@ jobs:
         micromamba activate CppInterOp-wasm
         cd ./xeus-cpp/build/test
         node test_xeus_cpp.js
+
+    - name: Jupyter Lite integration
+      if: ${{ runner.os != 'windows' }}
+      shell: bash -l {0}
+      run: |
+          cd ./xeus-cpp/
+          micromamba create -n xeus-lite-host jupyterlite-core=0.6 jupyterlite-xeus jupyter_server jupyterlab notebook python-libarchive-c -c conda-forge
+          micromamba activate xeus-lite-host
+          jupyter lite build --XeusAddon.prefix=${{ env.PREFIX }} --contents notebooks/xeus-cpp-lite-demo.ipynb --contents notebooks/smallpt.ipynb --contents notebooks/images/marie.png --contents notebooks/audio/audio.wav --output-dir dist

Emscripten-build-instructions.md

@@ -316,10 +316,15 @@ To build Jupyter Lite website with this kernel locally that you can use for test
 
 ```bash
 cd ../..
-micromamba create -n xeus-lite-host jupyterlite-core -c conda-forge
+micromamba create -n xeus-lite-host jupyterlite-core=0.6 jupyterlite-xeus jupyter_server jupyterlab notebook python-libarchive-c -c conda-forge
 micromamba activate xeus-lite-host
-python -m pip install jupyterlite-xeus jupyter_server
-jupyter lite build --XeusAddon.prefix=$PREFIX --contents xeus-cpp/notebooks/xeus-cpp-lite-demo.ipynb --contents notebooks/smallpt.ipynb --contents notebooks/images/marie.png --contents notebooks/audio/audio.wav
+jupyter lite build --XeusAddon.prefix=$PREFIX \
+                   --contents xeus-cpp/notebooks/xeus-cpp-lite-demo.ipynb \
+                   --contents xeus-cpp/notebooks/smallpt.ipynb \
+                   --contents xeus-cpp/notebooks/images/marie.png \
+                   --contents xeus-cpp/notebooks/audio/audio.wav \
+                   --XeusAddon.mounts="$PREFIX/share/xeus-cpp/tagfiles:/share/xeus-cpp/tagfiles" \
+                   --XeusAddon.mounts="$PREFIX/etc/xeus-cpp/tags.d:/etc/xeus-cpp/tags.d"
 ```
 
 Once the Jupyter Lite site has built you can test the website locally by executing

docs/Emscripten-build-instructions.rst

@@ -341,10 +341,15 @@ for testing execute the following
 .. code:: bash
 
    cd ../..
-   micromamba create -n xeus-lite-host jupyterlite-core -c conda-forge
+   micromamba create -n xeus-lite-host jupyterlite-core=0.6 jupyterlite-xeus jupyter_server jupyterlab notebook python-libarchive-c -c conda-forge
    micromamba activate xeus-lite-host
-   python -m pip install jupyterlite-xeus jupyter_server
-   jupyter lite build --XeusAddon.prefix=$PREFIX --contents xeus-cpp/notebooks/xeus-cpp-lite-demo.ipynb --contents notebooks/smallpt.ipynb --contents notebooks/images/marie.png --contents notebooks/audio/audio.wav
+   jupyter lite build --XeusAddon.prefix=$PREFIX \
+                      --contents xeus-cpp/notebooks/xeus-cpp-lite-demo.ipynb \
+                      --contents xeus-cpp/notebooks/smallpt.ipynb \
+                      --contents xeus-cpp/notebooks/images/marie.png \ 
+                      --contents xeus-cpp/notebooks/audio/audio.wav \
+                      --XeusAddon.mounts="$PREFIX/share/xeus-cpp/tagfiles:/share/xeus-cpp/tagfiles" \
+                      --XeusAddon.mounts="$PREFIX/etc/xeus-cpp/tags.d:/etc/xeus-cpp/tags.d"
 
 Once the Jupyter Lite site has built you can test the website locally by
 executing