PyWebIO v1.6.0 使用手册

• 语言: 中文（简体）
• 格式: .pdf
• 来源: pywebio.readthedocs.io

摘要

《PyWebIO v1.6.0 使用手册》详细介绍了PyWebIO的使用方法，包括输入函数、输出模块、会话管理和应用部署等功能。文档提供了丰富的示例代码和在线演示链接，帮助用户快速上手。PyWebIO支持多种输入类型（如文本、密码、下拉框、复选框等），并通过命令式API实现与用户的交互。此外，文档还介绍了如何将PyWebIO应用打包为独立可执行文件、与第三方库（如Bokeh、Plotly等）集成，以及如何通过WebSocket实现数据可视化。最后，文档还涵盖了服务器模式和脚本模式的使用方法，以及如何处理文件上传路径 sanitization 等问题。

AI总结

《PyWebIO v1.6.0 使用手册》总结：

PyWebIO 是一个用于快速开发交互式 Web 应用的 Python 库，支持通过简单的代码实现与用户的交互，并提供良好的用户体验。以下是文档的核心内容总结：

### 1. **基本功能**
- **输入模块**：通过 `pywebio.input` 提供多种输入方式，包括文本输入、密码输入、下拉选择、复选框、单选框和文件上传等。
- 示例：

    age = input("How old are you?", type=NUMBER)
    gift = select("Which gift you want?", ['keyboard', 'ipad'])

- **输出模块**：通过 `pywebio.output` 提供丰富的输出功能，如文本、图片、表格等，支持 HTML 内容输出。
- 示例：

    put_text("Hello, World!")
    put_image("path/to/image.jpg")

### 2. **应用运行模式**
- **脚本模式**：直接运行 PyWebIO 应用，浏览器会自动打开交互页面，适用于简单的交互场景。
- **服务器模式**：通过 `start_server()` 或 `path_deploy()` 部署为 Web 服务，支持远程访问和多会话管理。

### 3. **部署与集成**
- **`start_server()`**：启动一个 Web 服务，支持调试模式和远程访问。

  def main():
      name = input("what's your name?")
      put_text("hello", name)
  start_server(main, port=8080, debug=True)

- **`path_deploy()`**：从指定目录部署多个 PyWebIO 应用，支持通过 URL 路径访问不同应用。
- **第三方库支持**：PyWebIO 支持与 Bokeh、Plotly、Pyecharts 等数据可视化库集成，提升应用的交互体验。

### 4. **高级功能**
- **静态文件托管**：通过 `start_server()` 的 `static_dir` 参数托管静态文件。
- **会话控制**：支持 `defer_call()` 和 `hold()` 等函数，实现更复杂的交互逻辑。
- **WebSocket 支持**：支持客户端与服务端的实时通信，提供重连机制。

### 5. **更新日志**
- **v1.6.0**：新增 `put_info()`、`put_error()` 等提示消息函数，支持更多输出格式。
- **v1.2**：支持 WebSocket 重连，新增 `path_deploy()` 和 `pywebio-path-deploy` 命令。
- **v1.1**：支持与 Django、aiohttp 等 Web 框架集成，优化文档和用户体验。
- **v0.3**：支持 Bokeh 数据可视化，改进前端交互体验。
- **v0.2**：支持 Plotly、Pyecharts 等第三方库，新增动画效果和测试用例。

### 6. **其他**
- 提供 PDF 和 Epub 格式的文档下载。
- 使用 `pywebio.platform.path_deploy()` 部署应用时，支持自定义索引页面和静态文件托管。

PyWebIO 通过简洁的 API 和灵活的部署方式，帮助开发者快速构建交互式 Web 应用，适用于教育、数据分析、Web 开发等多种场景。