PyWebIO v1.8.0 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: pywebio.readthedocs.io

摘要

文档主要介绍了PyWebIO框架的功能和使用方法，包括输入输出模块的使用、会话控制、平台部署、持久输入等功能。文档还详细说明了如何将PyWebIO集成到现有的Web框架中，并提供了丰富的代码示例和在线演示链接。此外，文档还介绍了PyWebIO的最新版本1.8.0的主要更新内容，包括新增功能和一些不兼容更改。

AI总结

《PyWebIO v1.8.0 Documentation》总结如下：

### 1. 用户指南
PyWebIO 通过命令式 API 提供了一种类似控制台编程的 Web 开发方式，开发者只需编写 Python 代码即可实现与用户的交互。其核心功能包括：
- **输入**：通过 `input()` 等函数获取用户输入，支持文本、数字等多种输入类型。
- **输出**：通过 `put_text()`、`put_image()` 等函数实时输出内容，支持文本、表格、图片等多种形式。
- **持久输入**：通过 `pin` 模块实现输入表单的持久化，方便持续交互。
- **会话控制**：通过 `session` 模块实现对会话的更细粒度控制，支持执行 JavaScript 和获取会话信息。

### 2. 主要模块
- **`pywebio.input`**：提供用户输入功能，支持阻塞式调用。
- **`pywebio.output`**：提供实时输出功能，支持多种内容形式。
- **`pywebio.session`**：提供会话控制功能，包括环境配置和会话信息获取。
- **`pywebio.pin`**：支持持久化输入，表单提交后不会消失。
- **`pywebio.platform`**：支持通过 WebSocket 或 HTTP 协议部署应用，提供静态文件服务和 SEO 配置。

### 3. 新功能与改进（v1.8.0）
#### 高亮功能
- 新增 `datatable widget`，支持表格数据展示。
- 提升基于 HTTP 的后端（如 Flask 和 Django）的消息传输可靠性。
- 新增对 FastAPI 和 Starlette 的支持。
- 新增 Uzbek 语言对 UI 标签的支持。
- 新增 `put_file_upload()` 上传控件。

#### 不兼容更改
- 使用上下文管理器时，上下文内的输出内容在上下文退出后会被移除。

#### 其他改进
- 新增 `WPA` 支持，允许以本地图标形式运行应用。
- 新增类型提示，优化日志输出。
- 修复文件上传路径解析等问题。

### 4. 其他版本更新
- **v1.2**：支持 WebSocket 连接重试、静态文件部署、文档国际化等。
- **v1.1**：新增安全支持（防 XSS 攻击）、UI 国际化、SEO 配置、CDN 支持等。
- **v1.0**：新增网格布局、弹窗、链接、加载条等 UI 组件，支持远程访问服务。

### 5. 适用场景
- 快速开发交互式 Web 应用。
- 在线教育、数据分析、数据可视化等场景。
- 需要最小化代码量的 Web 开发项目。

PyWebIO 通过简洁的 API 和灵活的功能组合，为开发者提供了一种高效的 Web 应用开发方式。