PyWebIO v1.2.2 使用手册

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

摘要

PyWebIO 是一个用于在浏览器上进行交互式输入输出的Python库，允许开发者像编写终端脚本一样构建基于浏览器的应用。文档详细介绍了PyWebIO的使用方法，包括输入输出函数、服务器-客户端通信协议（支持WebSocket和HTTP）、静态资源托管、基于线程和协程的会话机制，以及与常见Web框架（如Flask、Django、Tornado、aiohttp）的整合。此外，文档还涵盖了安全性支持、国际化、SEO优化等功能，并提供了安装和使用示例。

AI总结

### PyWebIO v1.2.2 使用手册总结

#### 1. **核心特性**
- **命令式API**：通过类似控制台程序的方式编写代码，使用`put_text`、`put_image`、`input`等函数实现输入输出。
- **同步阻塞式输入**：输入函数（如`input`）在用户提交前阻塞，简化了交互逻辑。
- **布局支持**：支持点击事件、表单布局，提供良好的用户体验。
- **框架整合**：可与主流Web框架（如Flask、Django、Tornado、aiohttp）集成，适合快速构建Web应用。
- **线程与协程支持**：提供基于线程和协程的会话实现，适合不同场景的需求。

#### 2. **新功能亮点**
- **WebSocket重连支持**：通过`reconnect_timeout`参数实现连接重连。
- **部署支持**：新增`path deploy()`等命令，支持从目录加载运行应用。
- **输出功能增强**：新增`put_info`、`put_error`等函数，支持上下文管理器。
- **数据可视化**：支持使用`pyg2plot`进行数据可视化，丰富了应用功能。
- **静态文件托管**：新增`static_dir`参数，支持本地静态文件托管。

#### 3. **服务器-客户端通信**
- **WebSocket通信**：使用Tornado或aiohttp后端时，默认通过WebSocket协议通信。
- **HTTP通信**：使用Flask或Django后端时，通过HTTP长轮询实现交互。
- **命令与事件**：命令由服务器发送到客户端，事件由客户端发送到服务器，用于实现交互逻辑。

#### 4. **静态资源托管**
- 默认使用CDN托管静态资源，支持离线部署时手动托管。
- 使用`cdn=False`参数可启动本地静态资源服务，无需额外配置。

#### 5. **会话管理**
- **基于线程**：默认使用线程隔离会话，适合I/O密集型任务。
- **基于协程**：支持协程函数，适合高并发场景，但不支持脚本模式。

#### 6. **安装与使用**
- **安装**：通过`pip install pywebio`安装稳定版，或使用开发版。
- **示例**：提供计算BMI指数的示例脚本，展示了基本输入输出功能。

#### 7. **使用建议**
- 遇到设计问题时，参考终端程序的交互方式解决问题。
- 对于复杂交互，可使用`put_buttons()`的回调机制。

PyWebIO通过简洁的API和灵活的框架整合，适合快速开发对UI要求不高的Web应用。