PyWebIO v1.6.3 Documentation

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

摘要

PyWebIO 是一个基于浏览器的交互式开发框架，提供丰富的用户输入输出功能，支持 WebSocket 通信和多种布局方式。它允许开发者通过简单的 Python 代码快速构建交互式 Web 应用，无需深入学习 HTML 和 JavaScript。文档介绍了其最新版本 v1.6.3 的新功能，包括对 reconnect_timeout 参数的支持、文件上传功能的改进以及对多种 Web 框架（如 Flask、Django、Tornado 和 FastAPI）的集成支持。此外，还详细说明了安装方法和使用场景。

AI总结

《PyWebIO v1.6.3 文档》总结：

### 1. **概述**
PyWebIO 是一个基于浏览器的交互式开发框架，提供丰富的命令式 API，用于在浏览器中实现类似终端的交互式应用开发。它支持多种 Web 框架（如 Flask、Django、Tornado、aiohttp 和 FastAPI），适合快速开发无需复杂界面的交互式应用。

### 2. **核心功能**
- **基于线程的会话**：支持多任务函数和任务间的跳转。
- **数据可视化**：集成第三方库（如 pyg2plot）实现数据可视化。
- **文件上传与下载**：支持文件上传和下载，可限制文件大小并显示上传进度。
- **布局与样式**：支持布局组件（如 put_grid、put_row、put_column）和自定义样式。
- **事件与交互**：支持点击事件、弹窗、提示框等交互操作。
- **静态文件部署**：通过 `static_dir` 参数部署静态文件。

### 3. **版本更新**
#### v1.6.3
- **新增功能**：
- 支持路径部署（`path_deploy` 和 `path_deploy_http`）。
- 新增颜色输入类型。
- 支持 Persian 语言，默认标签国际化。
- 新增 `put_info`、`put_error`、`put_success`、`put_warning` 等输出函数。
- **修复问题**：
- 修复 `put_processbar` 在名称含空格时的显示问题。
- 修复 Plotly.js 版本错误。

#### v1.6.2
- **修复问题**：
- 修复 CDN 链接导致的 Plotly.js 版本错误。

#### v1.6.1
- **修复问题**：
- 修复 `put_processbar` 在名称含空格时的显示问题。
- 修复 `put_select` 被 `put_tabs` 隐藏的问题。

### 4. **安装**
- **稳定版**：`pip3 install -U pywebio`
- **开发版**：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- **依赖**：Python 3.5.2 或更高版本。

### 5. **用户指南**
- **命令式 API**：通过 `put_text`、`put_image`、`put_table` 等函数输出内容，或通过 `input`、`select`、`file_upload` 等函数获取用户输入。
- **布局与样式**：支持网格、行、列布局，并可通过 `style()` 自定义样式。
- **事件处理**：支持点击事件和交互式弹窗。

### 6. **框架支持**
- **Flask**：`pywebio.platform.flask.start_server()`
- **Django**：`pywebio.platform.django.start_server()`
- **Tornado**：`pywebio.platform.tornado.start_server()`
- **aiohttp**：`pywebio.platform.aiohttp.start_server()`
- **FastAPI/Starlette**：`pywebio.platform.fastapi.start_server()`

### 7. **部署**
- **路径部署**：通过 `path_deploy` 部署目录中的应用，默认提供索引页。
- **静态文件**：通过 `static_dir` 参数指定静态文件目录，支持通过 URL 访问静态资源。

### 8. **讨论与支持**
- **问题讨论**：[GitHub Discussions](https://github.com/wang0618/PyWebIO/discussions)
- **报告问题**：[GitHub Issues](https://github.com/wang0618/pywebio/issues)

总结：PyWebIO 通过简洁的命令式 API，帮助开发者快速构建交互式 Web 应用，适用于需要简单交互界面的场景。