PyWebIO v1.8.2 使用手册

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

摘要

PyWebIO 是一个用于编写 Web 应用的 Python 库，通过命令式 API 实现输入输出交互。文档介绍了其安装方法、基本功能、高级特性（如多应用启动、持续性输入、布局支持等）以及部署方式（如使用 start_server 和 path_deploy 函数）。此外，还支持与第三方库（如 Bokeh）集成，并提供了打包应用的指导。

AI总结

# PyWebIO v1.8.2 使用手册总结

## 概述
PyWebIO 是一个用于快速开发基于浏览器的交互式 Python 应用的工具。它通过命令式 API 提供了类似于控制台编程的简单接口，适用于数据可视化、Web 应用开发等场景。

## 主要特性
1. **核心功能**：
- 支持在浏览器上显示文本、图片、表格等。
- 提供表单输入功能（如 `input()`、`select()`、`file_upload()`）。
- 支持点击事件和布局控制，便于实现交互式界面。
- 可通过 `start_server()` 启动服务或集成到现有 Web 框架。

2. **高级特性**：
- 支持多应用部署，可通过 `start_server()` 启动多个应用，并通过 `go_app()` 或 `put_link()` 实现应用间跳转。
- 提供会话管理功能，支持 WebSocket 和 HTTP 协议。
- 新增datatable widget（`put_datatable()`），增强数据展示能力。

3. **数据可视化**：
- 支持 Bokeh 等第三方可视化库，可直接在 PyWebIO 会话中输出交互式图表。

4. **部署与扩展**：
- 通过 `path_deploy()` 可从指定目录部署多个 PyWebIO 应用，支持静态文件托管。
- 支持远程访问，方便临时分享应用。
- 新增对 Flask 和 Django 的可靠消息传输支持。

## 使用指南
1. **基本用法**：

   from pywebio import start_server
   from pywebio.input import input
   from pywebio.output import put_text

   def main():
       name = input("what's your name?")
       put_text(f"hello, {name}")

   start_server(main, port=8080, debug=True)

访问 `http://127.0.0.1:8080` 即可运行应用。

2. **第三方库集成**：
- 使用 Bokeh：

     from bokeh.io import output_notebook, show
     from bokeh.plotting import figure

     output_notebook(notebook_type='pywebio')
     p = figure(...)
     show(p)

3. **多应用部署**：

   def task_1():
       put_text('task_1')
       put_buttons(['Go task 2'], [lambda: go_app('task_2')])

   def task_2():
       put_text('task_2')
       put_buttons(['Go task 1'], [lambda: go_app('task_1')])

   def index():
       put_link('Go task 1', app='task_1')
       put_link('Go task 2', app='task_2')

   start_server([index, task_1, task_2])

## 新功能亮点
- **v1.8.2 版本更新**：
- 新增datatable widget。
- 支持 WebSocket 和 HTTP 协议下的可靠消息传输。
- 改善了会话管理，支持更彻底的清理机制。
- 新增对 WPA 的支持，允许应用在移动设备上以原生应用形式运行。

## 部署与扩展
- **打包应用**：
使用 PyInstaller 将 PyWebIO 应用打包为可执行文件：

  pyi-makespec app.py
  pyinstaller app.spec

- **在线运行与分享**：
可通过 `pywebio-playground` 在线运行和分享代码。

## 总结
PyWebIO 提供了一种简单高效的 Web 应用开发方式，适合快速实现交互式应用。其丰富的功能和灵活的部署方式使其成为数据可视化、Web 开发等场景的理想选择。