rb-commons 0.4.9__py3-none-any.whl → 0.4.11__py3-none-any.whl

rb_commons/orm/managers.py

@@ -180,6 +180,7 @@ class BaseManager(Generic[ModelType]):
 
         if self._limit:
             stmt = stmt.limit(self._limit)
+            self._limit = None
 
         return await self._execute_query_and_unique_data(stmt, load_all_relations)
 
@@ -188,6 +189,13 @@ class BaseManager(Generic[ModelType]):
         stmt = select(self.model).filter(and_(*self.filters)).limit(limit).offset(offset)
         return await self._execute_query_and_unique_data(stmt, load_all_relations)
 
+    def limit(self, value: int) -> 'BaseManager[ModelType]':
+        """
+        Set a limit on the number of results returned by queries like `all()` or `first()`.
+        """
+        self._limit = value
+        return self
+
     async def first(self, load_relations: Sequence[str] = None) -> Optional[ModelType]:
         """Return the first matching object, or None."""
         self._ensure_filtered()

rb_commons/schemes/pagination.py

@@ -0,0 +1,47 @@
+from typing import Generic, TypeVar, Optional
+from pydantic import BaseModel, Field
+
+T = TypeVar('T')
+
+class PaginationParams(BaseModel):
+    """Pagination parameters for querying."""
+    page: int = Field(default=1, ge=1, description="Page number")
+    per_page: int = Field(default=10, ge=1, le=100, description="Items per page")
+    sort_by: Optional[str] = Field(default=None, description="Field to sort by")
+    sort_order: Optional[str] = Field(default="desc", description="Sort order (asc/desc)")
+
+class PaginationMeta(BaseModel):
+    """Metadata for paginated responses."""
+    total: int = Field(..., description="Total number of items")
+    page: int = Field(..., description="Current page number")
+    per_page: int = Field(..., description="Items per page")
+    total_pages: int = Field(..., description="Total number of pages")
+    has_next: bool = Field(..., description="Whether there is a next page")
+    has_prev: bool = Field(..., description="Whether there is a previous page")
+
+class PaginatedResponse(BaseModel, Generic[T]):
+    """Generic paginated response."""
+    items: list[T] = Field(..., description="List of items")
+    meta: PaginationMeta = Field(..., description="Pagination metadata")
+
+    @classmethod
+    def create(
+        cls,
+        items: list[T],
+        total: int,
+        page: int,
+        per_page: int
+    ) -> "PaginatedResponse[T]":
+        """Create a paginated response with calculated metadata."""
+        total_pages = (total + per_page - 1) // per_page
+        return cls(
+            items=items,
+            meta=PaginationMeta(
+                total=total,
+                page=page,
+                per_page=per_page,
+                total_pages=total_pages,
+                has_next=page < total_pages,
+                has_prev=page > 1
+            )
+        )

{rb_commons-0.4.9.dist-info → rb_commons-0.4.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rb-commons
-Version: 0.4.9
+Version: 0.4.11
 Summary: Commons of project and simplified orm based on sqlalchemy.
 Home-page: https://github.com/RoboSell-organization/rb-commons
 Author: Abdulvoris

{rb_commons-0.4.9.dist-info → rb_commons-0.4.11.dist-info}/RECORD

@@ -11,15 +11,16 @@ rb_commons/http/consul.py,sha256=Ioq72VD1jGwoC96set7n2SgxN40olzI-myA2lwKkYi4,186
 rb_commons/http/exceptions.py,sha256=EGRMr1cRgiJ9Q2tkfANbf0c6-zzXf1CD6J3cmCaT_FA,1885
 rb_commons/orm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rb_commons/orm/exceptions.py,sha256=1aMctiEwrPjyehoXVX1l6ML5ZOhmDkmBISzlTD5ey1Y,509
-rb_commons/orm/managers.py,sha256=Z20gyT7JASAvWG7eXlFP9wvG_KroqFnPfcQabH9NVag,16021
+rb_commons/orm/managers.py,sha256=Q5nNAOPeTJvxlsG_OBrkBXiY2kfOhzrncXNap960Pw4,16286
 rb_commons/orm/services.py,sha256=71eRcJ4TxZvzNz-hLXo12X4U7PGK54ZfbLAb27AjZi8,1589
 rb_commons/permissions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rb_commons/permissions/role_permissions.py,sha256=HL50s5RHW1nk2U3-YTESg0EDGkJDu1vN4QchcfK-L5g,988
 rb_commons/schemes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rb_commons/schemes/jwt.py,sha256=F66JJDhholuOPPzlKeoC6f1TL4gXg4oRUrV5yheNpyo,1675
+rb_commons/schemes/pagination.py,sha256=8VZW1wZGJIPR9jEBUgppZUoB4uqP8ORudHkMwvEJSxg,1866
 rb_commons/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 rb_commons/utils/media.py,sha256=KNY_9SdRa3Rp7d3B1tZaXkhmzVa65RcS62BYwZP1bVM,332
-rb_commons-0.4.9.dist-info/METADATA,sha256=xMkxBD2ktROi4NXDnhUwfr89w5zxn4wBiM6SaBV1spM,6570
-rb_commons-0.4.9.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
-rb_commons-0.4.9.dist-info/top_level.txt,sha256=HPx_WAYo3_fbg1WCeGHsz3wPGio1ucbnrlm2lmqlJog,11
-rb_commons-0.4.9.dist-info/RECORD,,
+rb_commons-0.4.11.dist-info/METADATA,sha256=RA17ihwr48Z2P0aXTiVzoeXMRq66-WtT_ViKrRZfU5o,6571
+rb_commons-0.4.11.dist-info/WHEEL,sha256=CmyFI0kx5cdEMTLiONQRbGQwjIoR1aIYB7eCAQ4KPJ0,91
+rb_commons-0.4.11.dist-info/top_level.txt,sha256=HPx_WAYo3_fbg1WCeGHsz3wPGio1ucbnrlm2lmqlJog,11
+rb_commons-0.4.11.dist-info/RECORD,,