PyWebIO v1.4.0 使用手册

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

摘要

PyWebIO 是一个用于快速构建基于浏览器的交互式应用的 Python 库。它提供了一系列命令式的交互函数，允许开发者像编写终端脚本一样在浏览器上进行用户输入和输出操作。PyWebIO 支持将浏览器作为终端使用，适合快速构建对 UI 要求不高的 Web 应用，并能够方便地与现有的 Web 服务框架进行集成。文档详细介绍了其核心功能、使用方法以及高级特性，包括会话管理、数据可视化、静态文件托管等。

AI总结

《PyWebIO v1.4.0 使用手册》总结：

1. **核心功能**
PyWebIO 是一个用于快速开发基于浏览器的交互式应用的 Python 库，支持命令式 API，类似于编写终端程序，但输出和输入通过浏览器完成。主要功能包括：
- **输出功能**：通过 `put_text()`、`put_image()`、`put_table()` 等函数输出内容到浏览器。
- **输入功能**：通过 `input()`、`select()`、`file_upload()` 等函数接收用户输入。
- **交互支持**：支持点击事件、布局管理（如 `put_row()`、`put_grid()`）以及 JavaScript 执行（`run_js()`、`eval_js()`）。

2. **主要模块**
- **`pywebio.session` 模块**：提供会话控制功能，包括设置环境（标题、页面外观等）、获取会话信息（用户 IP、浏览器信息等）、本地存储（`local` 对象）。
- **`pywebio.pin` 模块**：支持持续性输入，使表单保持可见并持续接收用户输入。
- **`pywebio.platform` 模块**：支持多种部署方式（WebSocket 和 HTTP 协议），并提供静态文件托管和网页配置功能。

3. **高级特性**
- **与 Web 框架集成**：可将 PyWebIO 应用整合到现有 Web 框架（如 Flask、Django）中。
- **协程支持**：基于协程的会话模式，适合异步处理。
- **打包应用**：通过 `pywebio.config()` 和 `pyinstaller` 可将应用打包为独立可执行文件。
- **数据可视化**：支持使用 `pyg2plot` 进行数据可视化。

4. **更新亮点**
- **新功能**：新增 `put_collapse()`、`put_tabs()` 等输出函数，支持 Markdown 渲染、代码高亮、文件下载等。
- **性能优化**：提升应用访问速度，优化浏览器不支持提示。
- **安全性增强**：在 `put_html()` 和 `put_markdown()` 中增加防 XSS 攻击支持。

5. **使用建议**
- 开发者可以像编写终端脚本一样使用 PyWebIO，但遇到复杂交互需求时，可结合 `pin` 模块或回调机制解决问题。
- 文档中提供大量在线示例，右上角有 Demo 链接，方便在线预览效果。

6. **安装与部署**
- 通过 `pip install pywebio` 安装。
- 支持通过 `pywebio.start_server()` 启动服务，默认使用 WebSocket 协议，也可配置为 HTTP。
- 支持静态文件托管（`static_dir` 参数）和 SEO 配置。

总结：PyWebIO 是一个功能强大且易用的库，适合快速开发基于浏览器的交互式应用，尤其适合对 UI 要求不高的场景。其命令式 API 和丰富的输出/输入功能极大简化了 Web 应用开发流程。