PyWebIO v1.6.1 Documentation

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

摘要

PyWebIO 是一个用于在浏览器上进行用户输入和输出的强大Python库，支持构建简单的Web应用或基于浏览器的GUI应用程序。文档详细介绍了PyWebIO的功能，包括使用同步方法而非回调方法获取输入、非声明式布局以及支持现有Web框架的集成。版本更新部分介绍了新功能和改进，例如支持多任务启动、添加布局支持、改进文件上传功能以及修复已知问题。

AI总结

PyWebIO 是一个基于 WebSocket 的 Python 库，用于快速开发交互式 Web 应用程序。以下是对其文档内容的总结：

---

### **PyWebIO 特性与功能**
1. **核心功能**：
- 提供丰富的输出函数，如 `put_text`, `put_buttons`, `put_link` 等，方便在浏览器中显示内容。
- 支持用户输入获取，采用同步方式而非回调机制，简化交互逻辑。
- 支持非声明式布局，简单高效，适合快速开发。

2. **主要功能模块**：
- **多任务支持**：通过 `start_server()` 可启动单个或多个应用程序，并支持任务间的跳转（使用 `go_app()` 或 `put_link()`）。
- **数据可视化**：集成第三方库（如 `pyg2plot`）实现数据可视化。
- **部署与集成**：支持将 PyWebIO 应用部署为独立服务，或与现有 Web 框架（如 Flask、Django、Tornado、aiohttp、FastAPI）集成。

3. **版本更新亮点**：
- **v1.6**：
- 新增 `pin.pin.on_change()` 事件监听功能。
- 支持波斯语标签，优化选择组件（`put_select`）样式。
- 修复滑块组件（`put_slider`）值同步问题。
- **v1.5**：
- 引入主题支持，提升用户体验。
- 优化索引页面，改进多文件上传功能。
- **v1.0**：
- 新增多任务支持，支持任务间跳转。
- 引入布局函数（`put_grid`, `put_row`, `put_column`）和自定义样式（`style()`）。
- 新增 `toast`, `popup`, `put_processbar` 等输出函数。

4. **其他功能**：
- 支持异步编程（`asyncio` 和协程）。
- 提供静态文件服务（`static_dir`）。
- 支持文件上传和下载，可限制文件大小并显示上传进度。

---

### **安装与部署**
- **安装**：
- 稳定版：`pip3 install -U pywebio`
- 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- **部署**：
- 使用 `path_deploy()` 部署目录中的应用，支持通过 URL 访问不同文件。
- 支持通过命令行工具 `pywebio-path-deploy` 启动服务。

---

### **主要改进与修复**
- **v1.6.1**：
- 修复 `put_processbar()` 在名称含空格时的显示问题。
- 解决 `put_select()` 被 `put_tabs()` 隐藏的问题。
- **v1.5**：
- 修复页面宽度超过屏幕的问题。
- 解决 `put_buttons()` 在按钮值相同情况下的显示问题。
- **v1.0**：
- 移除基于锚点的输出控制模型，改用基于 Scope 的模型。
- 移除部分旧函数（如 `pywebio.output.output()`），推荐使用 `use_scope()`。

---

### **示例**
- **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}")

---

### **讨论与支持**
- **问题反馈**：通过 [GitHub Issues](https://github.com/wang0618/pywebio/issues) 提交问题。
- **讨论交流**：加入 [GitHub Discussions](https://github.com/wang0618/PyWebIO/discussions) 进行讨论。

---

PyWebIO 适合快速开发交互式 Web 应用，尤其适合需要简单交互但不涉及复杂 UI 的场景。