PyWebIO v1.7.1 Documentation

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

摘要

文档详细介绍了PyWebIO v1.7.1的功能及其在版本更新中的变化，包括向后兼容性更改、功能增强和错误修复。PyWebIO提供了命令式的输入和输出功能，支持构建交互式Web应用，并整合了多种Web框架。新版本优化了远程访问服务，增强了输入和输出模块功能，并修复了多项bug，提升了安全性和用户体验。

AI总结

以下是对《PyWebIO v1.7.1 Documentation》的总结：

---

### **概述**
PyWebIO 是一个允许开发者通过同步方式获取用户输入并在浏览器中输出内容的库，能够将浏览器变成一个“富文本终端”，适用于快速构建简单的互动式Web应用或基于浏览器的GUI应用。开发者无需了解HTML和JS即可使用。

---

### **破坏性更改**
1. **移除参数**：
- Django和Flask中的`start_server()`函数移除了`disable_asyncio`参数。
- `pywebio.session.data()`被弃用，建议使用`pywebio.session.local`。
- 应用集成到Web框架后，访问地址发生变化。
- `put_scrollable()`函数的`max_height`参数被移除，改用`height`参数。

---

### **详细更改**
1. **新增功能**：
- `put_code()`增加`rows`参数，限制显示的最大行数。
- `put_scrollable()`新增`keep_bottom`参数。
- `put_markdown()`新增选项，用于配置Markdown解析。
- `put_code()`、`put_image()`、`put_link()`、`put_row()`、`put_grid()`增加HTML转义支持。
- `output()`的`reset()`、`append()`、`insert()`方法现在接受字符串内容。
- 修复`file_upload()`的`max_size`和`max_total_size`参数解析错误。
- 修复Python 3.6下自动打开浏览器失败的问题。

2. **优化与修复**：
- 提升访问速度，通信协议检测不再使用探测请求。
- 修复`file_upload()`的文件名溢出问题。
- 修复`put_image()`在使用PIL Image作为源时抛出的“未知文件扩展名”错误。

---

### **版本更新日志**
#### **v1.0 (2021/1/17)**
- 主要亮点：
- 增加`start_server()`和`go_app()`功能。
- 支持`put_grid()`、`put_row()`、`put_column()`、`style()`等布局和样式功能。
- 新增`toast()`、`popup()`、`put_widget()`、`put_collapse()`、`put_link()`、`put_scrollable()`、`put_loading()`、`put_processbar()`等UI组件。
- 支持JavaScript运行和Evaluate。
- 提供`console` UI。

#### **v0.3 (2020/5/13)**
- 主要亮点：
- 支持Bokeh图表。
- 新增`session.get_info()`和`output.put_table()`功能。
- 支持TypeScript。

#### **v1.4 (2021/10/4)**
- 主要亮点：
- 会话自动持久化。
- 支持将`onclick`回调绑定到任何输出组件。
- 新增远程访问服务。
- 添加`output_max_width`参数到`set_env()`。

#### **v1.2 (2021/3/18)**
- 主要亮点：
- 支持WebSocket重新连接。
- 新增`path_deploy()`、`path_deploy_http()`和`pywebio-path-deploy`命令。
- 提供英文文档和演示。
- 增加`put_info()`、`put_error()`、`put_warning()`、`put_success()`等输出函数。
- 支持PyInstaller打包。

#### **v1.1 (2021/2/7)**
- 主要亮点：
- 安全增强：`put_html()`和`put_markdown()`支持防XSS的`sanitize`参数。
- UI国际化支持。
- SEO支持。
- CDN支持，方便与Web框架集成。

#### **v1.3 (2021/6/12)**
- 主要亮点：
- 新增`pin`模块，提供持久输入支持。
- 新增远程访问服务。
- 增加`input_update()`和`onerchange`回调。
- 支持FastAPI和Starlette框架。
- UI组件增强，如`put_tabs()`、`put_buttons()`的`group`和`outline`参数。

---

### **功能特点**
1. **核心功能**：
- 通过同步方式实现用户输入和输出。
- 非声明式布局，简单高效。
- 支持将现有脚本快速转化为Web服务，无需复杂的修改。
- 集成到现有Web服务，支持Flask、Django、Tornado、aiohttp、FastAPI(Starlette)等框架。
- 支持异步和协程。

2. **UI组件**：
- 提供丰富的输出函数，包括`put_grid()`、`put_row()`、`put_column()`、`put_markdown()`、`put_scrollable()`等。

3. **数据可视化**：
- 支持第三方库（如Bokeh、pyg2plot）进行数据可视化。

---

### **总结**
PyWebIO通过简化的API和丰富的功能，使开发者能够快速构建交互式Web应用。其核心优势在于同步化输入输出、支持多种Web框架以及提供丰富的UI组件。常更新和修复确保了库的稳定性和功能的持续增强。