ipypy

Store Jupyter Notebooks in a more repo and coding friendly way.

你是否注意到，现在的Jupyter Notebook是一个json文件？它包含了笔记本本身的元数据、单元格列表，以及每个单元格的内容，不仅包括源（上面写的内容），还包括输出和每个单元格的元数据。

本项目试图提供一种替代方案。

如何

您可以选择SplitCodeManager，将每个笔记本存储在

• my_file.ipynb（常规笔记本文件，但包含提取的源信息）
• my_file.ipypy（一个只存储实际源代码的纯代码文件）

或者，选择SplitOutputManager，将每个笔记本存储在

• my_file.ipynb（常规笔记本文件，但不包含单元格输出）
• my_file.nbout（一个只存储每个单元格输出的json文件）

优点

• 现在您可以从另一个文件导入您的笔记本
• 现在您可以使用标准编码工具和惯例来操作笔记本代码
  • 测试
  • 导入其中定义的代码
  • 可以由任何编辑器自然编辑
  • 重构
  • 跟踪更改
  • ...
• 您的笔记本源代码可以在仓库中版本控制，其中diff和历史记录是可读的。现在有意义。它是代码。
• （正在进行中）您可以选择简单地忽略仓库中的元数据文件（.ipynb），或者保留它们进行版本控制。这应该由您自己决定。

警告

我们处于测试阶段。一旦您启用此扩展程序打开笔记本并保存，您的笔记本将以略不兼容的格式保存。

安装

$ pip install ipypy

您还需要配置您的jupyter，使其使用ipypy，通过编辑jupyter配置文件或从命令行进行

$ jupyter lab --NotebookApp.contents_manager_class="ipypy.SplitCodeManager"