PyWebIO v1.4.0 使用手册

《PyWebIO v1.4.0 使用手册》主要介绍了PyWebIO框架的使用方法和特性，旨在帮助开发者通过最少的代码实现与用户的交互，并提供良好的用户体验。以下是对文档内容的总结： ### 1. **核心特性** - **简洁高效**：通过命令式API实现交互，类似于编写终端脚本，无需HTML和JavaScript知识。 - **灵活集成**：支持与Flask、Django、Tornado、aiohttp、FastAPI等主流Web框架集成。 - **同步式交互**：采用阻塞式输入函数，代码逻辑更自然。 - **数据可视化**：支持第三方库如Bokeh进行实时交互式数据可视化。 - **打包部署**：可通过PyInstaller将应用打包为独立可执行文件，便于分发。 ### 2. **输入功能** PyWebIO提供多种输入函数，支持文本、密码、下拉选择、复选框、单选按钮、多行文本和文件上传等 forms： - `input()`：获取基本类型输入（如文本、数字）。 - `select()`：下拉选择。 - `checkbox()`：复选框。 - `radio()`：单选按钮。 - `textarea()`：多行文本输入。 - `file_upload()`：支持多文件上传和文件大小限制。 ### 3. **输出功能** 通过多种输出函数将内容显示在浏览器中： - `put_text()`：输出文本。 - `put_image()`：显示图片。 - `put_table()`：显示表格，支持跨行/列单元格和嵌套其他输出内容。 - `put_html()`、`put_markdown()`：输出HTML和Markdown内容。 - `put_buttons()`：显示按钮，支持自定义颜色和点击事件。 - `popup()`：显示弹窗内容。 ### 4. **会话管理** - 支持跨域通信。 - 会话关闭时自动清理未完成的调用，并抛出`SessionClosedException`异常。 ### 5. **通信协议** PyWebIO采用客户端-服务器架构，通信方式包括： - **WebSocket**：适用于Tornado或aiohttp后端，实时交互。 - **Http轮询**：适用于Flask或Django后端，通过GET请求轮询服务器，POST提交用户输入。 ### 6. **版本更新** - 新增多文件上传、上传进度显示、按钮颜色自定义等功能。 - 优化前端交互，支持空格作为锚点名。 - 提供`session.get_info()`获取会话信息。 ### 7. **第三方库集成** - **数据可视化**：支持Bokeh，通过`output_notebook()`设置输出到PyWebIO。 - **打包工具**：使用PyInstaller将应用打包为可执行文件，方便分发。 ### 总结 PyWebIO通过简洁的API和强大的功能，帮助开发者快速构建基于浏览器的交互式应用，适合需要高效交互但对UI要求不高的场景，同时支持与主流Web框架和第三方库的深度集成。