PyWebIO v1.8.2 使用手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: pywebio.readthedocs.io

摘要

《PyWebIO v1.8.2 使用手册》介绍了PyWebIO的功能、安装方法、使用示例及高级特性。文档详细讲解了输入输出模块的使用方法，支持通过WebSocket和HTTP协议与浏览器通信，并提供了多种部署方式。此外，还介绍了如何将PyWebIO应用与现有Web框架集成，支持数据可视化，并提到了最新的版本更新内容。

AI总结

《PyWebIO v1.8.2 使用手册》总结如下：

1. **核心功能**
PyWebIO 是一个用于编写基于浏览器的交互式 Python 应用的工具，支持将终端程序逻辑直接转化为网页交互。其主要功能包括：
- **输入模块**：提供多种输入方式（如单行输入、表单组输入）。
- **输出模块**：支持文本、图片、表格等多种输出形式。
- **会话管理**：支持基于线程和协程的会话实现，便于管理用户交互。
- **平台部署**：支持 WebSocket 和 HTTP 协议通信，可通过 `start_server()` 或 `path_deploy()` 部署为 Web 服务。

2. **主要模块**
- **pin 模块**：用于持续性输入，使输入表单保持显示并可多次接收输入。
- **platform 模块**：提供多种部署方式，支持跨域配置和静态文件托管。
- **输入与输出**：`input()` 和 `output()` 函数分别用于接收用户输入和显示内容，支持自定义布局和交互。
- **高级特性**：支持与现有 Web 框架集成、数据可视化（如 Bokeh）、打包独立可执行文件（使用 PyInstaller）。

3. **数据可视化与第三方库**
- PyWebIO 支持使用 Bokeh 等第三方库进行数据可视化，通过 `bokeh.io.output_notebook(notebook_type='pywebio')` 设置输出。
- 提供 `pywebio_battery` 扩展包，用于快速编写 PyWebIO 应用，包含文件上传 sanitization 和其他修复。

4. **更新日志**
- **v1.8.2**：新增 WebSocket 重连支持、静态文件托管、`put_image()` 和 `remove(anchor)` 等功能。
- **v1.2**：支持跨域配置、静态文件托管、新增提示消息函数（`put_info()`、`put_error()` 等）。
- **v1.1**：支持路径部署、调试模式、远程访问功能。

5. **使用场景**
- **Server 模式**：通过 `start_server()` 或 `path_deploy()` 部署为 Web 服务，支持多用户会话。
- **Script 模式**：直接运行脚本，自动打开浏览器页面，适用于简单交互场景。

6. **注意事项**
- 在 Server 模式下，输入、输出和会话函数仅能在任务函数上下文中调用。
- 使用 `pywebio_battery` 扩展包需额外安装：`pip3 install pywebio-battery`。

总结：PyWebIO 是一个功能强大且灵活的工具，适合快速开发基于浏览器的交互式应用，尤其适用于需要结合 Web 框架、数据可视化或打包部署的场景。