概述

此仓库包含一组Jupyter Notebook插件，这些插件可以与pex和pants进行互操作。

安装

要安装此插件，只需像这样调用pip install

pip install pants-jupyter-plugin

插件加载

要在您的Jupyter Notebook环境中加载此插件，请在笔记本单元中使用%load_ext命令

%load_ext pants_jupyter_plugin

魔数

此软件包提供了3个主要魔数，用于从pex和/或pants目标加载Python环境。所有这些都会清除并替换现有的sys.path和环境，因此最好在导入任何模块之前这样做，以避免缓存的导入。

%pex_load

此魔数允许您将磁盘上存在的现有pex文件加载到Python环境中。

用法

%pex_load <path to pex file>

%requirements_load

此魔数允许您使用pex(1)将任意需求的传递闭包加载到环境中。

用法

%requirements_load <requirements>

%pants_load

这个魔法允许您构建并加载一个 pants python_binary 目标到环境中。它与 %pants_repo 魔法一起工作，这就是您如何将插件指向特定的 pants 兼容仓库的方式。

%pants_repo <path to pants repo>
...
%pants_load <pants target>

开发

这个仓库使用 tox 进行测试和项目自动化。在提交更改供审查之前，只需调用 tox 即可测试您的更改。

$ tox

这将自动格式化代码并运行测试。测试接受传递参数，并且已安装 pytest-xdist，因此您可以通过以下方式以最大并行性运行完整的测试套件：

$ tox -p -epy3{6,7,8,9} -- -n auto

在这里，您将对项目支持的所有解释器运行测试（假设您已将它们全部安装在您的机器上并在 $PATH 中），并行运行（tox 的 -p 标志），并且对于每个 tox 的并行运行，您都将并行运行单个测试方法（通过传递参数给 pytest-xdist：-- -n auto）。

要找出所有可用的 tox 环境，请使用 tox -a 或检查 tox.ini。