Advanced Configuration

Warning

This section is mostly for reference and should not be needed for regular use of the jupyterlite-xeus kernel.

Provide a custom empack_config.yaml

Packages sometimes ship more data than needed for the package to work (tests, documentation, data files etc). This is fine on a regular installation of the package, but in the emscripten case when running in the browser this means that starting the kernel would download more files. For this reason, empack allows filtering files that is are not required for the Python code to run. It does it by following a set of filtering rules available in this file: emscripten-forge/empack.

The xeus-python kernel supports passing a custom empack_config.yaml. This file can be used to override the default filter rules set by the underlying empack tool used for packing the environment.

If you would like to provide additional rules for excluding files in the packed environment, create a empack_config.yaml with the following content as an example:

packages:
  xarray:
    exclude_patterns:
      - pattern: '**/static/css/*.css'
      - pattern: '**/static/html/*.html'

This example defines a set of custom rules for the xarray package to make sure it excludes some static files that are not required for the code to run.

You can use this file when building JupyterLite:

jupyter lite build --XeusAddon.empack_config=empack_config.yaml

Note

Filtering files helps reduce the size of the assets to download and as a consequence reduce network traffic.