PyWebIO v1.2.3 使用手册

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

摘要

本文档详细介绍了PyWebIO v1.2.3的使用方法。PyWebIO是一个支持通过命令式API在浏览器上实现交互的Python库，允许开发者像编写终端脚本一样简单地构建Web应用。其输入函数包括文本输入、密码输入、下拉选择、复选框、单选按钮等。PyWebIO支持与多种Web框架（如Flask、Django、Tornado、aiohttp）集成，并提供了WebSocket和HTTP两种通信方式。同时，PyWebIO支持数据可视化，能够整合第三方库如Bokeh和Plotly。其版本更新包括改进的会话控制、新增的输出函数和UI优化。

AI总结

《PyWebIO v1.2.3 使用手册》简要总结如下：

---

### **概述**
PyWebIO 是一个 Python 库，允许开发者通过编写简单的代码在浏览器中实现与用户的交互。它将浏览器变为一个“富文本终端”，无需 HTML 和 JavaScript 知识，便可快速构建简单的 Web 应用或基于浏览器的 GUI 应用，特别适合对 UI 要求不高的场景。

---

### **核心功能**
1. **输入功能**
PyWebIO 提供多种输入函数，用户可以通过浏览器表单输入数据，包括：
- 文本输入、密码输入、下拉选择、复选框、单选按钮、多行文本输入和文件上传。
- 示例：

     age = input("How old are you?", type=NUMBER)
     password = input("Input password", type=PASSWORD)
     gift = select('Which gift you want?', ['keyboard', 'ipad'])

2. **输出功能**
支持通过命令式 API 在浏览器中输出内容，包括文本、图片、表格等，例如：
- `put_text()` 输出文本
- `put_image()` 输出图片
- `put_table()` 输出表格
提供布局控制函数（如 `put_row()`、`put_column()`）和锚点功能，用于动态更新或移除内容。

3. **会话管理**
支持 `start_server()` 启动服务，并提供会话控制函数（如 `defer_call()`、`hold()`）来管理会话流程。

4. **数据可视化**
支持与第三方库（如 Bokeh、Plotly、PyECharts）集成，实现数据可视化。

5. **部署与集成**
- 支持与主流 Web 框架（Flask、Django、Tornado、aiohttp）集成。
- 提供 `PyInstaller` 打包工具，将 PyWebIO 应用打包为独立可执行文件。

---

### **特性**
- 使用同步方式获取输入，代码逻辑自然。
- 非声明式布局，布局方式简单高效。
- 支持基于线程和协程的执行模型。
- 代码侵入性小，易于将旧脚本改造为 Web 服务。

---

### **发布说明**
v1.2.3 版本更新内容包括：
- 支持跨域通信。
- 优化会话关闭机制，清理未完成的 PyWebIO 调用。
-修复 `Session` 对象构造函数对 `functools.partial` 处理任务函数的识别问题。

---

### **总结**
PyWebIO 通过简洁的 API 和强大的功能，帮助开发者快速构建基于浏览器的交互式应用，适合快速开发和轻量级场景，尤其适合需要数据可视化和用户交互的应用。