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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rb-commons
-Version: 0.4.10
+Version: 0.4.12
 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.12}/rb_commons/orm/managers.py

@@ -103,6 +103,7 @@ class BaseManager(Generic[ModelType]):
              - __lte      (field__lte=value)
              - __in       (field__in=[val1, val2, ...])
              - __contains (field__contains='text')
+             - __null     (field__null=True/False) - True for IS NULL, False for IS NOT NULL
 
            Additionally supports nested paths, e.g.,
              product__shop_id=None
@@ -116,7 +117,7 @@ class BaseManager(Generic[ModelType]):
 
             operator = "eq"
 
-            if parts[-1] in {"eq", "ne", "gt", "lt", "gte", "lte", "in", "contains"}:
+            if parts[-1] in {"eq", "ne", "gt", "lt", "gte", "lte", "in", "contains", "null"}:
                 operator = parts.pop()
 
             current_attr = self.model
@@ -159,6 +160,12 @@ class BaseManager(Generic[ModelType]):
             elif operator == "contains":
                 # e.g., column ILIKE %value%
                 self.filters.append(current_attr.ilike(f"%{value}%"))
+                
+            elif operator == "null":
+                if value is True:
+                    self.filters.append(current_attr.is_(None))
+                else:
+                    self.filters.append(current_attr.isnot(None))
 
         return self
 

rb_commons-0.4.12/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.12}/rb_commons.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rb-commons
-Version: 0.4.10
+Version: 0.4.12
 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.12}/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.12}/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.12",
     author="Abdulvoris",
     author_email="erkinovabdulvoris101@gmail.com",
     description="Commons of project and simplified orm based on sqlalchemy.",