PyWebIO v1.5.0 使用手册

# 《PyWebIO v1.5.0 使用手册》总结 ## 1. 概述 PyWebIO 是一个能够让开发者像编写终端脚本一样构建 Web 应用的工具。通过其命令式 API，用户可以在浏览器上显示输入/输出内容并进行交互，无需掌握 HTML 和 JavaScript。PyWebIO 支持与多种 Web 框架（如 Flask、Django、Tornado 等）集成，并提供了协程支持、数据可视化功能以及独立应用打包能力。 ## 2. 安装 - **稳定版**：`pip3 install -U pywebio` - **开发版**：`pip3 install -U https://code.aliyun.com/wang0618/pywebio/repository/archive.zip` - **系统要求**：Python 3.5.2 及以上版本。 ## 3. 示例：Hello World ```python from pywebio.input import input from pywebio.output import put_text put_text("Hello, world!") ``` ## 4. 核心功能 ### 4.1 输入函数 - **基本类型输入**： - `input()`：获取用户输入的文本。 - `input("How old are you?", type=NUMBER)`：获取数值输入。 - **持续输入**：通过 `pywebio.pin` 模块实现表单持续显示。 ### 4.2 输出函数 - `put_text()`：输出文本。 - `put_image()`：显示图片。 - `put_table()`：显示表格。 ### 4.3 平台模块 - **部署方式**：支持 WebSocket 和 HTTP 通信协议。 - **配置选项**：可通过 `pywebio.config()` 设置网页相关配置。 ## 5. 高级特性 - **框架集成**：可集成到现有 Web 项目，支持 Flask、Django、Tornado 等。 - **协程支持**：基于协程的会话机制。 - **独立应用打包**：通过 PyInstaller 打包为独立可执行文件。 ## 6. 通信协议 - **WebSocket**：服务端与客户端通过 WebSocket 连接交换 JSON序列化的消息。 - **HTTP**：客户端通过 GET 请求轮询消息，POST 提交数据。 ## 7. 特性 - **同步式交互**：代码逻辑自然，避免回调困扰。 - **简洁布局**：非声明式布局方式，使用简单。 - **扩展性**：支持数据可视化（如 Bokeh 集成）和 SEO 配置。 ## 8. 版本更新 - **v1.5**：新增连接重连支持、静态文件托管功能。 - **v1.4**：优化数据可视化和错误处理机制。 - **v1.3**：增强安全性，防止 XSS 攻击。 - **v1.2**：支持多语言、文档优化。 ## 9. community support - **讨论区**：[GitHub Discussions](https://github.com/wang0618/PyWebIO/discussions) - **问题报告**：[GitHub Issues](https://github.com/wang0618/pywebio/issues) ### 总结 PyWebIO 通过其直观的 API 和强大的扩展能力，帮助开发者快速构建基于浏览器的应用，节省开发时间，提升效率。