PyWebIO v1.2.3 使用手册

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

摘要

PyWebIO是一款允许开发者通过编写Python代码在浏览器上实现交互的库，支持命令式API，如put_text、put_image、put_table等输出函数，以及input、select、file_upload等输入函数，帮助开发者轻松构建Web应用。文档详细介绍了PyWebIO的特性，包括支持与多种Web框架整合、基于线程和协程的会话模型、安全性增强、静态资源托管等。同时，文档还提供了安装指南、更新日志及示例代码，帮助用户快速上手并优化应用体验。

AI总结

《PyWebIO v1.2.3 使用手册》总结

### 一、概述
PyWebIO是一个可以将浏览器变成“富文本终端”的库，使开发者能够像编写终端脚本一样轻松构建Web应用或基于浏览器的GUI应用。它通过命令式API提供了快速的用户交互功能，支持与Flask、Django、Tornado、aiohttp等主流Web框架集成，并兼支持基于线程和协程的执行模型。

### 二、核心功能
1. **输入与输出**
- 提供了丰富的输入函数（如`input`、`select`、`file_upload`）和输出函数（如`put_text`、`put_image`、`put_table`），支持通过浏览器与用户进行交互。
- 输入函数是阻塞式的，类似Python内置的`input`函数。

2. **静态资源托管**
- 默认使用CDN静态资源，支持离线部署。通过设置`cdn=False`可以手动托管静态文件，并通过`static_dir`参数指定托管目录。

3. **会话管理**
- 默认基于线程的会话实现，支持WebSocket协议。若后端应用通过反向代理（如Nginx）运行，需特别配置WebSocket支持。

### 三、新功能与更新
1. **v1.2.3更新**
- 支持通过`start_server()`设置WebSocket连接重连超时。
- 提供`path_deploy()`等功能，支持从指定目录加载应用。
- 增加了`put_info()`、`put_error()`等输出函数，用于显示提示消息。

2. **v1.1更新**
- 添加安全性支持（如防XSS攻击）、UI国际化和SEO支持。
- 简化Web框架整合方式，仅需引入一条路由。
- 更改了访问地址格式，并弃用了`django`和`flask`框架的相关参数。

3. **v1.0及更早版本更新**
- 支持与Django、aiohttp等框架集成。
- 添加了数据可视化支持（如`plotly`、`pyecharts`）。
- 添加了会话控制函数（如`defer_call()`、`hold()`）和布局功能。

### 四、安装与使用
1. **安装**
- 稳定版：`pip3 install -U pywebio`
- 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- 系统要求：Python 3.5.2及以上。

2. **基本使用**
- 通过`start_server()`启动应用，支持自定义静态资源目录。
- 示例：使用PyWebIO计算BMI指数的脚本。

### 五、其他重要信息
- **安全提示**：不支持IE浏览器。
- **反向代理配置**：提供了Nginx的WebSocket配置示例，方便部署。
- **版本变更**：部分功能被弃用，如`pywebio.session.get_info()`替换为`pywebio.session.info`。

PyWebIO通过简洁的API和灵活的配置方式，帮助开发者快速构建浏览器交互应用，适合需要快速开发、对UI要求不高的场景。