PyWebIO v1.8.1 Documentation

以下是对《PyWebIO v1.8.1 Documentation》的中文总结： --- ### PyWebIO 简介 PyWebIO 是一个支持通过简单的方式构建 web 应用或基于浏览器的 GUI 应用的库。开发者可以像编写终端脚本一样编写代码，无需了解 HTML 和 JS。它适合快速构建不需要复杂用户界面的交互式应用。 ### 主要特点 1. 使用同步代替回调方式获取输入，代码简单易写。 2. 非声明式布局，支持基于线程或协程的会话实现。 3. 支持整合至现有 web 服务（如 Flask、Django、Tornado、aiohttp 和 FastAPI）。 4. 支持数据可视化（可与 plotly、pyecharts 等第三方库配合使用）。 5. 提供丰富的输出函数，支持将浏览器变为“富文本终端”。 --- ### 安装与使用 - **稳定版本**：`pip3 install -U pywebio` - **开发版本**：`pip3 install -U https://github.com/pywebio/PyWebIO/archive/dev-release.zip` - **示例脚本**：提供了一个计算 BMI 的简单脚本示例。 --- ### 版本更新亮点 #### **v1.8 (2023/4/10)** - **新功能**： - 添加 `put_datatable()` widget。 - 支持通过 `HTTP` 后端（Flask 和 Django）实现可靠的消息传输。 - 添加文件上传功能 `put_file_upload()`。 - 支持将 PyWebIO 应用作为本地应用在移动设备上启动（通过 WPA 和 manifest 配置）。 - 添加了 Uzbek 语言支持。 - 为所有公共函数添加类型提示。 - 支持使用 `pyinstaller` 将应用打包为可执行文件。 - **变破坏性改动**： - 使用 `put_loading()` 上下文管理器时，退出上下文块后会清理输出内容。 - **错误修复**： - 修复会话关闭后可能导致的内存泄漏问题。 - **性能优化**： - 默认在生产环境下隐藏 traceback。 #### **v1.8.1 (2023/4/16)** - **主要内容**：无具体更新内容列出，主要为 v1.8 的补充。 --- ### 高级主题 1. **多应用支持**：通过 `start_server()` 可启动多个应用，并支持通过 `put_link()` 或 `pywebio.session.go_app()` 切换应用。 2. **与 Web 框架整合**：PyWebIO 应用可整合到现有 Web 项目中，共享 Web 框架。 3. **SEO 支持**：通过 `pywebio.platform.seo()` 或函数 docstring 设置 SEO 信息。 4. **数据可视化**：支持使用第三方库如 pyg2plot 进行数据可视化。 --- ### 其他功能与配置 1. **配置选项**： - 通过 `config()` 函数设置应用标题、描述、主题等。 - 支持注入 JavaScript 和 CSS 文件。 - 支持 Web 应用 manifest 配置，将应用添加到移动设备主屏幕。 2. **输出与输入**： - 添加了 `put_info()`、`put_error()` 等快捷输出函数。 - 支持 Markdown 和 HTML 输出，并提供 XSS 防护选项。 --- ### 社区与支持 - **讨论与支持**：在 GitHub Discussions 上发起讨论。 - **报告问题**：通过 GitHub Issues 提交 bugs。 --- ### 总结 PyWebIO v1.8.x 版本在功能、性能和用户体验方面均有显著提升，适合开发者快速构建交互式 Web 应用或基于浏览器的 GUI 应用，尤其适合数据可视化和简单交互场景。