PyWebIO v1.5.2 Documentation

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

摘要

文档详细记录了PyWebIO v1.5.2的发布说明，包括新功能、bug修复和向后兼容性的变更。主要更新内容包括修复多项bug，新增或优化了put_code()、put_scrollable()、put_markdown()等函数，并对服务器与客户端的通信协议进行了详细说明。文档还介绍了PyWebIO的核心功能，如支持异步和协程、与多种Web框架的集成等。

AI总结

《PyWebIO v1.5.2 Documentation》主要记录了PyWebIO框架的版本更新、功能改进和错误修复。以下是文档的核心内容总结：

---

### **1. 版本更新**
#### **v1.5.2 (2021/12/30)**
- **错误修复**：
- 修复会话关闭后线程未正确关闭的问题。
- 修复`put_button()`中无法使用协程回调的问题。

#### **v1.5.1 (2021/12/21)**
- **错误修复**：
- 修复`pin.pin`对象的`setitem`错误。
- 修复基于线程的会话未正确关闭的问题。
- 修复32位Windows上的`OverflowError`。
- 修复cookbook样例错误。
- 修复启用调试时Flask后端创建多个远程访问进程的问题。

#### **v1.4 (2021/10/4)**
- **新增功能**：
- 自动保持会话当需要时。
- 支持在任意输出组件上绑定`onclick`回调。
- **功能改进**：
- 迁移到开源远程访问服务。
- 添加`set_env()`的`output_max_width`参数。
- 支持通过`Esc/F11`切换代码区域全屏。
- `pin_wait_change()`支持超时参数。
- 新增`pywebio.config()`、`pywebio.output.put_button()`、`pywebio.pin.put_actions()`。
- 重新组织文档。
- **错误修复**：
- 修复表单在验证失败后无法提交的问题。
- 修复部分代码编辑器问题。
- 修复`run_js()`返回`None`的问题。
- 修复子输出失败导致整体输出崩溃的问题。

#### **v1.3 (2021/6/12)**
- **新增功能**：
- 新增`pin`模块，提供持久输入支持。
- `start_server()`新增远程访问服务。
- 输入函数支持`onchange`回调。
- 支持FastAPI和Starlette框架。
- **功能改进**：
- 输入模块新增`input_update()`和滑块输入。
- 输出模块新增标签页、(html兼容性改进等)。
- 会话模块新增promise支持。
- 平台模块新增远程访问服务和web部署参数。
- **错误修复**：
-修复表格样式和大文件上传问题。
-修复服务器启动和图片加载错误。

#### **v1.2 (2021/3/18)**
- **新增功能**：
- 支持WebSocket重连。
- 新增部署命令`path_deploy()`和`pywebio-path-deploy`。
- 文档和演示支持英文版本。
- 输出函数支持上下文管理器。
- 新增工具函数`pywebio.utils.pyinstaller_datas()`。
- **功能改进**：
- 输入模块新增`put_info()`、`put_error()`等函数。
- 输出模块新增静态文件服务参数。

#### **v1.1 (2021/2/7)**
- **新增功能**：
- 安全支持：`put_html()`和`put_markdown()`新增防XSS参数。
- 支持UI国际化和SEO。
- 提升访问速度，优化通信协议。
- 支持CDN以便于Web框架集成。
- **错误修复**：
- 修复文件上传和图片加载问题。

#### **v1.0 (2021/1/17)**
- **核心功能**：
- 支持`Flask`、`Django`、`Tornado`、`aiohttp`和`FastAPI`框架。
- 支持`asyncio`和协程。
- 集成数据可视化库。
- 提供`put_grid()`、`put_row()`、`put_column()`等布局功能。
- 支持JavaScript交互（`run_js()`、`eval_js()`）。

---

### **2. 功能概述**
- **核心特点**：
- 使用同步代替回调来获取输入。
- 非声明性布局，简单高效。
- 提供丰富的组件（如`toast()`、`popup()`、`put_widget()`等）。
- 支持与现有Web服务集成。
- 提供数据可视化支持。

- **技术实现**：
- 使用服务器-客户端架构，通过WebSocket或HTTP通信。
- WebSocket适用于Tornado和aiohttp，HTTP适用于Flask和Django。
- 客户端通过定期轮询或事件提交数据。

---

### **3._backward-incompatible changes**
- 删除`start_server()`的`disable_asyncio`参数。
- 废弃`pywebio.session.data()`，使用`pywebio.session.local`代替。
- 移除`put_scrollable()`的`max_height`参数，改用`height`。

---

### **4. 其他**
- 文档提供了详细的功能说明、错误修复记录和使用示例。
-<|reserved_special_token_21|>