PyWebIO v1.0.3 使用手册

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

摘要

《PyWebIO v1.0.3 使用手册》介绍了PyWebIO的功能和使用方法，允许开发者通过Python代码实现浏览器交互，类似于终端程序。PyWebIO支持两种模式：Server模式启动Web服务，适用于多用户访问；Script模式在任何位置调用交互函数。通信方式包括WebSocket和HTTP，适用于不同的Web框架。Additionally, it covers event handling, session management, and integration with third-party libraries for data visualization.

AI总结

# 《PyWebIO v1.0.3 使用手册》总结

## 一、概述
PyWebIO是一个让开发者像编写终端脚本一样构建Web应用的工具，支持在浏览器中通过Python代码实现用户交互。其特点包括：
- 使用简单，基于命令式API，类似终端交互。
- 支持快速构建不需要复杂UI的Web应用。
- 方便整合到现有Web服务，支持Flask、Django等框架。
- 支持同步编程方式，代码逻辑自然。

## 二、核心功能

### 1. 输入输出
- **输入函数**：通过`pywebio.input`模块提供，如`input()`、`select()`、`file_upload()`等，阻塞式调用，直到用户提交。
- **输出函数**：通过`pywebio.output`模块提供，如`put_text()`、`put_image()`、`put_table()`等，输出内容到浏览器。

### 2. 模式
- **Server模式**：
- 启动Web服务，通过`start_server()`函数指定任务函数。
- 适合持续提供服务，支持多任务函数和服务跳转。
- **Script模式**：
- 在任意位置调用交互函数。
- 会话结束后可能抛出`SessionException`。

### 3. 事件与回调
- 支持按钮点击等事件回调，使用`onclick`参数指定回调函数。
- 可以在任务函数末尾使用`pywebio.session.hold()`保持会话。

### 4. 输出域Scope
- 使用Scope模型控制输出位置，支持嵌套和灵活的内容组织。

### 5. 会话与通信
- 会话结束时，未完成的PyWebIO调用会抛出`SessionClosedException`。
- 通信方式：支持WebSocket和HTTP轮询。

## 三、安装与配置
- **安装**：
- 稳定版：`pip3 install -U pywebio`
- 开发版：`pip3 install -U --force-reinstall https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- **系统要求**：Python 3.5.2及以上版本。
- **Nginx配置示例**：

  server {
      listen 80;
      location /tool/ { ... }
      location /tool/io {
          proxy_pass http://localhost:5000;
          proxy_set_header Upgrade $http_upgrade;
          proxy_set_header Connection $connection_upgrade;
      }
  }

## 四、示例与特性
- **示例**：计算BMI指数的脚本。
- **特性**：
- 支持数据可视化，结合第三方库。
- 支持多线程和协程执行模型。
- 代码侵入性低，便于改造终端脚本。

## 五、扩展功能
- **第三方库支持**：可视化、代码编辑器（如Codemirror）等。
- **跨平台支持**：支持Flask、Django、Tornado、aiohttp等框架。

## 六、总结
PyWebIO通过简洁的API和灵活的模式，帮助开发者快速构建基于浏览器的交互式应用，适合需要快速开发且对UI要求不高的场景。