PyWebIO v1.2.2 Documentation

语言	格式	评分
英语	.epub	3
摘要
PyWebIO是一个用于在浏览器中构建交互式Web应用的Python框架，提供了一系列命令式函数以获取用户输入和输出。它支持与多种Web框架（如Django、aiohttp）集成，并允许开发者通过简单的输入输出操作构建Web应用。文档介绍了PyWebIO的主要功能、安装方法以及最新版本（v1.2.2）的更新内容，包括新增的静态文件服务、跨域支持、会话控制函数、图像输出等功能，并提供了与Tornado和HTTP协议的通信方式。
AI总结
《PyWebIO v1.2.2 文档总结》 PyWebIO 是一个用于在浏览器中构建交互式 Web 应用的 Python 库，支持将终端脚本转化为 Web 服务。其主要特点包括： 1. 使用同步而非回调的方式获取用户输入 2. 基于命令式 API，简单高效 3. 支持与主流 Web 框架（如 Flask、Django、Tornado、aiohttp）集成 4. 支持异步编程和数据可视化 ### 主要功能更新 #### 1. 新功能亮点 - 框架整合：支持与 Django、aiohttp 等 Web 框架整合，可轻松将 PyWebIO 应用集成到现有项目中。 - 数据可视化：支持使用 plotly、pyecharts 等第三方库进行数据可视化。 - 会话控制：新增 defer_call()、hold() 等会话控制函数，提升应用交互能力。 - 输出功能：新增 put_image() 用于输出图像，支持通过 anchor 参数精准控制输出位置。 - 动画与 UI 优化：加入元素显示动画，提升用户体验。 - 部署支持：新增从目录部署应用的功能，支持 WebSocket 和 HTTP 通信协议。 #### 2. 模块更新 - UI 模块： - 页面底部新增 footer。 - 支持交互式按钮在连接断开时显示错误提示。 - 输入模块： - input group() 支持 cancelable 参数，允许用户取消输入。 - actions().button 支持 reset 和 cancel 按钮类型。 - 输出模块： - 输出函数支持通过 anchor 参数指定输出位置，若锚点已存在则替换内容。 - 新增 clear_range() 和 scroll_to() 函数，支持更精准的内容管理。 - 平台模块： - start_server()、webio_view()、webio_handler() 新增跨域支持和 static_dir 参数。 - 支持 Tornado 作为后端服务器，默认使用 WebSocket 协议通信。 #### 3. 版本更新亮点 - 1.2 版本： - 支持客户端在断开连接后重新连接，新增 reconnect_timeout 参数。 - 支持从目录部署应用，新增 path_deploy() 和 path_deploy_http() 函数。 - 新增 put_info()、put_error()、put_warning()、put_success() 等输出函数。 - 支持使用 pyinstaller 打包应用，新增 pywebio.utils.pyinstaller_datas() 函数。 - 新增 PyG2Plot 数据可视化文档。 - 1.1 版本： - 新增 static_dir 参数以支持静态文件服务。 - 修复 Session 对象构造函数无法识别 functools.partial 任务函数的问题。 - 1.0 版本： - 首次发布，奠定了基础功能。 #### 4. 使用指南 PyWebIO 的使用方式类似于终端脚本，通过 imperative API 提供输入输出功能，无需深入了解 HTML 和 JavaScript。开发者只需调用输入和输出函数即可完成交互。例如： ```python from pywebio.input import input, FLOAT from pywebio.output import put_text age = input("How old are you?", type=FLOAT) put_text(f"Your age is {age}") ``` ### 适用场景 PyWebIO 适合快速开发不需要复杂 UI 的 Web 应用，特别适合用于数据处理、计算工具等场景。 ### 安装 - 稳定版本：`pip3 install -U pywebio` - 开发版本：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` ### 文档资源 - 在线示例：文档中大部分代码示例提供在线预览链接。 - 讨论与支持：通过 GitHub Discussions 和 Issues 提交问题和反馈。 ### 总结 PyWebIO 通过简洁的 API 和灵活的框架支持，帮助开发者快速构建交互式 Web 应用，特别适合需要简单高效用户交互的场景。