PyWebIO v1.5.2 Documentation

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

摘要

PyWebIO 是一个用于在浏览器中进行用户输入和输出的 Python 库，能够快速构建交互式应用。文档介绍了 PyWebIO 的新功能，包括支持 WebSocket 重连、静态文件服务、多任务应用部署以及与主流 Web 框架的整合。新版本引入了基于 Scope 的输出模型，增强了布局和样式支持，并提供了丰富的输出函数。文档还详细说明了安装方法和使用示例。

AI总结

### PyWebIO v1.5.2 文档总结

#### 概述
PyWebIO 是一个基于 WebSocket 的 Python 库，用于在浏览器中创建交互式终端应用，支持用户输入和输出操作，无需 HTML 和 JavaScript 知识。它适用于快速开发简单的 Web 应用或基于浏览器的 GUI 应用，支持与主流 Web 框架（如 Flask、Django、aiohttp 等）集成，并提供数据可视化功能。

---

#### 主要功能
1. **同步输入输出**：使用类似终端脚本的方式获取用户输入并输出内容。
2. **布局与样式**：支持网格、行、列布局，以及自定义样式。
3. **数据可视化**：支持使用第三方库（如 Plotly、pyecharts）进行数据可视化。
4. **多任务支持**：通过 `start_server()` 可启动多个应用，并使用 `go_app()` 实现任务间的跳转。
5. **WebSocket 集成**：支持断线重连、静态文件服务，并提供跨域支持。
6. **调试与日志**：支持调试模式，显示异常堆栈信息。

---

#### 新功能与更新

##### PyWebIO v1.5
1. **主题支持**：通过 `pywebio.config()` 配置主题，提供更好的视觉体验。
2. **弃用 `pywebio.output.output()`**：推荐使用 `pywebio.output.use_scope()` 替代。
3. **改进 Markdown 输出**：默认启用 `lstrip`，增强 Markdown 格式化能力。
4. **按钮状态支持**：支持禁用按钮状态，按钮值可为任意类型。
5. **滑块输入改进**：增加指示器显示当前值。
6. **兼容性优化**：支持最新 aiohttp (v3.8) 和 Heroku 环境。
7. **前端语言支持**：新增对俄语的前端标签和消息支持。

##### PyWebIO v1.2
1. **WebSocket 断线重连**：新增 `reconnect_timeout` 参数。
2. **部署功能**：支持从目录部署应用，提供 `path_deploy` 和 `path_deploy_http` 命令。
3. **上下文管理支持**：部分输出函数支持上下文管理。
4. **新输出函数**：新增 `put_info()`, `put_error()`, `put_warning()`, `put_success()` 等函数。
5. **静态文件服务**：新增 `static_dir` 参数以服务静态文件。

##### PyWebIO v1.0
1. **多任务支持**：支持通过 `start_server()` 启动多个应用，并使用 `go_app()` 实现任务跳转。
2. **基于 Scope 的输出模型**：弃用基于锚点的输出控制模型。
3. **布局支持**：新增 `put_grid()`, `put_row()`, `put_column()` 等布局函数。
4. **新输出函数**：新增 `toast()`, `popup()`, `put_widget()`, `put_collapse()`, `put_link()`, `put_scrollable()`, `put_loading()`, `put_processbar()` 等函数。
5. **前端改进**：输入框采用浮动式设计，异常日志记录优化。

---

#### 不兼容变化
1. **输出模型变更**：弃用基于锚点的输出控制模型。
2. **移除旧函数**：移除 `pywebio.output.set_title()`, `pywebio.output.set_auto_scroll_bottom()`, `pywebio.output.table_cell_buttons()` 等函数。
3. **输入限制**：文件上传大小限制和进度显示功能增强。

---

#### 安装
- 稳定版：`pip3 install -U pywebio`
- 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`

---

#### 集成与部署
1. **Web 框架集成**：支持 Flask、Django、aiohttp、Tornado 和 FastAPI 等框架。
2. **静态文件服务**：通过 `static_dir` 参数提供静态文件访问。
3. **路径部署**：使用 `path_deploy()` 和 `path_deploy_http()` 部署应用，支持通过 URL 参数 `reload` 重新加载应用。

---

#### 其他
1. **文档与示例**：所有文档和示例均提供英文版本。
2. **测试与 CI**：新增测试用例和 CI 工作流。
3. **支持与讨论**：通过 GitHub Discussions 和 Issues 提供帮助和支持。

如需进一步了解，请访问 [PyWebIO 官方文档](https://github.com/wang0618/PyWebIO)。