jupyterlite-xeus-python deprecation

jupyterlite-xeus-python 将于 2024 年 1 月起由 jupyterlite-xeus 取代并停止维护。本页面介绍迁移到这一新软件包的步骤。

jupyterlite-xeus 提供了一种通用方式，用于将基于 xeus 的内核安装到 JupyterLite 部署中。使用这个新库时，主要入口是 environment.yml 文件，其中指定了内核环境，包括内核和运行时依赖。

environment.yml 示例：

name: my-jupyterlite-env
channels:
  - https://repo.mamba.pm/emscripten-forge
  - conda-forge
dependencies:
  - xeus-python
  - xeus-lua
  - numpy
  - matplotlib
  - pip:
      - ipywidgets

迁移到 jupyterlite-xeus#

基础配置#

假设你的配置比较简单：安装了 jupyterlite-xeus-python，并通过 environment.yml 文件声明依赖：

现在需要在构建环境中安装 jupyterlite-xeus，而不是 jupyterlite-xeus-python。同时，environment.yml 需要显式添加运行时所需的 xeus-python，修改如下：

 name: my-jupyterlite-env
 channels:
   - https://repo.mamba.pm/emscripten-forge
   - conda-forge
 dependencies:
+  - xeus-python
   - numpy
   - matplotlib

如需参考使用 jupyterlite-xeus 的部署示例，请参阅 jupyterlite/xeus-python-demo。

CLI 选项#

如果你使用了 jupyterlite-xeus-python 提供的更多选项，例如 empack_config：

• xeus_python_version 选项已移除。请在 environment.yml 文件中指定所需的 xeus-python 版本。

• empack_config 选项仍受支持：jupyter lite build --XeusPythonEnv.empack_config=./file.yml 需要改为 jupyter lite build --XeusAddon.empack_config=./file.yml。

• pin_packages 选项已移除。

• 移除 packages 选项，依赖项只能在 environment.yml 中指定

• 仍支持 environment_file：jupyter lite build --XeusPythonEnv.environment_file=./file.yml 改为 jupyter lite build --XeusAddon.environment_file=./file.yml。默认值为 environment.yml。