PyWebIO v1.4.0 使用手册

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

摘要

PyWebIO是一个用于在浏览器上进行用户交互的Python库，提供了一系列命令式的交互函数，允许开发者像编写终端脚本一样构建Web应用。它支持整合到现有Web框架（如Flask、Django等），具有同步输入输出、布局支持和第三方库集成等功能，特别适合快速构建对UI要求不高的应用。

AI总结

PyWebIO 是一个用于快速构建基于浏览器的交互式 Web 应用的 Python 库，其设计灵感来源于终端交互。它通过命令式 API 提供了丰富的输入和输出功能，使开发者能够像编写终端程序一样构建 Web 应用，而无需深入学习 HTML 和 JavaScript。以下是其核心功能和特点的总结：

### 核心功能
1. **命令式 API**
提供了一系列函数（如 `put_text()`、`input()`）来实现浏览器上的输入和输出，简化了交互式应用的开发。

2. **同步输入**
使用阻塞式输入函数（如 `input()`），在用户提交表单前不会返回，类似 Python 的 `input()`。

3. **布局支持**
通过 `put_grid()`、`put_row()` 等函数实现灵活的布局，支持点击事件和自定义样式。

4. **与 Web 框架整合**
支持与主流 Web 框架（如 Flask、Django、FastAPI）集成，便于整合到现有项目中。

5. **数据可视化**
提供了与第三方库（如 pyg2plot）的集成，支持在浏览器上展示数据图表。

6. **安全性增强**
新增防 XSS 攻击功能，支持 HTML 和 Markdown 内容的安全输出。

### 高级特性
- **协程支持**
支持基于协程的会话，适合异步任务处理。

- **打包应用**
可将 PyWebIO 应用打包为独立可执行文件，便于分发和运行。

- **静态文件托管**
通过 `start_server()` 的 `static_dir` 参数托管静态资源。

### 新增功能与改进
- **v1.4.0**
- 支持会话自动保持和绑定点击事件回调。
- 新增 `put_button()` 等输出函数，优化了全屏切换和等待提示功能。
- 修复了表单提交失败和代码编辑器显示问题。

- **v1.2**
- 支持 WebSocket 重连和从目录加载应用。
- 新增 `put_info()` 等消息提示函数，优化了文档和示例的可访问性。

- **v1.1**
- 增强了安全性，支持 SEO 优化和 CDN 集成。
- 修复了文件上传和浏览器兼容性问题。

### 安装与使用
- **安装**
使用 `pip` 安装稳定版或开发版，支持 Python 3.5.2 及以上版本。

- **示例**
提供了一个计算 BMI 指数的示例脚本，展示了如何使用输入和输出函数实现交互。

PyWebIO 适合快速开发对 UI 要求不高的 Web 应用，特别适合需要简单交互和快速开发的场景。更多详细信息可参考其文档和示例代码。