litestar-dataclasses

用途：在 Litestar 中用 Python dataclasses 定义传输层（请求/响应）模型，明确字段类型，避免模式含糊。主要能力：为传输边界定义 dataclass 字段；有意识地使用默认值与可选性；在写入/读取结构不一致时配合 DTO 配置；必要时将领域实体与传输 dataclass 分离。使用方式：定义带显式类型的 dataclass，例如：from dataclasses import dataclass；@dataclass class CreateUser 含 name: str 与 email: str；再配合 @post("/users") 的处理函数接收 data: CreateUser 并返回 dict。限制与规则：优先采用不可变或受控可变模式；不要在 dataclass 中嵌入持久化/会话行为；保持字段名与 schema 对客户端稳定；在序列化路径中验证嵌套 dataclass 行为。可用 litestar-dto 处理高级整形与嵌套字段策略，用 litestar-plugins 切换其他模型生态。官方参考：https://docs.litestar.dev/latest/usage/dto/index.html