跳转到主要内容

由Pyodide支持的JupyterLite Python内核

项目描述

jupyterlite-pyodide-kernel

一个由 Pyodide 驱动的 Python 内核,用于 JupyterLite

ci-badge lite-badge docs-badge

需求

  • python >=3.8

兼容性

与 Jupyter 兼容

状态 jupyterlite-pyodide-kernel jupyterlite-core jupyterlab notebook retrolab
预发布 0.4.* >=0.4,<0.5 >=4.2.0,<4.3 >=7.2.0,<7.3 -
稳定 0.3.* >=0.3,<0.4 >=4.1.1,<4.2 >=7.1.0,<7.2 -
稳定 0.2.* >=0.2,<0.3 >=4.0.7,<4.1 >=7.0.5,<8 -
稳定 0.1.* >=0.1,<0.2 >=3.5,<3.6 - >=0.3,<0.4

使用您的包管理器安装与您的包匹配的 JupyterLab 版本可以帮助确保匹配的 labextension 资产和内核依赖,尽管这个内核在 JupyterLab 或 Notebook 这样的完整 jupyter_server 宿主客户端中还不能正常工作。

与 Pyodide 兼容

jupyterlite-pyodide-kernel pyodide python emscripten
>=0.1.0,<=0.1.1 0.23.* 3.10.* 3.1.29
>=0.1.2,<=0.2.1 0.24.* 3.10.* 3.1.45
>=0.2.2,<=0.2.3 0.25.* 3.11.* 3.1.46
>=0.3.*,<=0.4.0 0.25.* 3.11.* 3.1.46
>=0.4.*,<=0.5.0 0.26.* 3.12.* 3.1.58

注意,Emscripten 版本严格到修复错误版本。

安装

要安装 Pyodide 内核 labextension 和 jupyter lite 的 CLI 插件,请运行

pip install jupyterlite-pyodide-kernel

或者使用 condamambamicromamba 等。

conda install -c conda-forge jupyterlite-pyodide-kernel

有关更多选项,请参阅 开发安装贡献指南

使用方法

构建 JupyterLite 网站

jupyter lite build

还有一些新的 CLI 选项可用

jupyter lite --help

这应该会显示类似以下内容

  --piplite-wheels=<typedtuple-item-1>...
      Local paths or URLs of piplite-compatible wheels to copy and index
      Default: ()
      Equivalent to: [--PipliteAddon.piplite_urls]
  --pyodide=<Unicode>
      Local path or URL of a pyodide distribution tarball
      Default: ''
      Equivalent to: [--PyodideAddon.pyodide_url]

了解更多

⚠️ 高级配置的文档可在 JupyterLite 主文档网站找到

卸载

要删除扩展,请运行

pip uninstall jupyterlite-pyodide-kernel  # or however you installed it

预发布版本

要使用 pip 安装预发布版本

pip install --upgrade --pre jupyterlite-pyodide-kernel

或者,在 conda 生态系统中的类似情况下,对于 alpha 软件包

conda install \
  -c conda-forge/label/jupyterlite_core_alpha \
  -c conda-forge/label/jupyterlite_pyodide_kernel_alpha \
  -c conda-forge \
  jupyterlite-pyodide-kernel

注意:_beta_rc 软件包将遵循类似的频道命名约定

开发安装

以下是一个简要概述,快速开始。请参阅 贡献指南 获取完整详情。

开发需求

推荐 使用您选择的工具提供的 Python 虚拟环境,例如以下之一

  • virtualenv
  • mamba
  • conda

确保本地开发环境具有

  • git
  • nodejs 20
  • python >=3.8

开发快速入门

git clone https://github.com/jupyterlite/pyodide-kernel
cd pyodide-kernel
npm run quickstart

然后,使用 Python 内置的 HTTP 服务器提供构建的演示网站、文档和测试报告

jlpm serve

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于 安装包的信息

源分发

jupyterlite_pyodide_kernel-0.4.2.tar.gz (503.8 kB 查看哈希值)

上传时间

构建分发

jupyterlite_pyodide_kernel-0.4.2-py3-none-any.whl (520.8 kB 查看哈希值)

上传时间 Python 3