PyWebIO v1.7.0 Documentation

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

摘要

《PyWebIO v1.7.0 Documentation》主要介绍了PyWebIO的功能和使用方法，包括输入输出模块、会话管理、平台部署等核心内容。文档详细说明了如何通过PyWebIO实现与现有Web框架的集成，提供了丰富的API和功能，如输入处理、输出显示、布局管理、点击事件支持等。此外，文档还介绍了PyWebIO的高级功能，包括远程访问服务、日志记录、数据可视化支持以及与FastAPI和Starlette等框架的集成。文档还包括了版本更新日志和新功能介绍，如持久化输入支持、新的部署方式以及性能优化等。

AI总结

### PyWebIO v1.7.0 文档总结

#### 1. **概述**
PyWebIO 是一个用于快速开发基于浏览器的交互式 Web 应用的 Python 库。它通过 imperative API 提供简单易用的接口，使开发者能够像编写控制台程序一样开发 Web 应用，同时支持丰富的交互功能。

#### 2. **核心功能**
- **用户指南**
PyWebIO 的使用方式与传统 Web 开发不同，它通过阻塞式输入函数（如 `input()`）和输出函数（如 `put_text()`、`put_image()`、`put_table()`）实现交互。开发者只需编写 Python 代码即可完成用户界面的构建和交互操作。

- **输入模块 (`pywebio.input`)**
提供多种输入类型，如文本输入、数字输入、下拉选择等。输入函数为阻塞式，直到用户提交表单后才会返回结果。
- 新增 `pin` 模块，支持持久化输入，输入表单在提交后不会消失，可继续接收输入。

- **输出模块 (`pywebio.output`)**
支持将文本、图片、表格等内容输出到浏览器，并提供布局和样式控制功能。
- 新增 `put_tabs()` 和 `put_html()` 等函数，增强输出能力。

- **会话控制 (`pywebio.session`)**
提供对会话的更多控制，包括设置环境、获取用户信息（IP、语言、浏览器等）、本地存储和 JavaScript 执行功能。

- **平台支持 (`pywebio.platform`)**
支持通过 WebSocket 或 HTTP 协议部署应用，默认使用 WebSocket。
- 新增 `path_deploy()` 函数，支持从指定目录部署多个应用，并可通过 URL 访问不同文件。

#### 3. **高级功能**
- **集成现有 Web 框架**
PyWebIO 可与现有 Web 框架（如 Flask、Django、FastAPI）集成，共享后端逻辑。

- **协程支持**
提供基于协程的会话支持，适合高并发场景。

- **数据可视化**
通过 `pyg2plot` 等库实现数据可视化。

#### 4. **版本更新**
- **v1.7.0 新特性**
- 新增 `deploy()` 和 `pywebio-path-deploy` 命令，支持从指定目录部署应用。
- 支持通过 `reload` 参数在线热重载应用。
- 新增对 FastAPI 和 Starlette 的支持。
- 改进 `pin` 模块，支持更多交互操作。

- **其他改进**
- 修复了文件上传、图片输出、会话管理等常见问题。
- 提升应用性能和稳定性。

#### 5. **附录**
- **实用工具**
- `pywebio_battery`：提供快速开发的实用函数，如确认对话框、重定向输出、运行 Shell 命令等。

- **部署与调试**
- 支持通过 `pywebio-path-deploy` 命令启动服务器，并可通过 `--help` 查看详细参数说明。

总结：PyWebIO 通过简洁的 API 和丰富的功能，极大简化了 Web 应用的开发流程，特别适合需要快速实现交互式 Web 应用的场景。