jupyter notebook 扩展开发之 Custom bundler extensions

xxxspy 2018-03-31 20:19:18
Categories： Tags：

这是jupyter notebook 插件开发的系列文档之一, 文章最末尾列出了这个系列的所有博客连接.

Custom bundler extensions

笔记本服务器支持编写用于转换/打包/下载/部署笔记本文件的bundler扩展。作为开发人员，您只需编写一个Python函数来实现一个bundler。笔记本服务器会自动在笔记本前端生成一个 File -> Download 或File -> Deploy菜单项，以触发您的bundler程序。

以下是可以使用bundler扩展实现的一些示例：

要实现bundler扩展，您必须执行以下所有操作：

以下各节详细介绍这些步骤。

声明bundler元数据

您必须通过实现_jupyter_bundlerextensions_paths函数提供有关bundler扩展的信息。只要可以在import package时能够引入你的bundler，此函数可以放在在软件包中的任何位置。 （请参阅启用/禁用捆绑程序扩展。）

1
2
3
4
5
6
7
8
9
10
# in mypackage.hello_bundler

def _jupyter_bundlerextension_paths():
    """Example "hello world" bundler extension"""
    return [{
        'name': 'hello_bundler',                    # unique bundler name
        'label': 'Hello Bundler',                   # human-redable menu item label
        'module_name': 'mypackage.hello_bundler',   # module containing bundle()
        'group': 'deploy'                           # group under 'deploy' or 'download' menu
    }]

请注意，返回值是一个列表。通过返回列表中的多个字典，您允许用户一次启用/禁用所有bundler。

Writing the bundle function

在运行时，具有给定标签的菜单项出现在File -> Download 或File -> Deploy菜单中，具体取决于元数据中的值。当用户单击菜单项时，会打开一个新的浏览器选项卡，并且笔记本服务器将调用元数据中指定的module_name中的包函数。

您必须实现类似以下代码的bundler：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# in mypackage.hello_bundler

def bundle(handler, model):
    """Transform, convert, bundle, etc. the notebook referenced by the given
    model.

    Then issue a Tornado web response using the `handler` to redirect
    the user's browser, download a file, show a HTML page, etc. This function
    must finish the handler response before returning either explicitly or by
    raising an exception.

    Parameters
    ----------
    handler : tornado.web.RequestHandler
        Handler that serviced the bundle request
    model : dict
        Notebook model from the configured ContentManager
    """
    handler.finish('I bundled {}!'.format(model['path']))

您的bundler函数可以随意执行任何需求并以任何方式进行响应。例如，它可以从请求中读取附加的查询参数，发出重定向到另一个站点，运行本地进程（例如nbconvert），向另一个服务发出HTTP请求等。

bundler函数的调用者是@ tornado.gen.coroutine，并用torando.gen.maybe_future封装其调用。这种行为意味着你可以像上面的例子那样同步处理web请求，或者像下面的例子那样异步使用@ tornado.gen.coroutine和yield。

如果bundler长时间运行，您应该更喜欢采用第二种异步方法，否则会在同步处理时阻塞笔记本服务器主循环。

有关从菜单项点击到捆bundler函数调用的数据流的更多细节，请参阅bundler程序调用详细信息。

笔记本服务器有用于启用和禁用bundler程序扩展的命令行接口（CLI）。

您应该写文档说明启用和禁用bundler的基本命令。例如, 启用hello_bundler示例的一个可能命令如下：

1
jupyter bundlerextension enable --py mypackage.hello_bundler --sys-prefix

以上内容将使用mypackage.hellow_bundler._jupyter_bundlerextension_paths函数返回的元数据更新当前conda / virtualenv环境（-sys-prefix）中的笔记本配置文件。

禁用bundler函数的相应命令如下：

1
jupyter bundlerextension disable --py mypackage.hello_bundler --sys-prefix

有关使用bundlerextension子命令的更多帮助，请运行以下命令。

1
jupyter bundlerextension --help

Example: IPython Notebook bundle (.zip)

本文档中的hello_bundler示例简洁明了。有关更多有意义的示例，请参阅notebook / bundler / zip_bundler.py和notebook / bundler / tarball_bundler.py。你可以像这样尝试它们：

1
2
jupyter bundlerextension enable --py notebook.bundler.zip_bundler --sys-prefix
jupyter bundlerextension enable --py notebook.bundler.tarball_bundler --sys-prefix

Bundler invocation details

jupyter notebook 扩展开发系列:

转载请注明出处:http://mlln.cn 或者 http://jupyter.cn

python win32com开发office插件时问题汇总
jupyter notebook 扩展开发之 文件保存钩子