Metadata-Version: 2.1
Name: ys_base
Version: 0.1.4
Summary: YS 统一 SDK：契约模型 / auth 客户端与差量同步 / 应用服务骨架 / 交易网关
Author-email: ys <popsars@gmail.com>
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: pydantic>=2.7,<3
Requires-Dist: websockets>=13,<16
Requires-Dist: loguru>=0.7,<1
Requires-Dist: aiosqlite>=0.20,<1
Requires-Dist: motor>=3.5,<4 ; extra == "mongo"
Requires-Dist: fastapi>=0.115,<1 ; extra == "server"
Requires-Dist: uvicorn[standard]>=0.30,<1 ; extra == "server"
Requires-Dist: pyjwt[crypto]>=2.9,<3 ; extra == "server"
Requires-Dist: aiohttp>=3.10,<4 ; extra == "trade"
Requires-Dist: certifi ; extra == "trade"
Requires-Dist: exchange-calendars>=4.5 ; extra == "trade"
Requires-Dist: pandas>=2.2 ; extra == "trade"
Requires-Dist: motor>=3.5,<4 ; extra == "trade"
Provides-Extra: mongo
Provides-Extra: server
Provides-Extra: trade

# ys_base

YS 统一 SDK：契约模型（contracts）、auth 客户端与差量同步（auth）、WebSocket RPC 基类（ws）、
本地存储（store，默认 SQLite）、子系统服务骨架（server，extra）、交易网关（trade，extra，P4 收编）。

```bash
pip install ys_base            # 契约 + auth 客户端 + SQLite 存储
pip install ys_base[server]    # + FastAPI 子系统骨架
pip install ys_base[trade]     # + 交易网关（纯策略系统只装这个）
```

使用 uv 添加依赖：

```bash
uv add ys_base             # 契约 + auth 客户端 + SQLite 存储
uv add "ys_base[server]"   # + FastAPI 子系统骨架
uv add "ys_base[trade]"    # + 交易网关（纯策略系统只装这个）
uv add "ys_base[trade]" --upgrade-package ys-base --index-url https://pypi.org/simple
```

设计文档：ys_auth/docs/架构方案.md（v6 终版）、契约初稿.md。

