PyWebIO v1.5.2 使用手册

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

摘要

PyWebIO是一个用于在浏览器上进行交互式编程的Python库，允许开发者通过编写Python代码实现用户输入和输出。它提供了丰富的API，支持文本、图片、表格等多种内容的输出，并能接收用户的输入。PyWebIO还支持与主流Web框架（如Flask、Django、FastAPI等）集成，适合快速构建对UI要求不高的Web应用。文档详细介绍了其基本用法、高级特性（如数据可视化、静态文件托管）、与第三方库的集成以及打包应用的功能。

AI总结

《PyWebIO v1.5.2 使用手册》总结如下：

### 核心功能
1. **基于Python的Web交互开发**
PyWebIO允许开发者通过编写Python代码实现Web应用的所有逻辑，无需前端知识。开发者可以像编写终端程序一样，通过命令式API在浏览器上实现输入输出交互。

2. **主要功能**
- **输入函数**：提供`input()`、`select()`、`file_upload()`等阻塞式输入函数，用于获取用户输入。
- **输出函数**：支持`put_text()`、`put_image()`、`put_table()`等输出函数，可展示文本、图片、表格等内容。
- **交互支持**：支持点击事件、表单布局等交互功能，提升用户体验。
- **数据可视化**：支持通过Bokeh等第三方库进行数据可视化。

3. **新功能亮点**
- **静态文件托管**：通过`static_dir`参数支持托管静态文件。
- **WebSocket重连支持**：在`start_server()`中增加`reconnect_timeout`参数，支持WebSocket连接重连。
- **安全性增强**：在`put_html()`和`put_markdown()`中增加`sanitize`参数，防止XSS攻击。
- **文档优化**：提供英文文档和更多示例，方便开发者查阅。

4. **高级特性**
- **框架整合**：支持与Flask、Django、Tornado、aiohttp、FastAPI等主流Web框架集成。
- **协程支持**：支持基于协程的会话，提升应用性能。
- **打包部署**：通过PyInstaller可将应用打包为独立可执行文件，无需依赖Python环境。

### 安装与使用
- **安装**：

  pip3 install -U pywebio

或者安装开发版：

  pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip

- **系统要求**：Python 3.5.2及以上版本。

### 示例
以下是一个计算BMI指数的示例：

from pywebio.input import input, FLOAT
from pywebio.output import put_text

weight = input("请输入您的体重（公斤）：", type=FLOAT)
height = input("请输入您的身高（米）：", type=FLOAT)

bmi = weight / (height ** 2)
put_text(f"您的BMI指数为：{bmi:.2f}")

### 总结
PyWebIO是一个简洁高效的Web开发工具，适合快速开发对UI要求不高的Web应用或基于浏览器的GUI应用。其命令式API和对现有Web框架的兼容性，使得开发者可以轻松上手并高效完成开发任务。