PyWebIO v0.3.0 使用手册

语言	格式	评分
中文（简体）	.pdf	3
摘要
《PyWebIO v0.3.0 使用手册》详细介绍了PyWebIO的功能和使用方法。文档涵盖了PyWebIO的安装、快速入门、详细文档、示例和注意事项。PyWebIO支持在普通脚本中调用和使用start_server()启动Web服务两种模式，支持多线程环境下的并发处理。文档还介绍了PyWebIO的事件回调机制，允许用户在前端控件被点击时执行回调函数。此外，PyWebIO采用服务器-客户端架构，支持WebSocket和HTTP通信协议，并提供了与常见Web框架（如Tornado和Flask）的集成方法。文档还详细说明了PyWebIO的静态资源托管、前后端路径约定以及Nginx的WebSocket配置示例。
AI总结
# PyWebIO v0.3.0 使用手册总结 ## 核心功能 ### 1. 自动滚动 - 默认情况下，PyWebIO 输出完毕后会自动滚动到页面底部。 - 在调用输入函数时，会滚动到表单处。 - 可通过 `set_auto_scroll_bottom(False)` 关闭自动滚动。 ### 2. 模式 #### Server Mode - 需要提供任务函数为每个用户提供服务。 - 任务函数外不能调用 PyWebIO 的交互函数。 - 在调用 `start_server()` 之前，不能调用交互函数。 #### Script Mode - 可在任何位置调用 PyWebIO 的交互函数。 - 如果用户在会话结束前关闭浏览器，后续调用交互函数会引发 `SessionException`。 ### 3. 并发支持 - PyWebIO 支持多线程环境。 - 在 Server Mode 下，若新线程使用交互函数，需手动注册线程 (`register_thread(thread)` )。 ### 4. 输出功能 - 文件输出：`put_file()` 可输出文件内容。 - 组合输出：`put_table()` 支持嵌入其他输出函数（如 `put_html`、`put_text`）作为单元格内容。 ### 5. 事件回调 - 支持用户交互（如点击按钮）触发回调函数，实现类似 GUI 程序的交互逻辑。 - 示例：通过 `put_buttons` 或 `put_actions` 定义按钮，并绑定回调函数。 ### 6. 服务器-客户端通信协议 - PyWebIO 采用服务器-客户端架构，支持 WebSocket 和 HTTP 通信。 - WebSocket：用于实时通信，服务器发送指令 (`command`)，客户端发送事件 (`event`)。 - HTTP：客户端通过 GET 请求轮询指令，POST 提交数据。 ### 7. 注意事项 - 静态资源托管：建议使用反向代理（如 Nginx）或 CDN 托管静态文件。 - 路径约定：前端页面和后端接口需通过 `pywebio_apiUrl` 参数约定路径。 ### 8. 第三方库支持 - 支持与第三方库（如 Bokeh、Plotly）结合进行数据可视化。 - 支持代码编辑器（如 CodeMirror）的常用配置选项。 ### 9. 示例 Demo - BMI 计算：演示基本输入输出功能。 - 数据可视化：展示如何使用第三方库进行图表绘制。 - 聊天室：基于协程实现的实时交互应用。 ### 10. 更新日志 - 新功能： - 支持输出 Bokeh 图表。 - 添加 `session.get_info()` 获取会话信息。 - 改进： - 前端代码迁移至 TypeScript。 - 输出函数支持更灵活的锚点控制。 - 提升会话管理的稳定性。 ## 总结 PyWebIO 是一个功能强大的 Web 编程框架，支持多种交互模式、并发处理、丰富的输出功能以及第三方库集成。适用于开发交互式 Web 应用，如数据可视化、实时聊天室等。通过合理配置和使用其核心功能，开发者可以高效地构建动态 Web 应用程序。