seerapi-models
SeerAPI 数据模型/ORM 定义，用于前后端开发。
安装
使用 uv：
uv add seerapi-models
或者使用 pip：
pip install seerapi-models
也可以使用其他包管理器，如 poetry 等。
使用
from seerapi_models import Item, ItemORM, ItemCategory, ResourceRef
category_ref = ResourceRef.from_model(ItemCategory, id=1) # 定义物品分类字段引用
item = Item(
id=1,
name="Item 1",
max=100,
category=catgeory_ref
)
print(item.name)
assert isinstance(item.to_orm(), ItemORM) # 转换为 ORM 模型
开发环境部署
本包是 SeerAPI monorepo 的一部分。推荐从 monorepo 根目录进行开发。
使用 uv 部署
-
安装 uv
# macOS/Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
-
克隆 monorepo
git clone https://github.com/SeerAPI/seerapi.git cd seerapi
-
安装依赖
# 同步所有工作区依赖 uv sync
-
运行开发环境
# 仅在本包环境中运行 uv run --package seerapi-models python # 运行测试 uv run --package seerapi-models pytest # 运行代码检查 uv run ruff check . uv run ruff format .
开发容器 (推荐)
项目提供了 Dev Container 配置，支持一键部署开发环境：
- 使用 VS Code 打开 monorepo 根目录
- 安装 Dev Containers 扩展
- 按
Ctrl+Shift+P打开命令面板 - 选择 "Dev Containers: Reopen in Container"
容器会自动安装：
- Python 3.10
- uv 包管理器
- pnpm 包管理器
- Ruff 代码检查工具
- 相关 VS Code 扩展
环境要求
- Python >= 3.10
- uv（推荐使用最新版）
许可证
本项目基于 MIT License 开源。
1 maintainer
Metadata
1 maintainer
Release files for seerapi-models 106.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| seerapi_models-106.9.0.tar.gz | 34.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| seerapi_models-106.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 91.4 kB
Release files / seerapi_models-106.9.0.tar.gz
| Download URL | seerapi_models-106.9.0.tar.gz |
|---|---|
| Size | 34.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fc8bd8b27e39d2d655eee769c72c097d16351263a8cc470dd638d228160aa80f
|
|
BLAKE2b-256 checksum How to use checksums |
261410b9eb488cde93ceda093e306befeccc70f9661784cb98f55d81d3e6e571
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / seerapi_models-106.9.0-py3-none-any.whl
| Download URL | seerapi_models-106.9.0-py3-none-any.whl |
|---|---|
| Size | 56.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
40784d00d00ca0d5677c20c83b12c2fce08154bb89f907962382c770db64f203
|
|
BLAKE2b-256 checksum How to use checksums |
55f17005c75279079eeb9939ae359dd77d06f5dc0c43b3d6f54daab21e0a26ba
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.9 {"installer":{"name":"uv","version":"0.12.9","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
