PyWebIO v1.8.2 Documentation

以下是对《PyWebIO v1.8.2 Documentation》文档内容的总结，重点突出核心观点和关键信息： --- ### PyWebIO v1.8.2 Documentation 总结 #### 1. Cookbook 示例 - **刷新页面**：在PyWebIO应用主函数开头添加以下代码，实现断开连接后4秒自动刷新页面： ```javascript session.run_js('WebIO._state.CurrentSession.on_session_close(()=>{setTimeout(()=>location.reload(), 4000)}))' ``` #### 2. 发布说明 PyWebIO的更新内容按版本划分如下： ##### 2.1 PyWebIO 1.8.2 - **新增功能**： - `put_datatable()` widget。 - 在基于HTTP的后端（Flask和Django）上构建可靠的消息传输。 - **向后不兼容的更改**： - 使用 `put_loading()` 作为上下文管理器时，上下文块内的输出将在退出时被移除。 - **详细更改**： - 添加 `put_file_upload()` 窗口小部件。 - 添加 WPA 支持（通过 `config(manifest)`），使PyWebIO应用可以像本地应用一样在移动设备上启动。 - 为所有公共函数添加类型提示。 - 添加乌兹别克斯坦语支持。 - 删除 `NullHandler()` 日志处理程序，默认输出PyWebIO的异常日志。 - 添加 `max_payload_size` 参数到 `start_server()` 和 `webio_handler()`（适用于aiohttp和fastapi后端）。 ##### 2.2 PyWebIO 1.8 - **新增功能**： - `put_info()`、`put_error()`、`put_warning()`、`put_success()`。 - `output()` 的 `reset()`、`append()`、`insert()` 方法支持任意类型内容。 - **向后不兼容的更改**： - 移除 `disable_asyncio` 参数（Django和Flask）。 - 替换 `pywebio.session.data()` 为 `pywebio.session.local`。 - **修复**： - 解决 `file_upload()` 的 `max_size` 和 `max_total_size` 参数解析错误。 - 修复Python 3.6中自动打开浏览器失败的问题。 ##### 2.3 PyWebIO 1.5.1 (2021/12/21) - **修复**： - 修复 `pin.pin` 对象的项错误。 - 修复基于线程的会话未正确关闭问题。 - 修复32-bit Windows上的溢出错误。 - 修复示例错误。 - 修复Flask后端调试模式下spawn多个远程访问进程的问题。 ##### 2.4 PyWebIO 1.5.2 (2021/12/30) - **修复**： - 修复线程在会话关闭后保持活跃的问题。 - 修复 `put_button()` 无法使用异步回调的问题。 ##### 2.5 PyWebIO 1.4 (2021/10/4) - **新增功能**： - 支持将 `onclick` 回调绑定到任何输出窗口小部件。 - 添加 `put_button()` 和 `put_actions()`。 - **修复**： - 修复表单验证失败后无法提交的问题。 - 修复CodeMirror刷新和模式自动加载问题。 - 修复 `run_js()` 返回 `None` 的问题。 ##### 2.6 PyWebIO 1.2 (2021/3/18) - **新增功能**： - 支持通过 `reconnect_timeout` 参数在WebSocket连接中重新连接。 - 添加 `path_deploy()`、`path_deploy_http()` 和命令 `pywebio-path-deploy` 部署PyWebIO应用。 - 所有文档和演示现在有英文版本。 - **详细更改**： - 添加 `put_info()`、`put_error()`、`put_warning()`、`put_success()`。 - 添加 `pywebio.utils.pyinstaller_datas()` 以获取PyWebIO数据文件。 ##### 2.7 PyWebIO 1.1 (2021/2/7) - **新增功能**： - 安全支持：`put_html()` 和 `put_markdown()` 可以使用 `sanitize` 参数防止XSS攻击。 - UI国际化支持。 - SEO支持：通过 `pywebio.platform.seo()` 或函数文档字符串设置SEO信息。 - 应用访问速度改进，无需探测请求确定通信协议。 ##### 2.8 PyWebIO 1.0 (2021/1/17) - **主要功能**： - `start_server()` 和 `go_app()`。 - 布局功能：`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功能：`console`。 ##### 2.9 PyWebIO 0.3 (2020/5/13) - **主要功能**： - 支持Bokeh、`session.get_info()` 和TypeScript。 - 表格输出：`put_table()` 和其他输出函数。 - 支持CodeMirror和数据可视化。 #### 3. PyWebIO 特点 - 使用同步代替基于回调的方法获取输入。 - 非声明式布局，简单高效。 - 次остатчен: 旧脚本代码可以仅通过修改输入和输出操作转换为Web服务。 - 支持集成到现有Web服务（Flask、Django、Tornado、aiohttp、FastAPI）。 - 支持 `asyncio` 和 coroutine。 - 支持第三方库进行数据可视化。 #### 4. PyWebIO_Battery 扩展包 - 功能列表： - 交互相关：`confirm()`、`popup_input()`、`redirect_stdout()`、`run_shell()`、`put_logbox()`、`logbox_append()`。 - Web应用相关：`get_all_query()`、`get_query()`、`set_localstorage()`、`get_localstorage()`、`set_cookie()`、`get_cookie()`、`basic_auth()`、`custom_auth()`、`revoke_auth()`。 - 安装：`pip3 install -U pywebio-battery`。 --- 以上是文档的核心内容和关键信息的总结，涵盖了PyWebIO的主要功能、更新内容及扩展包功能。