PyWebIO v1.5.2 使用手册

• 语言: 中文（简体）
• 格式: .epub
• 来源: pywebio.readthedocs.io

摘要

《PyWebIO v1.5.2 使用手册》介绍了PyWebIO的核心功能和使用方法。PyWebIO是一款支持快速构建交互式Web应用的Python库，通过命令式API实现浏览器交互，类似于终端脚本编写方式。文档详细阐述了输入函数和输出函数的使用方法，其中输入函数包括文本、数字等类型的输入，并支持表单显示；输出函数可显示文本、图片、表格等内容。此外，PyWebIO支持与多个Web框架（如Flask、Django）整合，并提供了基于WebSocket和HTTP的通信协议。高级特性包括协程支持、数据可视化以及将应用打包为可执行文件。文档还提供了部署方式介绍，包括通过path_deploy()函数部署目录应用，以及支持远程访问和静态文件托管。

AI总结

《PyWebIO v1.5.2 使用手册》总结

PyWebIO是一款通过Python代码快速构建Web应用的工具，允许开发者像编写终端脚本一样使用命令式API在浏览器上实现交互。以下是其核心内容和关键信息总结：

1. 核心特点
- 命令式API：通过简单的函数调用实现浏览器交互，类似终端脚本编写。
- 支持输出文本、图片、表格等内容，并获取用户输入，提供良好的用户体验。
- 支持与Flask、Django、Tornado等Web框架整合，无需额外学习HTML和JS。

2. 输入与输出
- 输入函数（`pywebio.input`模块）如`input()`、`select()`等，阻塞式获取用户输入，表单提交前函数不返回。
- 输出函数（`pywebio.output`模块）如`put_text()`、`put_image()`等，输出内容到浏览器。
- 支持布局、点击事件、动画效果等，提升交互体验。

3. 部署与配置
- 支持多种部署方式：通过`start_server()`启动服务，或使用`path_deploy()`从目录加载应用。
- 通信协议支持WebSocket（默认）和HTTP，适用于不同Web框架。
- 提供远程访问支持，通过`remote_access=True`开启，获取临时公网访问地址。

4. 高级功能
- 支持将应用打包为独立可执行文件，便于分发。
- 整合第三方库（如Plotly、pyecharts）进行数据可视化。
- 支持基于协程的会话和并发处理，适合复杂应用场景。

5. 安装与使用
- 安装命令：`pip3 install -U pywebio`（stable版），或通过开发版安装。
- Hello, world示例：计算BMI指数，展示基本输入输出功能。

6. 注意事项
- 在Server模式下，输入输出函数仅能在任务函数上下文中调用。
- 会话关闭时，清理资源，未完成调用将抛出`SessionClosedException`。

PyWebIO简化了Web开发流程，适合快速构建UI需求不高的应用，或整合到现有Web项目中。