Advanced Alchemy Repositories：Litestar SQLAlchemy 数据仓库最佳实践指南
advanced-alchemy-repositories by alti3/litestar-skills
安装命令
npx skills add https://github.com/alti3/litestar-skills --skill advanced-alchemy-repositories🇨🇳中文介绍
代码仓库
执行流程
- 选择与运行时匹配的基础仓库类：
SQLAlchemyAsyncRepository、SQLAlchemySyncRepository，或其 slug 或 query 变体。 - 立即设置
model_type并保持仓库的模型特定性。 - 对于列表端点，使用内置过滤器和
list_and_count()，而不是重新实现分页逻辑。 - 当工作负载是批量形式时，使用批量辅助函数进行插入、更新、更新插入和删除操作。
- 除非框架集成明确处理提交行为，否则将事务所有权保持在仓库外部。
实现规则
- 保持仓库专注于持久化和查询组合，而不是 HTTP 契约。
- 优先使用仓库子类，而不是在多个处理器中重复分散的临时辅助函数。
- 仅当自定义 SQL 或聚合工作与标准 CRUD 有实质性不同时，才使用查询仓库。
- 保持加载器选项明确，以便关系行为可预测。
示例模式
from advanced_alchemy.repository import SQLAlchemyAsyncRepository
class PostRepository(SQLAlchemyAsyncRepository[Post]):
model_type = Post
验证清单
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者，精准高效
