bokeh.command.util

为实现 bokeh 命令。

build_single_handler_application(path: str, argv: Optional[Sequence[str]] = None) → bokeh.application.application.Application

返回使用单个处理程序为脚本、笔记本或目录生成的Bokeh应用程序。

总的来说是一个博克 Application 可能有任意数量的处理程序要初始化 Document 新客户端会话的对象。但是，在许多情况下，只需要一个处理程序。此函数检查 path 提供，并返回 Application 使用以下处理程序之一初始化：

• ScriptHandler 什么时候？ path 是一个 .py 脚本。

• NotebookHandler 什么时候？ path 是一个 .ipynb Jupyter笔记本。

• DirectoryHandler 什么时候？ path 是指向包含 main.py 脚本。

参数

• path (str) -- 用于创建Bokeh应用程序的文件或目录的路径。

• argv (seq[str], optional) -- 要传递给应用程序处理程序的命令行参数

返回

Application

引发

RuntimeError --

提示

如果 path 以文件结尾 main.py 然后，将通过传递目录来打印有关运行目录样式应用程序的警告。

build_single_handler_applications(paths: List[str], argvs: Optional[Dict[str, List[str]]] = None) → Dict[str, bokeh.application.application.Application]

对于指定的文件或目录，返回到使用单个处理程序生成的Bokeh应用程序的字典映射路由。

此函数迭代 paths 和 argvs 和电话 build_single_handler_application() 以生成映射。

参数

• paths (seq[str]) -- 用于创建Bokeh应用程序的文件或目录的路径。

• argvs (dict[str, list[str]], optional) -- 将路径映射到要传递给每个路径的处理程序的命令行参数

返回

双关语 [结构，应用]

引发

RuntimeError --

die(message: str, status: Optional[int] = 1) → None

打印错误消息并退出。

此函数将调用 sys.exit 用给定的 status 这个过程就会终止。

参数

• message (str) -- 要打印的错误消息

• status (int) -- 要传递到的退出状态 sys.exit

report_server_init_errors(address: Optional[str] = None, port: Optional[int] = None, **kwargs: str) → Iterator[None]

一个上下文管理器，当 Server 由于网络问题无法启动。

参数

• address (str) -- 服务器将监听的网络地址

• port (int) -- 服务器将监听的网络地址

示例

with report_server_init_errors(**server_kwargs):
    server = Server(applications, **server_kwargs)

如果有任何错误（例如端口或地址已在使用中），则会记录一个严重错误，进程将通过调用 sys.exit(1)