aury-boot 0.0.33__py3-none-any.whl → 0.0.34__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.33'
-__version_tuple__ = version_tuple = (0, 0, 33)
+__version__ = version = '0.0.34'
+__version_tuple__ = version_tuple = (0, 0, 34)
 
 __commit_id__ = commit_id = None

aury/boot/commands/templates/generate/repository.py.tpl

@@ -11,8 +11,9 @@ class {class_name}Repository(BaseRepository[{class_name}]):
     继承 BaseRepository 自动获得：
     - get(id): 按 ID 获取
     - get_by(**filters): 按条件获取单个
-    - list(skip, limit, **filters): 获取列表
-    - paginate(params, **filters): 分页获取
+    - list(skip, limit, sort, **filters): 获取列表
+    - paginate(pagination, sort, **filters): 分页获取
+    - stream(batch_size, sort, **filters): 流式查询
     - create(data): 创建
     - update(entity, data): 更新
     - delete(entity, soft=True): 删除

aury/boot/commands/templates/project/aury_docs/02-repository.md.tpl

@@ -5,7 +5,7 @@
 **文件**: `{package_name}/repositories/user_repository.py`
 
 ```python
-"""User 数据访问层。"""
+"""“User 数据访问层。"""
 
 from aury.boot.domain.repository.impl import BaseRepository
 
@@ -18,13 +18,14 @@ class UserRepository(BaseRepository[User]):
     继承 BaseRepository 自动获得：
     - get(id): 按 ID 获取
     - get_by(**filters): 按条件获取单个
-    - list(skip, limit, **filters): 获取列表
-    - paginate(params, **filters): 分页获取
+    - list(skip, limit, sort, **filters): 获取列表
+    - paginate(pagination, sort, **filters): 分页获取
     - count(**filters): 计数
     - exists(**filters): 是否存在
     - create(data): 创建
     - update(entity, data): 更新
     - delete(entity, soft=True): 删除（默认软删除）
+    - stream(batch_size, sort, **filters): 流式查询
     - batch_create(data_list): 批量创建
     - bulk_insert(data_list): 高性能批量插入
     """
@@ -35,7 +36,7 @@ class UserRepository(BaseRepository[User]):
 
     async def list_active(self, skip: int = 0, limit: int = 100) -> list[User]:
         """获取激活用户列表。"""
-        return await self.list(skip=skip, limit=limit, is_active=True)
+        return await self.list(skip=skip, limit=limit, sort="-created_at", is_active=True)
 ```
 
 ## 2.2 BaseRepository 方法详解
@@ -50,25 +51,36 @@ repo = UserRepository(session, User)
 user = await repo.get(user_id)                    # 按 ID（支持 int/UUID）
 user = await repo.get_by(email="a@b.com")         # 按条件（简单 AND 过滤）
 users = await repo.list(skip=0, limit=10)         # 列表
+users = await repo.list(sort="-created_at")       # 带排序
 users = await repo.list(is_active=True)           # 带过滤
 count = await repo.count(is_active=True)          # 计数
 exists = await repo.exists(email="a@b.com")       # 是否存在
 
 # === 分页 ===
-from aury.boot.domain.pagination import PaginationParams, SortParams
+from aury.boot.domain.pagination import PaginationParams
 
+# 方式1: offset/limit（与 SQL 语义一致）
 result = await repo.paginate(
-    pagination_params=PaginationParams(page=1, page_size=20),
-    sort_params=SortParams.from_string("-created_at"),
+    pagination=PaginationParams(offset=0, limit=20),
+    sort="-created_at",
+    is_active=True,
+)
+
+# 方式2: page/size（UI 风格）
+result = await repo.paginate(
+    pagination=PaginationParams.of(page=1, size=20),
+    sort="-created_at",
     is_active=True,
 )
 
 # PaginationResult 结构：
 # - result.items: list[T]      # 数据列表
 # - result.total: int          # 总记录数
-# - result.page: int           # 当前页码
-# - result.page_size: int      # 每页数量
-# - result.total_pages: int    # 总页数
+# - result.offset: int         # 当前偏移量
+# - result.limit: int          # 每页数量
+# - result.page: int           # 当前页码（计算属性）
+# - result.size: int           # limit 别名
+# - result.total_pages: int    # 总页数（计算属性）
 # - result.has_next: bool      # 是否有下一页
 # - result.has_prev: bool      # 是否有上一页
 
@@ -96,11 +108,11 @@ result = await repo.cursor_paginate(
 
 # === 流式查询（大数据处理） ===
 # 逐条流式处理，不会一次性加载到内存
-async for user in repo.stream(batch_size=1000, is_active=True):
+async for user in repo.stream(batch_size=1000, sort="-created_at", is_active=True):
     await process(user)
 
 # 批量流式处理
-async for batch in repo.stream_batches(batch_size=1000):
+async for batch in repo.stream_batches(batch_size=1000, sort="id"):
     await bulk_sync_to_es(batch)
 
 # === 创建 ===
@@ -140,27 +152,28 @@ user = await repo.get_by(status__ne="archived")
 
 > 注意：filters 条件之间用 AND 组合；如需 AND/OR/NOT 的复杂组合，请使用 `QueryBuilder`（见 2.4）。
 
-### 2.2.2 排序参数（SortParams）
+### 2.2.2 排序参数（sort）
 
-`SortParams.from_string()` 支持两种语法：
+所有查询方法的 `sort` 参数支持多种格式：
 
 ```python
-from aury.boot.domain.pagination import SortParams
+# 字符串（推荐）
+await repo.list(sort="-created_at")                    # 简洁语法
+await repo.list(sort="-created_at,priority")           # 多字段
+await repo.list(sort="created_at:desc,priority:asc")  # 完整语法
 
-# 简洁语法："-" 前缀表示降序
-sort_params = SortParams.from_string("-created_at")
-sort_params = SortParams.from_string("-created_at,priority")  # 多字段
+# 字符串列表
+await repo.list(sort=["-created_at", "name"])
 
-# 完整语法：字段:方向
-sort_params = SortParams.from_string("created_at:desc,priority:asc")
+# SortParams 对象（需要白名单验证时）
+from aury.boot.domain.pagination import SortParams
 
-# 带字段白名单验证（防止 SQL 注入）
 ALLOWED_FIELDS = {{"id", "created_at", "priority", "status"}}
 sort_params = SortParams.from_string(
     "-created_at",
-    allowed_fields=ALLOWED_FIELDS
+    allowed_fields=ALLOWED_FIELDS  # 传入非法字段抛 ValueError
 )
-# 传入非法字段会抛出 ValueError
+await repo.list(sort=sort_params)
 ```
 
 ### 2.2.3 查询全部（limit=None）

aury/boot/domain/pagination/__init__.py

@@ -14,61 +14,49 @@ from pydantic import BaseModel, Field, field_validator
 class PaginationParams(BaseModel):
     """分页参数。
     
-    定义分页查询的参数，包括页码和每页记录数。
-    """
-    
-    page: int = Field(default=1, ge=1, description="页码，从1开始")
-    page_size: int = Field(default=20, ge=1, le=100, description="每页记录数，最大100")
+    使用 offset/limit 模式，与 SQL 语义一致。
+    提供 `of()` 方法支持 page/size 风格的输入。
     
-    @property
-    def offset(self) -> int:
-        """计算偏移量。
+    示例:
+        # 方式1: offset/limit（底层/API风格）
+        params = PaginationParams(offset=20, limit=10)
         
-        Returns:
-            int: 偏移量
-        """
-        return (self.page - 1) * self.page_size
+        # 方式2: page/size（UI风格）
+        params = PaginationParams.of(page=3, size=10)
+    """
     
-    @property
-    def limit(self) -> int:
-        """获取限制数量。
-        
-        Returns:
-            int: 限制数量
-        """
-        return self.page_size
+    offset: int = Field(default=0, ge=0, description="偏移量")
+    limit: int = Field(default=20, ge=1, le=100, description="每页记录数，最大100")
     
-    @field_validator("page")
     @classmethod
-    def validate_page(cls, v: int) -> int:
-        """验证页码。
+    def of(cls, page: int = 1, size: int = 20) -> "PaginationParams":
+        """从 page/size 构造分页参数。
         
         Args:
-            v: 页码值
+            page: 页码，从 1 开始
+            size: 每页记录数
             
         Returns:
-            int: 验证后的页码
-        """
-        if v < 1:
-            raise ValueError("页码必须大于0")
-        return v
-    
-    @field_validator("page_size")
-    @classmethod
-    def validate_page_size(cls, v: int) -> int:
-        """验证每页记录数。
-        
-        Args:
-            v: 每页记录数
+            PaginationParams: 分页参数对象
             
-        Returns:
-            int: 验证后的每页记录数
+        Raises:
+            ValueError: 当 page < 1 或 size 无效时
         """
-        if v < 1:
-            raise ValueError("每页记录数必须大于0")
-        if v > 100:
-            raise ValueError("每页记录数不能超过100")
-        return v
+        if page < 1:
+            raise ValueError("页码必须大于 0")
+        return cls(offset=(page - 1) * size, limit=size)
+    
+    @property
+    def page(self) -> int:
+        """当前页码（从 1 开始）。"""
+        if self.limit == 0:
+            return 1
+        return self.offset // self.limit + 1
+    
+    @property
+    def size(self) -> int:
+        """每页记录数（limit 的别名）。"""
+        return self.limit
 
 
 class SortParams(BaseModel):
@@ -103,7 +91,7 @@ class SortParams(BaseModel):
         sort_str: str | None,
         *,
         allowed_fields: set[str] | None = None,
-        default_direction: str = "desc",
+        default_direction: str = "asc",
     ) -> SortParams:
         """从字符串解析排序参数。
         
@@ -124,7 +112,7 @@ class SortParams(BaseModel):
             
         示例:
             >>> SortParams.from_string("-created_at,priority")
-            SortParams(sorts=[('created_at', 'desc'), ('priority', 'desc')])
+            SortParams(sorts=[('created_at', 'desc'), ('priority', 'asc')])
             
             >>> SortParams.from_string("created_at:desc,priority:asc")
             SortParams(sorts=[('created_at', 'desc'), ('priority', 'asc')])
@@ -233,66 +221,76 @@ class PaginationResult[ModelType](BaseModel):
     """分页结果。
     
     封装分页查询的结果，包括数据列表和分页信息。
+    同时提供 offset/limit 和 page/size 两种风格的字段。
     """
     
     items: list[ModelType] = Field(description="数据列表")
     total: int = Field(ge=0, description="总记录数")
-    page: int = Field(ge=1, description="当前页码")
-    page_size: int = Field(ge=1, description="每页记录数")
-    total_pages: int = Field(ge=0, description="总页数")
+    offset: int = Field(ge=0, description="当前偏移量")
+    limit: int = Field(ge=1, description="每页记录数")
     has_next: bool = Field(description="是否有下一页")
     has_prev: bool = Field(description="是否有上一页")
     
+    @property
+    def page(self) -> int:
+        """当前页码（从 1 开始）。"""
+        if self.limit == 0:
+            return 1
+        return self.offset // self.limit + 1
+    
+    @property
+    def size(self) -> int:
+        """每页记录数（limit 的别名）。"""
+        return self.limit
+    
+    @property
+    def total_pages(self) -> int:
+        """总页数。"""
+        if self.limit == 0:
+            return 0
+        return (self.total + self.limit - 1) // self.limit
+    
     @classmethod
     def create(
         cls,
         items: list[ModelType],
         total: int,
-        pagination_params: PaginationParams
-    ) -> PaginationResult[ModelType]:
+        pagination: PaginationParams,
+    ) -> "PaginationResult[ModelType]":
         """创建分页结果。
         
         Args:
             items: 数据列表
             total: 总记录数
-            pagination_params: 分页参数
+            pagination: 分页参数
             
         Returns:
             PaginationResult[ModelType]: 分页结果
         """
-        total_pages = (total + pagination_params.page_size - 1) // pagination_params.page_size
-        has_next = pagination_params.page < total_pages
-        has_prev = pagination_params.page > 1
+        has_next = pagination.offset + pagination.limit < total
+        has_prev = pagination.offset > 0
         
         return cls(
             items=items,
             total=total,
-            page=pagination_params.page,
-            page_size=pagination_params.page_size,
-            total_pages=total_pages,
+            offset=pagination.offset,
+            limit=pagination.limit,
             has_next=has_next,
             has_prev=has_prev,
         )
     
     def get_next_params(self) -> PaginationParams | None:
-        """获取下一页的分页参数。
-        
-        Returns:
-            PaginationParams | None: 下一页的分页参数，如果没有下一页则返回None
-        """
+        """获取下一页的分页参数。"""
         if not self.has_next:
             return None
-        return PaginationParams(page=self.page + 1, page_size=self.page_size)
+        return PaginationParams(offset=self.offset + self.limit, limit=self.limit)
     
     def get_prev_params(self) -> PaginationParams | None:
-        """获取上一页的分页参数。
-        
-        Returns:
-            PaginationParams | None: 上一页的分页参数，如果没有上一页则返回None
-        """
+        """获取上一页的分页参数。"""
         if not self.has_prev:
             return None
-        return PaginationParams(page=self.page - 1, page_size=self.page_size)
+        new_offset = max(0, self.offset - self.limit)
+        return PaginationParams(offset=new_offset, limit=self.limit)
 
 
 class CursorPaginationParams(BaseModel):

aury/boot/domain/repository/impl.py

@@ -224,45 +224,113 @@ class BaseRepository[ModelType: Base](IRepository[ModelType]):
         result = await self._session.execute(query)
         return result.scalar_one_or_none()
     
-    async def list(self, skip: int = 0, limit: int | None = 100, **filters) -> list[ModelType]:
+    async def list(
+        self,
+        skip: int = 0,
+        limit: int | None = None,
+        sort: str | SortParams | list[str] | None = None,
+        **filters
+    ) -> list[ModelType]:
+        """获取实体列表。
+        
+        Args:
+            skip: 跳过记录数
+            limit: 返回记录数限制，None 表示不限制（默认）
+            sort: 排序参数，支持多种格式：
+                - 字符串: "-created_at" 或 "created_at:desc" 或 "-created_at,name"
+                - SortParams 对象
+                - 字符串列表: ["-created_at", "name"]
+            **filters: 过滤条件
+            
+        Returns:
+            list[ModelType]: 实体列表
+        """
         query = self._build_base_query()
         query = self._apply_filters(query, **filters)
+        query = self._apply_sort(query, sort)
         query = query.offset(skip)
         if limit is not None:
             query = query.limit(limit)
         result = await self._session.execute(query)
         return list(result.scalars().all())
     
+    def _apply_sort(
+        self,
+        query: Select,
+        sort: str | SortParams | list[str] | None,
+    ) -> Select:
+        """应用排序参数到查询。
+        
+        Args:
+            query: SQLAlchemy 查询对象
+            sort: 排序参数，支持：
+                - 字符串: "-created_at" 或 "created_at:desc" 或 "-created_at,name"
+                - SortParams 对象
+                - 字符串列表: ["-created_at", "name"]
+                
+        Returns:
+            Select: 应用排序后的查询对象
+        """
+        if sort is None:
+            return query
+        
+        # 统一转换为 SortParams
+        sort_params: SortParams
+        if isinstance(sort, SortParams):
+            sort_params = sort
+        elif isinstance(sort, str):
+            sort_params = SortParams.from_string(sort)
+        elif isinstance(sort, list):
+            # 列表格式: ["-created_at", "name"]
+            sort_params = SortParams.from_string(",".join(sort))
+        else:
+            return query
+        
+        order_by_list = []
+        for field, direction in sort_params.sorts:
+            field_attr = getattr(self._model_class, field, None)
+            if field_attr is not None:
+                if direction == "desc":
+                    order_by_list.append(field_attr.desc())
+                else:
+                    order_by_list.append(field_attr)
+        
+        if order_by_list:
+            query = query.order_by(*order_by_list)
+        
+        return query
+    
     async def paginate(
         self,
-        pagination_params: PaginationParams,
-        sort_params: SortParams | None = None,
+        pagination: PaginationParams,
+        sort: str | SortParams | list[str] | None = None,
         **filters
     ) -> PaginationResult[ModelType]:
-        query = self._build_base_query()
-        query = self._apply_filters(query, **filters)
+        """分页查询（list 的语法糖）。
         
-        if sort_params:
-            order_by_list = []
-            for field, direction in sort_params.sorts:
-                field_attr = getattr(self._model_class, field, None)
-                if field_attr is not None:
-                    if direction == "desc":
-                        order_by_list.append(field_attr.desc())
-                    else:
-                        order_by_list.append(field_attr)
-            if order_by_list:
-                query = query.order_by(*order_by_list)
-        
-        query = query.offset(pagination_params.offset).limit(pagination_params.limit)
-        result = await self._session.execute(query)
-        items = list(result.scalars().all())
-        total_count = await self.count(**filters)
+        Args:
+            pagination: 分页参数
+            sort: 排序参数，支持多种格式：
+                - 字符串: "-created_at" 或 "created_at:desc" 或 "-created_at,name"
+                - SortParams 对象
+                - 字符串列表: ["-created_at", "name"]
+            **filters: 过滤条件
+            
+        Returns:
+            PaginationResult[ModelType]: 分页结果
+        """
+        items = await self.list(
+            skip=pagination.offset,
+            limit=pagination.limit,
+            sort=sort,
+            **filters
+        )
+        total = await self.count(**filters)
         
         return PaginationResult.create(
             items=items,
-            total=total_count,
-            pagination_params=pagination_params,
+            total=total,
+            pagination=pagination,
         )
     
     async def cursor_paginate(
@@ -374,6 +442,7 @@ class BaseRepository[ModelType: Base](IRepository[ModelType]):
     async def stream(
         self,
         batch_size: int = 1000,
+        sort: str | SortParams | list[str] | None = None,
         **filters
     ):
         """流式查询，使用数据库原生 server-side cursor。
@@ -382,17 +451,19 @@ class BaseRepository[ModelType: Base](IRepository[ModelType]):
         
         Args:
             batch_size: 每批次获取的记录数，默认 1000
+            sort: 排序参数（同 list）
             **filters: 过滤条件
             
         Yields:
             ModelType: 模型实例
             
         示例:
-            async for user in repo.stream(batch_size=500, status="active"):
+            async for user in repo.stream(batch_size=500, sort="-created_at", status="active"):
                 process(user)
         """
         query = self._build_base_query()
         query = self._apply_filters(query, **filters)
+        query = self._apply_sort(query, sort)
         
         async with self._session.stream_scalars(
             query.execution_options(yield_per=batch_size)
@@ -403,23 +474,26 @@ class BaseRepository[ModelType: Base](IRepository[ModelType]):
     async def stream_batches(
         self,
         batch_size: int = 1000,
+        sort: str | SortParams | list[str] | None = None,
         **filters
     ):
         """批量流式查询，每次返回一批数据。
         
         Args:
             batch_size: 每批次的记录数，默认 1000
+            sort: 排序参数（同 list）
             **filters: 过滤条件
             
         Yields:
             list[ModelType]: 一批模型实例
             
         示例:
-            async for batch in repo.stream_batches(batch_size=500):
+            async for batch in repo.stream_batches(batch_size=500, sort="id"):
                 bulk_process(batch)
         """
         query = self._build_base_query()
         query = self._apply_filters(query, **filters)
+        query = self._apply_sort(query, sort)
         
         async with self._session.stream_scalars(
             query.execution_options(yield_per=batch_size)
@@ -437,7 +511,10 @@ class BaseRepository[ModelType: Base](IRepository[ModelType]):
         return result.scalar_one()
     
     async def exists(self, **filters) -> bool:
-        return await self.count(**filters) > 0
+        """检查是否存在匹配的记录（比 count > 0 更高效）。"""
+        query = self._apply_filters(self._build_base_query(), **filters).limit(1)
+        result = await self._session.execute(query)
+        return result.scalar_one_or_none() is not None
     
     async def add(self, entity: ModelType) -> ModelType:
         self._session.add(entity)

aury/boot/domain/repository/interface.py

@@ -35,22 +35,41 @@ class IRepository[ModelType: Base](ABC):
         pass
     
     @abstractmethod
-    async def list(self, skip: int = 0, limit: int | None = 100, **filters) -> list[ModelType]:
-        """获取实体列表。limit=None 时返回全部记录（谨慎使用）。"""
+    async def list(
+        self,
+        skip: int = 0,
+        limit: int | None = None,
+        sort: str | SortParams | list[str] | None = None,
+        **filters
+    ) -> list[ModelType]:
+        """获取实体列表。
+        
+        Args:
+            skip: 跳过记录数
+            limit: 返回记录数限制，None 表示不限制（默认）
+            sort: 排序参数，支持多种格式：
+                - 字符串: "-created_at" 或 "created_at:desc" 或 "-created_at,name"
+                - SortParams 对象
+                - 字符串列表: ["-created_at", "name"]
+            **filters: 过滤条件
+            
+        Returns:
+            list[ModelType]: 实体列表
+        """
         pass
     
     @abstractmethod
     async def paginate(
         self,
-        pagination_params: PaginationParams,
-        sort_params: SortParams | None = None,
+        pagination: PaginationParams,
+        sort: str | SortParams | list[str] | None = None,
         **filters
     ) -> PaginationResult[ModelType]:
-        """分页获取实体列表。
+        """分页查询（list 的语法糖）。
         
         Args:
-            pagination_params: 分页参数
-            sort_params: 排序参数
+            pagination: 分页参数
+            sort: 排序参数，支持多种格式（同 list）
             **filters: 过滤条件
             
         Returns:

{aury_boot-0.0.33.dist-info → aury_boot-0.0.34.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.33
+Version: 0.0.34
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.33.dist-info → aury_boot-0.0.34.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=xrs8Qn_OZ3B9ijkPtzIwzsKzRxeJuFan8EOwBgLmnxE,706
+aury/boot/_version.py,sha256=lALZlyVk-nrQoV2VLZzOsgzhfEll5JRUW4TJRJXnR_o,706
 aury/boot/application/__init__.py,sha256=I2KqNVdYg2q5nlOXr0TtFGyHmhj4oWdaR6ZB73Mwg7Y,3041
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
@@ -58,7 +58,7 @@ aury/boot/commands/server/__init__.py,sha256=aP3bPNGn6wT8dHa_OmKw1Dexnxuvf0BhrGA
 aury/boot/commands/server/app.py,sha256=-A52dLgerab98IM50a-_ptFb0xlMvbdbhYjqoJIIIpU,15795
 aury/boot/commands/templates/generate/api.py.tpl,sha256=xTbk9uzn5IMtJ-SPMadjmOUNHoM3WoE6g-TIEsGHFUA,3153
 aury/boot/commands/templates/generate/model.py.tpl,sha256=knFwMyGZ7wMpzH4_bQD_V1hFTvmCb2H04G8p3s2xvyA,312
-aury/boot/commands/templates/generate/repository.py.tpl,sha256=xoEg6lPAaLIRDeFy4I0FBsPPVLSy91h6xosAlaCL_mM,590
+aury/boot/commands/templates/generate/repository.py.tpl,sha256=Uj9jNEI9Zn8W061FGFlRaIfAy9IhdassYH6noEjG0z0,662
 aury/boot/commands/templates/generate/schema.py.tpl,sha256=HIaY5B0UG_S188nQLrZDEJ0q73WPdb7BmCdc0tseZA4,545
 aury/boot/commands/templates/generate/service.py.tpl,sha256=2hwQ8e4a5d_bIMx_jGDobdmKPMFLBlfQrQVQH4Ym5k4,1842
 aury/boot/commands/templates/project/AGENTS.md.tpl,sha256=sp5qyzU-SGhgQCobpMW4EXRzpGsEsVdmJvspnKAP4AQ,10059
@@ -71,7 +71,7 @@ aury/boot/commands/templates/project/gitignore.tpl,sha256=OI0nt9u2E9EC-jAMoh3gpq
 aury/boot/commands/templates/project/main.py.tpl,sha256=Q61ve3o1VkNPv8wcQK7lUosne18JWYeItxoXVNNoYJM,1070
 aury/boot/commands/templates/project/aury_docs/00-overview.md.tpl,sha256=eOjtqMeKqZ8OgijrOwcpfpHhrhUvt_CiHPUtRG0dilA,2251
 aury/boot/commands/templates/project/aury_docs/01-model.md.tpl,sha256=1mQ3hGDxqEZjev4CD5-3dzYRFVonPNcAaStI1UBEUyM,6811
-aury/boot/commands/templates/project/aury_docs/02-repository.md.tpl,sha256=JfUVdrIgW7_J6JGCcB-_uP_x-gCtjKiewwGv4Xr44QI,7803
+aury/boot/commands/templates/project/aury_docs/02-repository.md.tpl,sha256=Pn3pT9RoBponTcc4tvepFkVcE8EKxu2F9JaHPJ_mDk8,8345
 aury/boot/commands/templates/project/aury_docs/03-service.md.tpl,sha256=SgfPAgLVi_RbMjSAe-m49jQOIr6vfUT8VF2V1E-qa3w,15098
 aury/boot/commands/templates/project/aury_docs/04-schema.md.tpl,sha256=ZwwKhUbLI--PEEmwnuo2fIZrhCEZagBN6fRNDTFCnNk,2891
 aury/boot/commands/templates/project/aury_docs/05-api.md.tpl,sha256=oPzda3V6ZPDDEW-5MwyzmsMRuu5mXrsRGEq3lj0M-58,2997
@@ -125,11 +125,11 @@ aury/boot/domain/models/__init__.py,sha256=f-atwliNjWZ3nfO3JJIi9RZae6umtQCg1ddST
 aury/boot/domain/models/base.py,sha256=hZHadZaOyTYMOVEteXudQJBqlLnE_HPyXV5rRvrMXJ0,2051
 aury/boot/domain/models/mixins.py,sha256=7s4m4fzt0vWX71aTHgsoagjxSZZZ4_xSea_m0D84P0Q,5309
 aury/boot/domain/models/models.py,sha256=hNze58wPZkZ8QG2_pyszDsyKNjz2UgiRDzmneiCWLQs,2728
-aury/boot/domain/pagination/__init__.py,sha256=HSU_NyLP-ij7ZDUi-ARSSvNkvhW1_wON2Zvu2QlF6HM,11890
+aury/boot/domain/pagination/__init__.py,sha256=TfGO_yY8sBEy6-wfKAjieDDURWWglU8bzNPjjT11ST4,11987
 aury/boot/domain/repository/__init__.py,sha256=dnmN8xFu1ASbLnzL6vx8gMoch7xBGxkJkxs9G1iGLGg,490
-aury/boot/domain/repository/impl.py,sha256=BeWe6pMBP_OvxX91FmckxAZlM2qejol06If_UBy8FtU,22016
+aury/boot/domain/repository/impl.py,sha256=Z0WSz__UDM5nmvI27YSw_atbAfi2KsnNiD_z8i6c9BA,24586
 aury/boot/domain/repository/interceptors.py,sha256=SCTjRmBYwevAMlJ8U1uw-_McsDetNNQ7q0Da5lmfj_E,1238
-aury/boot/domain/repository/interface.py,sha256=CmkiqVhhHPx_xcpuBCz11Vr26-govwYBxFsQ8myEVyw,2904
+aury/boot/domain/repository/interface.py,sha256=CQ3Wm3IREQ4SpmVvIgWhaIfsxVydcOZ_7OEG8NoG-SI,3472
 aury/boot/domain/repository/query_builder.py,sha256=pFErMzsBql-T6gBX0S4FxIheCkNaGjpSewzcJ2DxrUU,10890
 aury/boot/domain/service/__init__.py,sha256=ZRotaBlqJXn7ebPTQjjoHtorpQREk8AgTD69UCcRd1k,118
 aury/boot/domain/service/base.py,sha256=6sN0nf8r5yUZsE6AcZOiOXFCqzb61oCxTfrWlqjIo9I,2035
@@ -209,7 +209,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.33.dist-info/METADATA,sha256=pJ1jUTF2kmZXGKLj-gC0fF2i5Jj1Uq_tkRUjdqJMu-8,8694
-aury_boot-0.0.33.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.33.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.33.dist-info/RECORD,,
+aury_boot-0.0.34.dist-info/METADATA,sha256=G7zuo76pW5o3tFA3w4mVMTRddM_acSrcb9xuIEnHEf0,8694
+aury_boot-0.0.34.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.34.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.34.dist-info/RECORD,,