PyWebIO v1.2.3 Documentation

语言	格式	评分
英语	.epub	3
摘要
PyWebIO是一款可以快速构建Web应用的Python库，支持与多种Web框架（如Django、Flask、Tornado、aiohttp）整合，并提供命令式API来实现用户交互和数据可视化。文档详细介绍了PyWebIO的功能、更新日志、安装方法及使用示例，包括通信协议（WebSocket和HTTP）、会话控制、SEO支持、跨域设置以及安全增强等内容。
AI总结
《PyWebIO v1.2.3 Documentation》总结如下： --- ### 1. PyWebIO 概述 PyWebIO 是一个通过 Python 快速构建 Web 应用或浏览器GUI的工具。其核心特点包括： - 使用同步方式而非回调实现用户输入和输出。 - 简单高效的非声明式布局。 - 无需 HTML 和 JS 知识，适合快速构建无需复杂 UI 的应用。 - 支持集成到 Flask、Django、Tornado、aiohttp 等主流 Web 框架。 - 支持 asyncio 和协程。 - 支持第三方可视化库（如 plotly、pyecharts）进行数据可视化。 --- ### 2. 主要功能与更新 #### 2.1 功能扩展 - 通信协议：PyWebIO 使用 WebSocket 和 HTTP 两种协议： - WebSocket：用于 Tornado 和 aiohttp 后端，提供实时双向通信。 - HTTP：用于 Flask 和 Django 后端，通过轮询或表单提交实现。 - 输入输出功能：提供丰富的输入（如 `input()`, `select()`, `file_upload()`）和输出（如 `put_text()`, `put_table()`, `put_image()`）函数。 - 会话管理：提供 `webio.session` 模块，用于会话数据管理。 - SEO 支持：通过 `pywebio.platform.seo()` 设置应用标题和描述。 - 国际化支持：支持多语言 UI。 #### 2.2 功能更新 - v1.2 更新： - 新增 `static_dir` 参数用于 `start_server()`。 -optimize 应用访问速度，移除探测请求。 - 废弃 `put_html()` 的 `message` 参数（IE 浏览器不支持）。 - v1.1 更新： - 增加 CDN 支持，简化 Web 框架集成。 - 增强安全性：`put_html()`, `put_markdown()` 支持CRM防止 XSS 攻击。 --- ### 3. 技术集成 - Web 框架集成： - Tornado：通过 `start_server()`启动服务，支持 WebSocket。 - aiohttp：通过 `webio_handler()` 集成，同样使用 WebSocket。 - Django/Flask：需要额外配置，使用 HTTP 通信。 - 数据可视化：支持 plotly、pyecharts 等第三方库。 - Nginx 配置示例：提供 WebSocket 配置指导。 --- ### 4. 安装与使用 - 安装： - 稳定版本：`pip3 install -U pywebio` - 开发版本：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` - 快速上手： - 通过简单代码实现 BMI 计算器等示例。 - 提供在线预览功能，方便测试代码运行效果。 --- ### 5. 用户指南 - 输入与输出： - `pywebio.input` 模块提供多种输入函数。 - 输出函数（如 `put_code()`, `put_markdown()`）支持丰富格式。 - 布局与交互： - 支持动画、滚动、表单布局。 - 提供 `reset()`, `append()`, `insert()` 等输出控制函数。 --- ### 6. 版本更新日志 - v1.2： - 添加 `static_dir` 参数。 - 修复 `Session` 对象对 `functools.partial` 的支持。 - v1.1： - 增加安全防护和 SEO 支持。 - 提供更好的异步支持。 - v1.0： - 提供更稳定的框架集成。 - v0.3： - 添加 `defer_call()` 和 `hold()` 等会话控制函数。 - v0.2： - 支持 Flask 和 aiohttp 集成。 - 添加测试用例和 CI 工作流。 --- ### 7. 技术支持与反馈 - 讨论与报告： - 提问：GitHub Discussions（[链接](https://github.com/wang0618/PyWebIO/discussions)） - 报告Bug：GitHub Issues（[链接](https://github.com/wang0618/pywebio/issues)） --- 以上是《PyWebIO v1.2.3 Documentation》的核心内容总结，涵盖了功能特点、技术集成、使用方法以及版本更新的关键信息。