PyWebIO v1.6.1 Documentation

语言	格式	评分
英语	.pdf	3
摘要
PyWebIO 是一个支持通过简单的命令式函数在浏览器上获取用户输入和输出内容的库，使开发者能够像编写终端脚本一样快速构建 Web 应用。PyWebIO 1.6.1 版本包含多项改进和错误修复，例如修复了 WebSocket 连接中的自动重连问题、文件上传错误、表格样式问题，以及增强了服务器启动的稳定性。此外，该版本还添加了新的功能，如支持通过 context manager 使用输出函数、增强了数据可视化支持，并优化了与多种 Web 框架的集成。
AI总结
《PyWebIO v1.6.1 Documentation》总结本文档主要介绍了PyWebIO v1.6.1的功能更新、错误修复及相关技术细节，以下是核心内容的总结： --- ### 1. 版本更新与改进 #### v1.6.1版本 - 新增功能： - 增加`reconnect_timeout`参数，支持WebSocket连接重连。 - 添加`path_deploy()`、`path_deploy_http()`和`pywebio-path-deploy`命令，方便从目录部署应用。 - 所有文档和演示现在支持英文版本。 - 输出函数（如`put_info()`、`put_error()`）支持上下文管理。 - 增加数据可视化库`pyg2plot`的文档支持。 - `output()`的`reset()`、`append()`、`insert()`方法支持任意类型内容。 - 增加`static_dir`参数，用于静态文件服务。 - 错误修复： - 修复表格样式问题。 - 修复大文件上传错误。 - 修复启用`auto_open_webbrowser`时的服务器启动错误。 - 修复文件输入框文件名溢出问题。 - 修复`put_image()`使用PIL Image时的“未知文件扩展名”错误。 - 修复`file_upload()`返回的文件名路径解释问题。 #### v1.5.1版本 - 修复会话关闭后线程未正确终止的问题。 - 修复32位Windows上的溢出错误。 - 修复远程访问时地址已在用错误。 #### v1.4版本 - 自动持有会话。 - 支持将 onclick 回调绑定到任意输出组件。 #### v1.1版本 - 增加安全支持，`put_html()`和`put_markdown()`支持`sanitize`参数，防止XSS攻击。 - 支持UI国际化和SEO。 - 支持CDN，加速框架集成。 --- ### 2. 服务器与客户端通信协议 PyWebIO采用服务器-客户端架构，分为两种通信方式： - WebSocket通信（适用于Tornado或aiohttp后端）： - 服务器和客户端通过WebSocket连接交换JSON序列化消息。 - HTTP通信（适用于Flask或Django后端）： - 客户端通过HTTP GET轮询.Pull消息。 - 表单提交或按钮点击通过HTTP POST发送数据。通信消息分为两类： - Command：服务器向客户端发送的指令，格式为`{"command": "", "task_id": "", "spec": {}}`。 - Event：客户端向服务器发送的事件数据。 --- ### 3. 其他功能 - 数据获取： - `pywebio_battery.get_localstorage(key)`：获取浏览器本地存储值。 - `pywebio_battery.set_cookie()`和`get_cookie()`：设置和获取cookie。 - UI组件： - 支持`put_grid()`、`put_row()`、`put_column()`布局。 - 增加`toast()`、`popup()`、`put_widget()`等组件。 - JavaScript支持： - `run_js()`和`eval_js()`接口，支持在浏览器端执行JavaScript代码。 --- ### 4. 版本变更 - 向后兼容性更改： - 移除`disable_asyncio`参数（Django和Flask）。 - 废弃`pywebio.session.get_info()`，改用`pywebio.session.info`。 - 废弃`pywebio.session.data()`，改用`pywebio.session.local`。 --- ### 总结本文档详细记录了PyWebIO v1.6.1及其他版本的更新内容，包括功能新增、错误修复、通信协议细节以及版本变更。PyWebIO通过简单易用的API和多框架支持，帮助开发者快速构建交互式Web应用或浏览器端GUI应用。