# hyperdivlite **Repository Path**: slmpt/hyperdivlite ## Basic Information - **Project Name**: hyperdivlite - **Description**: HyperdivLite分叉,默认后端是Granian,可选Tornado - **Primary Language**: Python - **License**: Apache-2.0 - **Default Branch**: master - **Homepage**: https://hyperdiv.io/ - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-11-15 - **Last Updated**: 2026-11-15 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # HyperdivLite **HyperdivLite** 是 [Hyperdiv](https://hyperdiv.io) 的轻量分支(fork),保留了原来的 即时模式响应式 UI 编程模型,同时把服务器传输层换成 **Granian + Starlette**。 核心变化只有一处:**默认后端改为 Granian,Tornado 变为可选依赖**。 组件系统、渲染管线、状态管理、任务运行时与上游保持一致。 ## 与上游的差异 | 项目 | Hyperdiv 0.1.9 | HyperdivLite | |------|----------------|--------------| | 默认服务器 | Tornado | Granian(内嵌模式) | | Tornado 依赖 | 核心依赖,必装 | 可选 extra,默认不装 | | ASGI 层 | Tornado WebSocket | Starlette ASGI | | 启动参数 | 无 | 无,`hd.run()` 直接可用 | | Windows 支持 | 可用 | 可用,无 spawn 序列化问题 | | 后端切换 | 不可切换 | `HD_SERVER=granian` / `HD_SERVER=tornado` | ## 安装 ```bash # 默认安装:Granian + Starlette,不含 Tornado pip install hyperdivlite # 需要兼容旧的 Tornado 后端时 pip install "hyperdivlite[tornado]" ``` Python 版本要求:3.10 及以上。 > 注意:安装后的 **导入名仍然是 `hyperdiv`**,因此代码里写 `import hyperdiv as hd` > 无需改动,与上游保持兼容。 ## 快速开始 ```python import hyperdiv as hd def main(): state = hd.state(count=0) with hd.box(padding=2, gap=1): hd.text(f"当前计数:{state.count}") if hd.button("加一").clicked: state.count += 1 if __name__ == "__main__": hd.run(main) ``` ```bash python app.py ``` 默认监听 `http://localhost:8988`,可用 `HD_PORT` 指定端口、`HD_HOST` 指定地址。 ## 后端选择 不设置任何环境变量时使用 Granian。需要旧后端时显式切换: ```bash # 默认:Granian python app.py # 使用 Tornado(需先安装 hyperdivlite[tornado]) HD_SERVER=tornado python app.py ``` 选择顺序: 1. `HD_SERVER=tornado` → Tornado 2. `HD_SERVER=granian` → Granian 3. 未设置 → Granian 4. Granian 不可用但 Tornado 已装 → 自动回退 Tornado 5. 都不可用 → 明确报错 ## 功能特性 - 即时模式 UI:组件调用即渲染,无需手写模板 - 隐式响应式状态:状态变更自动触发重渲染 - 内置 Shoelace 组件库,支持亮色/暗色主题 - Chart.js 图表、Markdown 渲染、表单校验 - WebSocket 虚拟 DOM 增量补丁 - 插件系统与自定义组件 - 静态资源兜底:任意有效路径回落 `index`,支持前端路由 ## 文档应用 安装后可本地打开上游文档: ```bash hyperdiv docs ``` ## 架构说明 后端适配层位于 `hyperdiv/backends/`,只实现两个契约: 1. `Server(port, app_function, task_runtime, index_page)` 2. 连接对象提供 `send(message: dict)` 因此 `app_runner.py`、组件系统、渲染与差异计算完全不需要改动。 详细设计见 [BACKENDS.md](BACKENDS.md)。 ## 验证 `examples/` 下提供两个验证脚本: ```bash python examples/check_ws.py # WebSocket 首帧 DOM python examples/check_click.py # 端到端点击交互 ``` 已实测:默认 Granian 与可选 Tornado 两种后端下,首页、静态资源、路径回退、 WebSocket 首帧、点击交互、进程退出均正常。 ## 许可 沿袭上游 Apache-2.0 许可证,原始版权归 Marius Nita 及 Hyperdiv 贡献者所有。