PyWebIO v1.3.1 使用手册

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

摘要

《PyWebIO v1.3.1 使用手册》详细介绍了PyWebIO的功能与使用方法。PyWebIO是一个通过简单的Python代码实现Web交互的框架，允许开发者无需HTML和JavaScript知识即可快速构建Web应用。其核心特性包括命令式API、同步输入方式、支持多种Web框架整合以及WebSocket和HTTP通信协议。此外，文档详细列出了新版本的功能更新，包括对FastAPI和Starlette的支持、文件上传改进、错误修复以及新功能的引入。

AI总结

《PyWebIO v1.3.1 使用手册》总结

### 核心功能与特点
1. **简化用户交互**
PyWebIO 提供了一系列命令式的交互函数，通过最少的代码即可完成与用户的交互。开发者可以像编写终端脚本一样，使用 `input` 和 `put_xxx` 函数进行交互，无需掌握 HTML 和 JavaScript 知识。

2. **功能模块**
- **输入函数**：包括文本输入、密码输入、下拉选择、复选框、单选按钮、多行文本输入、文件上传等，均在浏览器上以表单形式呈现。
示例：

     age = input("How old are you?", type=NUMBER)

- **输出函数**：支持向浏览器输出文本、图片、表格等内容，例如 `put_text`、`put_image`、`put_table` 等。

3. **服务器与客户端通信**
- 支持 WebSocket 和 HTTP 两种通信方式。
- **WebSocket**：适用于 Tornado 或 aiohttp 后端，实时通信高效。
- **HTTP**：适用于 Flask 或 Django 后端，通过轮询和提交表单进行交互。

### 应用部署与支持
1. **框架集成**
PyWebIO 支持与主流 Web 框架（如 Flask、Django、Tornado、aiohttp、FastAPI/Starlette）集成，方便将其整合到现有 Web 服务中。

2. **启动服务**
通过 `start_server()` 函数即可部署 PyWebIO 应用，支持设置端口、调试模式、跨域支持等参数。例如：

   start_server(bmi, port=80)

3. **SEO 设置**
可以通过 `seo()` 函数或任务函数的注释设置应用的标题和描述，方便搜索引擎索引。

### 更新日志与改进
1. **新增功能**
- 支持跨域访问。
- 添加文件上传大小限制、上传进度显示。
- 输出函数支持上下文管理器。
- 支持 Bokeh 数据可视化图表输出。

2. **Bug 修复**
- 修复 WebSocket 连接断开时的错误提示。
- 修复大文件上传错误。
- 修复表格样式问题。

### 其他特性
- **会话管理**：支持通过 `session` 模块获取会话信息，清理未完成的调用。
- **进度显示**：文件上传时提供进度条。
- **兼容性**：支持基于线程和协程的执行模型，适合快速构建对 UI 要求不高的应用。

### 总结
PyWebIO 是一个高效、简洁的 Python 交互式 Web 框架，通过命令式的 API.Minimize 代码量，提供良好的用户体验。适合快速开发简单的 Web 应用或基于浏览器的 GUI 应用，并支持与主流 Web 框架集成。其最新版本 1.3.1 在功能、性能和兼容性上均有显著改进。