PyWebIO v1.3.3 使用手册

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

摘要

文档详细介绍了PyWebIO的使用方法及特性，包括其命令式API、输入输出函数、与主流Web框架的整合支持，以及数据可视化能力。通过PyWebIO，开发者可以像编写终端脚本一样快速构建Web应用，无需深入了解HTML和JavaScript。该工具支持Flask、Django、Tornado等多种框架，并提供了丰富的输出函数如put_text、put_image等，方便用户交互和数据展示。此外，文档还列出了版本更新日志，涵盖了新功能的添加、性能优化和问题修复等内容。

AI总结

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

一、概述
PyWebIO是一个基于浏览器的交互式工具库，允许开发者通过Python代码实现浏览器上的输入和输出操作。它将浏览器视为一个"富文本终端"，类似于控制台程序，无需HTML和JavaScript知识，便可快速构建Web应用或基于浏览器的GUI应用。PyWebIO支持与多种Web框架（Flask、Django、Tornado等）集成，提供了命令式API，适合高效开发对UI要求不高的应用。

二、核心功能
1. 输入与输出
- 输入函数（`pywebio.input`模块）：支持文本、数字、文件等多种输入形式，包括`input`、`select`、`file_upload`等阻塞式函数。
- 输出函数（`pywebio.output`模块）：支持输出文本、图片、表格、Markdown等内容，提供`put_text`、`put_image`、`put_table`等命令。
- 布局与美化：支持行布局（`put_row`）、网格布局（`put_grid`）、标签页（`put_tabs`）等，增强UI体验。
- 会话控制：提供`hold`、`defer_call`等函数控制会话流程。

2. 高级功能
- 数据可视化：支持使用Plotly、Pyecharts等第三方库进行可视化。
- 安全与SEO：新增防XSS攻击（sanitize参数）和SEO支持。
- 持久化输入：通过`pin`模块提供持久化输入支持。
- 国际化：支持多语言界面。

三、更新日志
1. **v1.3.3**：修复多项bugs。
2. **v1.2**：支持WebSocket重连、静态文件托管、提示消息输出（`put_info`、`put_error`等）。
3. **v1.1**：增强安全性、支持国际化、优化性能，废弃部分旧功能。
4. **v0.2**：支持FastAPI、Starlette框架，新增数据可视化、动画效果、测试用例等。

四、安装与使用
- **安装**：稳定版使用`pip install pywebio`，开发版可从阿里云仓库安装。
- **系统要求**：Python 3.5.2及以上。
- **示例**：提供计算BMI指数的示例，帮助用户快速上手。
- **部署**：支持独立部署、HTTP部署、集成到现有Web服务，提供Nginx WebSocket配置示例。

五、帮助与支持
- **文档**：提供详细的中文和英文文档，包括部署指南、常见问题解答、第三方库生态等。
- **社区支持**：通过GitHub Discussion和Issue报告bugs。

PyWebIO通过简单的命令式API和丰富的功能，帮助开发者快速构建交互式Web应用，适合UI要求不高但需要快速开发的场景。其良好的兼容性和扩展性使其成为Web开发的有力工具。