PyWebIO v1.2.2 Documentation

《PyWebIO v1.2.2 Documentation》文档内容总结如下： ### 概述 PyWebIO 是一个通过 imperative 函数获取用户输入和输出的工具，能够将浏览器转化为“富文本终端”，适用于构建简单的网页应用或基于浏览器的 GUI 应用。开发者无需掌握 HTML 和 JS 即可快速开发类似终端脚本的交互式应用，并可轻松集成到现有网页服务中。 --- ### 功能特点 1. **同步式交互**：通过同步方式获取输入，避免回调复杂性。 2. **非声明式布局**：界面布局简单高效，易于使用。 3. **集成能力强**：支持 Flask、Django、Tornado、aiohttp 等主流框架。 4. **异步与协程支持**：兼容 asyncio 和协程。 5. **数据可视化**：支持 plotly、pyecharts 等第三方库。 6. **跨域支持**：通过 `start_server`、`webio_view` 和 `webio_handle` 实现。 7. **SEO 支持**：可通过 `pywebio.platform.seo()` 设置 SEO 信息。 8. **国际化支持**：UI 提供多语言支持。 --- ### 安装 - **稳定版本**：`pip3 install -U pywebio` - **开发版本**：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` - **前置条件**：Python 3.5.2 或更高版本。 --- ### 功能更新与变更 #### v1.2.2 更新 - **跨域支持**：`start_server` 和 `webio_view` 增加跨域支持。 - **静态资源服务**：`start_server` 增加 `static_dir` 参数，用于 serves 静态文件。 - **会话管理**：会话关闭时清理更彻底，未完成的 PyWebIO 调用会抛出 `SessionClosedException`。 - **问题修复**：修复 `functools.partial` 处理任务函数的识别问题。 #### v1.2 更新（2021/3/18） - **重新连接支持**：通过 `reconnect_timeout` 参数实现 WebSocket 连接的重连。 - **部署功能**：添加 `path_deploy()`、`path_deploy_http()` 和 `pywebio-path-deploy` 命令以部署目录下的应用。 - **多语言文档**：文档和演示已支持英文版本。 - **上下文管理器**：部分输出函数支持上下文管理器。 - **静态资源服务**：`start_server` 增加 `static_dir` 参数。 #### v1.1 更新（2021/2/7） - **安全增强**：`put_html()` 和 `put_markdown()` 增加 `sanitize` 参数prevent XSS 攻击。 - **性能优化**：应用访问速度提升，减少探测请求。 - **兼容性变更**：移除 `disable_asyncio` 参数，弃用 `pywebio.session.data()`，使用 `pywebio.session.local` 替代。 #### v0.2 更新（2020/4/30） - **框架集成**：支持与 Django 和 aiohttp 整合。 - **数据可视化**：支持 plotly、pyecharts 等库。 - **会话实现**：支持基于线程和协程的会话。 - **新函数**：添加 `defer_call()`、`hold()` 会话控制函数及 `put_image()` 输出函数。 --- ### 使用示例 一个简单的 BMI 计算脚本示例： ```python from pywebio.input import input, FLOAT height = input("请输入你的身高（厘米）", type=FLOAT) weight = input("请输入你的体重（千克）", type=FLOAT) bmi = weight / (height / 100) ** 2 ``` --- ### 相关资源 1. **技术支持**： - GitHub 讨论区：[https://github.com/wang0618/PyWebIO/discussions](https://github.com/wang0618/PyWebIO/discussions) - GitHub 问题报告：[https://github.com/wang0618/pywebio/issues](https://github.com/wang0618/pywebio/issues) 2. **文档与演示**： - 更多功能说明请参考完整文档。 - 演示案例包括数据可视化、代码示例等。