PyWebIO v1.6.2 使用手册

# 《PyWebIO v1.6.2 使用手册》总结 ## 1. 项目概述 PyWebIO是一个支持通过Python代码在浏览器中创建交互式Web应用的库。开发者可以像编写终端脚本一样，使用`input`和`output`函数进行交互，无需掌握HTML和JavaScript知识。PyWebIO提供了一系列命令式API，支持快速构建简单Web应用或基于浏览器的GUI应用。 ## 2. 核心功能 - **输入函数**：位于`pywebio.input`模块，支持多种输入类型（如文本、数字、文件等），并提供阻塞式调用，直到用户提交输入。 - **输出函数**：支持输出文本、图片、表格等内容，通过`put_text()`、`put_image()`、`put_table()`等API实现。 - **交互支持**：提供点击事件、布局管理等功能，提升用户体验。 - **平台模块**：支持通过`WebSocket`或`HTTP`协议与服务器通信，可配置网页相关设置。 - **高级特性**：支持与主流Web框架（如Flask、Django等）集成、基于协程的会话、数据可视化（如Bokeh、Plotly等）以及打包可执行文件。 ## 3. 安装与使用 - **安装**： - 稳定版：`pip3 install -U pywebio` - 开发版：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` - **系统要求**：Python 3.5.2及以上版本。 ## 4. 快速入门 通过一个计算BMI指数的示例，展示了PyWebIO的基本用法： ```python from pywebio.input import input, FLOAT from pywebio.output import put_text height = input("What is your height? (in meters)", type=FLOAT) weight = input("What is your weight? (in kilograms)", type=FLOAT) bmi = weight / (height ** 2) put_text("Your BMI is: %.2f" % bmi) ``` ## 5. 高级功能 - **与Web框架整合**：支持将PyWebIO应用整合到现有Web项目中，支持Flask、Django、Tornado等框架。 - **协程支持**：提供基于协程的会话机制，适用于高并发场景。 - **数据可视化**：支持Bokeh、Plotly等第三方库进行数据可视化。 - **独立应用打包**：可使用PyInstaller将PyWebIO应用打包为独立可执行文件。 ## 6. 配置与自定义 - **配置选项**：通过`pywebio.config()`函数或装饰器，可以设置应用标题、描述、主题等。 - **SEO优化**：默认使用任务函数的注释作为SEO信息，可以手动配置`title`和`description`。 - **自定义样式**：支持通过`js_code`、`js_file`、`css_style`、`css_file`参数注入自定义脚本和样式。 ## 7. 版本更新 - **v1.6.2**： - 修复文件上传时的路径解释漏洞。 - 支持重连超时配置。 - 扩展测试用例，优化构建流程。 - **v1.2**： - 支持WebSocket重连。 - 提供目录部署功能。 - 输出函数支持上下文管理器。 - **v0.2**： - 支持与Django、aiohttp整合。 - 支持数据可视化和UI动画效果。 ## 8. 社区与支持 - **讨论与报告问题**：可以通过GitHub Discussions和Issue提交反馈。 - **文档与示例**：提供详细文档和在线示例，方便开发者快速上手。 PyWebIO通过简单的API和灵活的配置，帮助开发者快速构建交互式Web应用，适合需要快速开发且对UI要求不高的场景。