PyWebIO v1.8.1 Documentation

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

摘要

文档介绍了PyWebIO v1.8.1的更新内容，包括新增功能如datatable widget、WPA支持、语言扩展、日志处理改进等，修复了内存泄漏等问题，并提供了详细的变更记录和配置说明。

AI总结

### PyWebIO v1.8.1 文档总结

#### PyWebIO 简介
PyWebIO 是一个用于在浏览器中实现交互式终端应用的 Python 库，通过提供丰富的输出函数（如 `put_text()`、`put_image()` 等），开发者可以轻松构建简单的 Web 应用或基于浏览器的 GUI 应用，而无需深入了解 HTML 和 JavaScript。

#### 主要特点
1. **同步输入输出**：使用同步方法获取输入，而非回调机制，简化了交互逻辑。
2. **非声明式布局**：提供简单的布局函数（如 `put_row()`、`put_column()`），实现高效的界面设计。
3. **多框架支持**：支持 Flask、Django、Tornado、aiohttp 和 FastAPI 等 Web 框架，便于集成到现有项目中。
4. **跨平台支持**：支持在移动设备上通过 WPA 协议以原生应用形式运行。
5. **丰富的输出功能**：包括弹窗、toast、可交互表格、进度条等多种输出形式。

---

#### v1.8 主要更新
1. **新增功能**
- 添加 `datatable` 组件，支持可靠的消息传输（基于 Flask 和 Django 后端）。
- 支持文件上传（`put_file_upload()`）和自定义样式（`style()`）。
- 增加 Uzbek 语言对 UI 标签的支持。
- 提供 `pyinstaller` 支持，可将 PyWebIO 应用打包为可执行文件。
- 新增 `put_info()`、`put_error()`、`put_warning()`、`put_success()` 等输出函数。

2. **不兼容更改**
- 使用 `put loading()` 作为上下文管理器时，上下文内的输出将在退出后一并清除。

3. **其他改进**
- 修复内存泄漏问题（#545）。
- 支持通过 `config(manifest)` 配置启动器，便于在移动设备上快速启动应用。

---

#### v1.8.1 更新
1. **修复问题**
- 修复文件上传参数解析错误。
- 修复 Python 3.6 下自动打开浏览器失败的问题。

2. **其他改进**
- 提供 `pyinstaller` 钩子，简化打包流程。
- 默认情况下生产环境不暴露堆栈跟踪信息（`debug=False`）。

---

#### 其他重要功能
1. **布局支持**
- 提供 `put_grid()`、`put_row()`、`put_column()` 等函数，支持自定义界面布局。
- 支持浮动式输入框和动态输入项值设置。

2. **安全性增强**
- 新增 `sanitize` 参数，防止 XSS 攻击，确保输出内容的安全性。

3. **国际化支持**
- 提供多语言支持，便于构建全球化应用。

4. **数据可视化**
- 支持第三方库（如 pyg2plot）进行数据可视化。

---

#### 安装与使用
- **安装**：通过 `pip` 安装稳定版或开发版。

  pip3 install -U pywebio
  pip3 install -U https://github.com/pywebio/PyWebIO/archive/dev-release.zip

- ** prerequisites**：需要 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 官方文档](https://pywebio.readthedocs.io/)
- [在线示例](https://play.pywebio.online/)
- [GitHub 仓库](https://github.com/pywebio/PyWebIO)

如需帮助或报告问题，可通过 GitHub 讨论区或问题跟踪器联系开发团队。