PyWebIO v1.6.0 Documentation

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

摘要

PyWebIO是一个允许开发者在浏览器中运行交互式Python脚本的库，支持与Flask、Django等Web框架整合，并提供数据可视化功能。它通过简单的输入输出函数实现交互，支持异步和协程，适合快速构建交互式Web应用。

AI总结

《PyWebIO v1.6.0 Documentation》总结如下：

### 文档概述
PyWebIO是一款简化Web开发的Python库，通过提供直观的API，允许开发者像编写终端脚本一样快速构建Web应用或基于浏览器的GUI应用，无需深入了解HTML和JavaScript。其核心特点包括：
1. **同步机制**：通过同步方式获取用户输入，避免回调复杂性。
2. **非声明式布局**：简单高效，减少代码侵入性。
3. **灵活集成**：支持Flask、Django、Tornado、aiohttp、FastAPI等框架，并提供异步和协程支持。
4. **数据可视化**：集成第三方库（如Plotly、PyECharts）进行可视化。
5. **轻量级**：适合快速构建不需要复杂UI的交互式应用。

---

### 安装与使用
- **安装**：
- 稳定版本：`pip3 install -U pywebio`
- 开发版本：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- **环境要求**：Python 3.5.2或更高版本。
- **入门示例**：通过简单脚本实现BMI计算等交互式功能。

---

### 主要功能与配置
1. **核心功能**：
- 输出函数：`put_xxx`系列，支持文本、图片、表格、代码等内容输出。
- 输入函数：`input`、`select`、`file_upload`等，用于获取用户输入。
- 会话控制：`defer_call()`、`hold()`等，用于控制会话流程。
2. **配置**：
-รองรับ全局配置和装饰器模式，设置标题、描述、主题（如dark、sketchy、minty、yeti）等。
- 示例：

     config(title="My application")  # 全局配置
     @config(css_style="* { color:red }")  # 装饰器模式
     def app():
         put_text("hello PyWebIO")

3. **SEO支持**：通过`pywebio.platform.seo()`或函数文档字符串设置SEO信息。

---

### 输入与输出
1. **输入函数**：
- `input()`：弹出输入框，阻塞式等待用户提交。
- `select()`、`file_upload()`等，支持多种输入形式。
2. **输出函数**：
- `put_text()`、`put_image()`、`put_table()`等，用于输出内容。
- 支持锚点（anchor）定位和内容替换。

---

### 版本更新日志
1. **v1.6.0**：
- 弃用`table_cell_buttons()`。
- 修复多项Bug。
2. **v1.5.0**：
- 添加了`put_info()`、`put_error()`、`put_warning()`、`put_success()`等输出函数。
- 支持通过`path_deploy()`部署应用。
3. **v1.4.0**：
- 添加了`static_dir`参数以支持静态文件服务。
4. **v1.3.0**：
- 支持Flask集成，通过`webio_view()`或`wsgi_app()`运行PyWebIO应用。
- 提供`start_server()`启动Flask服务器。
5. **v1.2.0**：
- 支持WebSocket重连接。
- 添加了`put_code()`、`put_scrollable()`等功能。
6. **v1.1.0**：
- 增强安全性，防止XSS攻击。
- 支持UI国际化。
7. **v1.0.0**：
-正式发布，新增多项功能和改进。
8. **v0.3.0**：
- 新增数据可视化支持。
9. **v0.2.0**：
- 支持与Django、aiohttp框架整合。
- 添加`defer_call()`、`hold()`等会话控制函数。

---

### discussions & support
- **问题反馈**：GitHub Discussions（[链接](https://github.com/wang0618/PyWebIO/discussions））或Issue（[链接](https://github.com/wang0618/pywebio/issues)）。
- **代码与文档**：提供在线示例和文档，方便开发者参考。

---

PyWebIO通过简化的API和灵活的配置，帮助开发者快速构建交互式Web应用，适合需要快速开发但无需复杂界面的场景。