PyWebIO v1.5.1 Documentation

以下是文档内容的中文总结： --- ### 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应用打包为独立可执行文件的方法。 --- 以上是文档的核心内容和关键信息的总结，旨在提供清晰、简洁的概述，同时保留重要细节。