PyWebIO v1.8.2 使用手册

**《PyWebIO v1.8.2 使用手册》总结** --- ### 特性 - **同步交互**：采用同步方式获取输入，使代码逻辑更自然，避免回调机制的复杂性。 - **简单布局**：非声明式布局，代码简洁高效，降低开发难度。 - **低侵入性**：旧脚本仅需修改输入输出逻辑即可快速改造为Web服务。 - **框架集成**：支持与Flask、Django、Tornado、aiohttp、FastAPI等主流Web框架无缝集成。 - **执行模型**：同时支持基于线程和协程的执行模型，灵活应对不同场景。 - **数据可视化**：支持第三方库（如Bokeh）实现数据可视化功能。 --- ### 使用手册 1. **快速上手**：通过`start_server()`函数即可启动服务，例如： ```python start_server(bmi, port=80) ``` 该函数可直接在指定端口提供服务，或整合到现有Web框架中。 2. **交互函数**：通过命令式API实现用户交互，例如： - 输出函数：`put_text()`、`put_image()`、`put_table()`等。 - 输入函数：`input()`、`select()`、`file_upload()`等。 3. **布局与事件**：支持布局配置（如`put_row()`、`put_grid()`）和点击事件，如`put_buttons()`。 4. **在线体验**：文档中的示例代码可在线运行，提供了PyWebIO Playground供用户编写、运行和分享代码。 --- ### 高级特性 1. **多应用支持**：通过`start_server()`函数启动多个应用，应用间可通过`go_app()`或`put_link()`跳转。 - 示例：定义多个任务函数（如`task_1()`、`task_2()`），并通过`start_server()`同时启动。 2. **静态文件托管**：支持通过`static_dir`参数托管静态文件。 3. **数据可视化**：整合第三方库（如Bokeh）实现实时交互式可视化，通过`bokeh.io.output_notebook()`设置输出目标。 --- ### 第三方库生态 1. **打包应用**：使用PyInstaller将PyWebIO应用打包为独立可执行文件： - 创建.spec文件：`pyi-makespec app.py` - 编辑.spec文件，添加所需数据：`datas=pyinstaller_datas()` - 构建可执行文件：`pyinstaller app.spec` 2. **数据可视化**：支持Bokeh等库，通过`output_notebook()`设置输出目标，实现交互式可视化。 --- ### 版本更新日志 #### PyWebIO 1.8.2 - **新功能**： - 添加安全性支持（如防XSS攻击，`sanitize`参数）。 - 支持UI国际化和SEO优化。 - 提供CDN支持，简化Web框架整合。 - 优化应用访问速度，移除探测请求。 - **破坏性更改**： - 移除`django`和`flask`框架中的`disable_asyncio`参数。 - 废弃`pywebio.session.data()`，改用`pywebio.session.local`存储会话状态。 - 整合到Web框架的应用访问地址发生变化。 - **详细改进**： - 优化`put_code()`、`put_scrollable()`等函数的参数支持。 - 修复`file_upload()`参数解析错误及Py3.6自动打开浏览器问题。 #### 其他版本更新 - **1.0版本**：完成了从v0.3到1.0的全面升级，新增了多语言支持、WebSocket重连功能、路径部署模式等。 - **1.1版本**：庆祝项目一周年，进一步完善功能和用户体验。 - **1.2版本**：添加了提示消息函数（如`put_info()`、`put_error()`），支持PyInstaller打包，优化文档和示例。 --- ### 总结 PyWebIO是一款强大且灵活的工具，旨在通过简洁的API快速构建基于浏览器的交互式应用，支持与主流Web框架无缝集成和第三方库扩展。其同步交互模式和命令式API使开发者能够像编写终端脚本一样轻松构建Web应用，适合快速开发UI要求不高的场景。同时，PyWebIO提供了丰富的文档和示例，及其在线运行环境，方便用户学习和使用。