rb-commons 0.4.10__tar.gz → 0.4.11__tar.gz

{rb_commons-0.4.10 → rb_commons-0.4.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rb-commons
-Version: 0.4.10
+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.11/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.10 → rb_commons-0.4.11}/rb_commons.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rb-commons
-Version: 0.4.10
+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.10 → rb_commons-0.4.11}/rb_commons.egg-info/SOURCES.txt

@@ -24,5 +24,6 @@ rb_commons/permissions/__init__.py
 rb_commons/permissions/role_permissions.py
 rb_commons/schemes/__init__.py
 rb_commons/schemes/jwt.py
+rb_commons/schemes/pagination.py
 rb_commons/utils/__init__.py
 rb_commons/utils/media.py

{rb_commons-0.4.10 → rb_commons-0.4.11}/setup.py

@@ -5,7 +5,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 
 setup(
     name="rb-commons",
-    version="0.4.10",
+    version="0.4.11",
     author="Abdulvoris",
     author_email="erkinovabdulvoris101@gmail.com",
     description="Commons of project and simplified orm based on sqlalchemy.",