PyWebIO v1.3.0 Documentation

语言	格式	评分
英语	.epub	3
摘要
PyWebIO是一个用于在浏览器中进行用户输入和输出的Python库，可以快速构建简单的网络应用或基于浏览器的GUI应用。文档介绍了PyWebIO v1.3.0的更新内容，包括新增了对多个任务函数的支持、布局功能（如put_grid(), put_row(), put_column()）和自定义样式支持（style()），以及新的输出函数如toast(), popup(), put_widget(), put_collapse(), put_link(), put_scrollable(), put_loading(), put_processbar()。此外，还支持与Django、aiohttp、FastAPI等Web框架的集成，并提供了远程访问功能。文档还详细说明了安装方法和使用示例。
AI总结
《PyWebIO v1.3.0 Documentation》总结如下： ### 概述 PyWebIO 是一个用于在浏览器中实现交互式终端功能的 Python 库，支持快速构建简单的 Web 应用或基于浏览器的 GUI 应用。它通过命令式函数完成用户输入和输出，无需 HTML 和 JS 知识，同时支持与现有 Web 框架（如 Flask、Django、Tornado、aiohttp 和 FastAPI）集成。 --- ### 主要修复 1. 解析错误修复：修复了 `file upload()` 中 `max_size` 和 `max_total_size` 参数的解析错误。 2. 浏览器自动打开问题：修复了 Python 3.6 中自动打开浏览器失败的问题。 --- ### 各版本更新亮点 #### PyWebIO 1.0（2021/1/17） - 新增功能： - 支持多任务函数，可使用 `go_app()` 实现任务函数之间的跳转。 - 弃用基于锚点的输出控制模型，改用基于 `Scope` 的模型。 - 新增布局支持（`put_grid()`、`put_row()`、`put_column()`）和自定义样式支持（`style()`）。 - 新增输出函数：`toast()`、`popup()`、`put_widget()`、`put_collapse()`、`put_link()`、`put_scrollable()`、`put_loading()`、`put_processbar()`、`span()` 和 `output()`。 - 新增 JS 执行函数：`run_js()` 和 `eval_js()`。 - 更新 UI：输入时使用浮动式输入框，异常捕获时前端记录日志。 - 不兼容改动： - 移除了 `pywebio.output.set_output_fixed_height()`、`pywebio.output.set_title()` 和 `pywebio.output.set_auto_scroll_bottom()`，改用 `pywebio.session.set_env()`。 - 移除了 `pywebio.output.table_cell_buttons()`，改用 `pywebio.output.put_buttons()`。 #### PyWebIO 1.2（2021/3/18） - 新增功能： - 支持 WebSocket 连接重连，新增 `reconnect_timeout` 参数。 - 新增 `path deploy` 和 `pywebio-path-deploy` 命令，支持从目录部署应用。 - 文档新增对数据可视化库 `pyg2plot` 的支持。 - 部分输出函数支持上下文管理器。 - 其他改进： - 新增 `pywebio.utils.pyinstaller_datas()` 方法，用于获取 PyWebIO 数据文件。 - 支持静态文件服务，新增 `static_dir` 参数。 #### PyWebIO 1.1（2021/2/7） - 新增功能： - 安全性增强：`put_html()` 和 `put_markdown()` 新增 `sanitize` 参数，防止 XSS 攻击。 - 新增 UI 国际化支持。 - SEO 支持：通过 `pywebio.platform.seo()` 设置 SEO 信息。 - CDN 支持，提升与 Web 框架的集成便利性。 - 不兼容改动： - 移除了 `start_server()` 中的 `disable_asyncio` 参数（Django 和 Flask 版本）。 - 移除了 `pywebio.session.data()`，建议使用 `pywebio.session.local`。 #### PyWebIO 0.2（2020/4/30） - 新增功能： - 支持与 Django 和 aiohttp 集成。 - 新增 `put_image()`、`defer_call()` 和 `hold()` 函数。 - 新增 `put_info()`、`put_error()`、`put_warning()` 和 `put_success()`。 - 其他改进： - 页面底部新增 `footer`。 - 支持文件上传大小限制和进度显示。 --- ### 核心特性 1. 同步输入输出：采用同步方式获取输入，无需回调。 2. 非声明式布局：简单高效，侵入性小。 3. 框架集成：支持 Flask、Django、Tornado、aiohttp 和 FastAPI。 4. 异步支持：兼容 asyncio 和协程。 5. 数据可视化：支持第三方库（如 Plotly、pyecharts）。 6. 安全性：支持 XSS 防护。 7. 部署支持：支持从目录部署应用，提供 CDN 和静态文件服务。 --- ### 安装 - 稳定版：`pip3 install -U pywebio` - 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` --- ### 框架支持 - Flask/Django/Tornado：支持基于线程的会话实现。 - aiohttp：支持基于协程的会话实现，需手动安装 aiohttp（>=3.1）。 - FastAPI/Starlette：支持与 FastAPI 或 Starlette 集成，需安装 `fastapi` 和 `starlette`。 --- ### 其他更新 - 安全性：`put_html()` 和 `put_markdown()` 新增 `sanitize` 参数。 - 国际化：支持多语言界面。 - SEO：通过文档字符串或函数设置 SEO 信息。 - CDN：提升访问速度，减少探测请求。 --- PyWebIO 通过简单高效的接口和丰富的功能，为开发者提供了快速构建基于浏览器的交互式应用的能力。