PyWebIO v1.6.1 Documentation

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

摘要

文档详细介绍了PyWebIO v1.6.1的功能和新特性。PyWebIO是一个用于快速构建交互式Web应用的库，支持与多个Web框架（如Flask、Django、Tornado等）集成，并提供了丰富的输出函数和会话控制功能。文档还介绍了PyWebIO的安装方式、数据可视化支持以及最新版本的更新内容，包括新功能的添加、已知问题的修复以及性能优化。

AI总结

《PyWebIO v1.6.1 Documentation》文档内容总结：

### 主要内容概述
PyWebIO是一个可以通过简单的命令式函数在浏览器中获取用户输入和输出内容的库，能够将浏览器变为“富文本终端”，适用于快速构建交互性应用或基于浏览器的GUI应用。其特点包括：
1. 使用同步方式获取输入，避免回调机制。
2. 非声明式布局，简单高效。
3. 支持与Flask、Django、Tornado、aiohttp和FastAPI等主流Web框架集成。
4. 支持异步和协程。
5. 集成第三方库进行数据可视化。

### 安装与使用
1. **安装**：
- 稳定版：`pip3 install -U pywebio`
- 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip`
- Python版本要求：3.5.2或更高。

2. **功能特点**：
- 提供丰富的输入输出功能，如`input`、`put_text`等。
- 支持数据可视化，集成`plotly`、`pyecharts`等第三方库。
- 支持多语言，包括Pesrian语（感谢Pikhosh）。
- 提供配置选项，支持自定义标题、描述、主题、CSS和JS注入等。

3. **框架集成**：
- 支持Flask、Django、Tornado、aiohttp和FastAPI（Starlette）。
- 提供`start_server`、`webio_view`和`wsgi_app`等接口，方便集成到不同框架中。

4. **其他功能**：
- 支持WebSocket重连（通过`reconnect_timeout`参数）。
- 提供路径部署功能（`path_deploy`、`path_deploy_http`）。
- 支持SEO优化（通过`pywebio.platform.seo()`或函数文档字符串）。
- 提供安全功能，如`put_html()`和`put_markdown()`的防XSS攻击选项。

### 更新日志亮点
1. **v1.6.1（2022/5/22）**：
- 修复`put_processbar()`名称为空格问题。
- 修复`put_select()`被`put_tabs()`隐藏的问题。
- 提供CDN不可用时的降级处理。

2. **v1.6（2022/3/23）**：
- 新增`pywebio.pin.pin_on_change()`功能。
- 添加严格模式支持。
- 支持颜色输入类型。
- 优化用户选择输入体验。

3. **v1.5**：
- 集成Flask支持。
- 添加`defer_call()`和`hold()`会话控制函数。

4. **v1.2（2021/3/18）**：
- 支持WebSocket重连。
- 提供路径部署功能。
- 支持输出函数上下文管理。

5. **v0.3（2020/5/13）**：
- 支持数据可视化文档。
- 添加`reset()`、`append()`、`insert()`方法。

6. **v0.2（2020/4/30）**：
- 支持Django和aiohttp框架集成。
- 集成第三方可视化库。
- 添加图像输出和动画效果。

### 支持与帮助
1. **讨论与支持**：
- GitHub讨论区：[https://github.com/wang0618/PyWebIO/discussions](https://github.com/wang0618/PyWebIO/discussions)
-GitHub问题追踪：[https://github.com/wang0618/pywebio/issues](https://github.com/wang0618/pywebio/issues)

2. **技术交流**：
- QQ群：419381616

### 配置选项
- 应用配置支持通过`config()`函数或装饰器实现，参数包括：
- `title`：应用标题。
- `description`：应用描述。
- `theme`：主题（支持“dark”、“sketchy”、“minty”、“yeti”）。
- `js_code`和`js_file`：注入JavaScript代码或文件。
- `css_style`和`css_file`：注入CSS样式或文件。

总结内容涵盖了PyWebIO的核心功能、安装方法、版本更新亮点及支持渠道，旨在为用户提供清晰的功能概览和使用指导。