PyWebIO v1.5.1 Documentation

• 语言: 英语
• 格式: .pdf
• 来源: pywebio.readthedocs.io

摘要

PyWebIO v1.5.1文档详细介绍了其功能和更新内容，包括 输入函数、输出函数、部署方式、WebSocket和HTTP通信协议、数据可视化支持，以及用户指南和发布说明。PyWebIO支持在Flask、Django、Tornado等框架中部署，并提供了异步和协程支持。文档还介绍了如何集成第三方可视化库如Bokeh，并提供了详细的API说明和示例。新版本修复了多项错误并新增了一些功能，如自动化会话保持和代码编辑器的全屏切换。

AI总结

以下是文档内容的中文总结：

---

### PyWebIO v1.5.1 Documentation 总结

#### 1. 版本更新说明
- **v1.5.1（2021/12/21）**
- 修复了多个错误，包括：
- 修复了启用远程访问时的“地址已在使用”错误。
- 修复了`pin.pin`对象的`setitem`错误。
- 修复了32-bit Windows上的`OverflowError`。
- 修复了远程访问调试模式下多进程的问题。
- 修复了cookbook样例错误。
- **v1.4（2021/10/4）**
- **新功能**：
- 自动持有会话。
- 支持为输出组件绑定`onclick`回调。
- 添加了`output_max_width`参数。
- 支持通过`Esc/F11`切换代码编辑区全屏模式。
- `pin_wait_change()`支持超时参数。
- 添加了`pywebio.config()`、`pywebio.output.put_button()`和`pywebio.pin.put_actions()`。
- **错误修复**：
- 修复了表单提交失败后的问题。
- 修复了代码编辑器刷新和模式自动加载的问题。
- 修复了`run_js()`返回`None`的问题。
- 修复了子输出失败导致整体输出崩溃的问题。
- **v1.0（2021/1/17）**
- 引入了`start_server`、`Scope`、`put_grid()`、`put_row()`、`put_column()`、`toast()`、`popup()`等功能。

#### 2. 功能概述
PyWebIO是一个通过Python代码在浏览器中实现交互的工具，类似于终端编程，但将浏览器作为“富文本终端”。其特点包括：
- 同步编程模式，避免回调地狱。
- 非声明式布局，简单高效。
- 支持与主流Web框架（如Flask、Django、Tornado等）集成。
- 支持`asyncio`和协程。
- 支持第三方数据可视化库（如Bokeh）。

#### 3. 用户指南
- **输入与输出**：
- 使用`pywebio.input`模块的函数（如`input()`、`select()`、`file_upload()`）获取用户输入。
- 使用`put_text()`、`put_image()`、`put_table()`等函数向浏览器输出内容。
- 支持点击事件和布局功能。
- **动态交互**：
- 支持通过`run_js()`和`eval_js()`执行JavaScript代码。
- 提供`console`模块用于在浏览器中显示日志。

#### 4. 部署方式
- **目录部署**：通过`path_deploy()`或`path_deploy_http()`部署目录中的Python文件。
- **与Web框架集成**：支持Flask、Django、Tornado、aiohttp、FastAPI/Starlette等框架。
- **其他部署方式**：包括脚本模式和服务器模式。

#### 5. 协议说明
- **WebSocket通信**：用于Tornado或aiohttp后端，实时交互。
- **HTTP通信**：用于Flask或Django后端，通过轮询和提交表单实现交互。
- **命令与事件**：服务器向客户端发送命令，客户端向服务器发送事件，实现双向通信。

#### 6. 高级主题
- **数据可视化**：支持Bokeh库，用于生成交互式图表。
- **PyInstaller支持**：提供将PyWebIO应用打包为独立可执行文件的方法。

---

以上是文档的核心内容和关键信息的总结，旨在提供清晰、简洁的概述，同时保留重要细节。