PyWebIO v0.3.0 使用手册

# 《PyWebIO v0.3.0 使用手册》总结 ## 概述 PyWebIO 是一个用于在浏览器上获取输入和进行输出的工具库，能够快速将终端交互脚本服务化，并整合到现有 Web 服务中。其特点包括代码侵入性低、支持多用户与并发、集成主流 Web 框架（Flask、Django、Tornado、aiohttp）等。 ## 特点 1. **同步交互**：采用同步方式获取输入，无需保存状态，使用更便捷。 2. **低侵入性**：对旧脚本代码修改少，主要针对输入输出逻辑。 3. **多用户与并发**：支持多用户同时访问和并发请求处理。 4. **框架集成**：支持与多个 Web 框架整合，无需编写 HTML 和 JS 代码。 5. **灵活执行模型**：同时支持基于线程和协程的执行模型。 ## 安装 - **PyPi 安装**：`pip3 install -U pywebio` - **源码安装**：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` - **系统要求**：Python 3.5.2 及以上版本。 ## 版本更新（0.3.0） ### 新增功能 1. **输出功能**： - 增加了 `put_table()` 支持跨行/列单元格。 - 输出函数支持指定锚点，若锚点已存在则替换内容。 - `scroll_to()` 增加 `position` 参数，精细化控制滚动位置。 2. **会话管理**： - Session 关闭时清理更彻底，未完成的 PyWebIO 调用将抛出 `SessionClosedException`。 3. **前端优化**： - 前端 JavaScript 代码迁移至 TypeScript。 - 增加动画效果提升用户体验。 - 连接断开时交互按钮报错提示更明确。 4. **平台支持**： - `start_server`、`webio_view` 和 `webio_handle` 增加跨域支持。 5. **数据可视化**： - 支持输出 Bokeh 数据可视化图表。 - 支持 Plotly 和 Pyecharts 等第三方库的数据可视化。 ### 功能改进 - `input_group()` 增加 `cancelable` 参数，允许用户取消输入。 - `actions()` 函数的 `button` 参数支持 `reset` 和 `cancel` 按钮类型。 - 新增 `session.get_info()` 获取会话相关信息。 - 新增会话控制函数 `defer_call()` 和 `hold()`。 ## 文档与配置 - 静态文件路径可通过 `python3 -c "import pywebio; print(pywebio.STATIC_PATH)"` 获取。 - 支持将静态文件复制到其他目录下，例如 `~/web`。 ## 集成与部署 - 将 PyWebIO 服务集成到现有 Web 框架，例如 Flask、Django 等，参考文档中详细说明。 - 支持通过配置文件将 PyWebIO 静态文件托管到指定目录，反向代理到指定端口（如 `localhost:5000`）。 ## 总结 PyWebIO v0.3.0 在功能、性能和用户体验方面均有显著提升，特别是在支持数据可视化、优化用户交互体验和增强多框架集成能力方面更为突出。