PyWebIO v1.6.3 使用手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: pywebio.readthedocs.io

摘要

PyWebIO 是一个用于快速开发 Web 应用的 Python 库，支持通过编写 Python 代码实现交互式 Web 应用。文档详细介绍了 PyWebIO 的使用方法，包括与 Web 框架的集成、数据可视化支持、安全性改进以及部署方式。新版本增加了对 WebSocket 连接重连、静态文件托管、PyInstaller 打包支持等功能，并修复了多个已知问题。文档还提供了多种第三方库的集成示例，如 Bokeh 和 pyg2plot，帮助用户快速开发交互式应用。

AI总结

《PyWebIO v1.6.3 使用手册》总结：

### 概述
PyWebIO 是一个用于快速开发 Web 应用的 Python 库，通过命令式 API 实现前后端交互逻辑，支持文本、图片、表格等输出，以及表单输入等功能，适用于数据可视化、Web 应用开发等场景。

### 主要功能
1. **核心特性**：
- 通过 `put_text()`、`put_image()`、`put_table()` 等函数输出内容。
- 使用 `input()`、`select()`、`file_upload()` 等函数接收用户输入。
- 支持点击事件、布局管理，提供良好的用户体验。

2. **运行模式**：
- **Server 模式**：启动 Web 服务，支持远程访问和调试模式。
- **Script 模式**：直接运行脚本，自动打开浏览器页面。

3. **第三方库支持**：
- **数据可视化**：支持 Bokeh、Plotly、Cutecharts 等库，通过 `put_html()` 输出图表。
- **打包应用**：使用 PyInstaller 将 PyWebIO 应用打包为可执行文件。

4. **安全性改进**：
- 在 `put_html()` 和 `put_markdown()` 中支持防 XSS 攻击功能。

### 更新内容
- **Bug 修复**：
- 修复表格样式、大文件上传、服务器启动等常见问题。
- 修复文件名溢出、图片加载错误等问题。
- 改进文件上传的安全性，避免路径误判。

- **新功能**：
- 支持 WebSocket 重连，增加 `reconnect_timeout` 参数。
- 添加 `put_info()`、`put_error()` 等消息提示函数。
- 支持静态文件托管，增加 `static_dir` 参数。
- 支持 UI 国际化和 SEO 优化。

### 使用场景
- 快速开发 Web 应用。
- 数据可视化：通过 Bokeh、Plotly 等库生成交互式图表。
- 持久化输入：使用 `pywebio.pin` 模块实现持久化交互。
- 跨域支持：通过配置 `start_server()` 实现跨域资源共享。

### 安装与部署
- 安装：`pip install pywebio`
- 打包：使用 PyInstaller 将应用打包为可执行文件。
- 部署：支持通过 `start_server()` 或 `path_deploy()` 部署为 Web 服务。

### 总结
PyWebIO 提供了简洁高效的 Web 开发体验，适合快速原型开发和小规模应用部署。其丰富的功能和良好的文档支持，使其成为 Python 开发者的一个强大工具。