SARepo 0.1.3__py3-none-any.whl → 0.1.4__py3-none-any.whl

SARepo/repo.py

@@ -14,3 +14,35 @@ class CrudRepository(Protocol, Generic[T]):
     def remove(self, entity: T) -> None: ...
     def delete_by_id(self, id_: Any) -> bool: ...
     def page(self, page: PageRequest, spec=None, order_by=None) -> Page[T]: ...
+    def get_all_by_column(
+        self,
+        column_name: str,
+        value: Any,
+        *,
+        limit: Optional[int] = None,
+        order_by=None,
+        include_deleted: bool = False,
+        **extra_filters
+    ) -> list[T]: ...
+    def find_all_by_column(
+        self,
+        column_name: str,
+        value: Any,
+        *,
+        limit: Optional[int] = None,
+        order_by=None,
+        include_deleted: bool = False,
+        **extra_filters
+    ) -> list[T]: ...
+    def get_or_create(
+        self,
+        defaults: Optional[dict] = None,
+        **unique_filters
+    ) -> tuple[T, bool]: ...
+    def raw_query(self, sql: str, params: Optional[dict] = None) -> list[dict]: ...
+    def aggregate_avg(self, column_name: str, **filters) -> Optional[float]: ...
+    def aggregate_min(self, column_name: str, **filters): ...
+    def aggregate_max(self, column_name: str, **filters): ...
+    def aggregate_sum(self, column_name: str, **filters): ... 
+    def count(self, **filters) -> int: ...
+    def restore(self, id_: Any) -> bool: ...

SARepo/sa_repo.py

@@ -2,11 +2,11 @@
 from typing import List, Type, Generic, TypeVar, Optional, Sequence, Any, Callable
 from sqlalchemy.orm import Session
 from sqlalchemy.ext.asyncio import AsyncSession
-from sqlalchemy import inspect, select, func
+from sqlalchemy import inspect, select, func, text
 from .base import PageRequest, Page, NotFoundError
 
 T = TypeVar("T")
-Spec = Callable  # aliased to match specs.Spec
+Spec = Callable
 
 class SARepository(Generic[T]):
     """Synchronous repository implementation for SQLAlchemy 2.x."""
@@ -14,6 +14,17 @@ class SARepository(Generic[T]):
         self.model = model
         self.session = session
 
+    def _resolve_column(self, column_name: str):
+        try:
+            return getattr(self.model, column_name)
+        except AttributeError as e:
+            raise ValueError(f"Model {self.model.__name__} has no column '{column_name}'") from e
+
+    def _apply_filters(self, stmt, **filters):
+        if filters:
+            stmt = stmt.filter_by(**filters)
+        return stmt
+
     def _select(self):
         return select(self.model)
 
@@ -78,13 +89,139 @@ class SARepository(Generic[T]):
             stmt.offset(page.page * page.size).limit(page.size)
         ).scalars().all()
         return Page(items, total, page.page, page.size)
+    
+    def get_all_by_column(
+        self,
+        column_name: str,
+        value: Any,
+        *,
+        limit: Optional[int] = None,
+        order_by=None,
+        include_deleted: bool = False,
+        **extra_filters
+    ) -> list[T]:
+        col = self._resolve_column(column_name)
+        stmt = select(self.model).where(col == value)
+        if not include_deleted and hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        stmt = self._apply_filters(stmt, **extra_filters)
+        if order_by is not None:
+            stmt = stmt.order_by(order_by)
+        if limit is not None:
+            stmt = stmt.limit(limit)
+        res = self.session.execute(stmt)
+        return res.scalars().all()
+    
+    # Alias 
+    def find_all_by_column(self, *args, **kwargs):
+        return self.get_all_by_column(*args, **kwargs)
+    
+    def get_or_create(
+        self,
+        defaults: Optional[dict] = None,
+        **unique_filters
+    ) -> tuple[T, bool]:
+        """
+        Возвращает (obj, created). unique_filters определяют уникальность.
+        defaults дополняют поля при создании.
+        """
+        stmt = select(self.model).filter_by(**unique_filters)
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        obj = self.session.execute(stmt).scalar_one_or_none()
+        if obj:
+            return obj, False
+        payload = {**unique_filters, **(defaults or {})}
+        obj = self.model(**payload)  # type: ignore[call-arg]
+        self.session.add(obj)
+        self.session.flush()
+        self.session.refresh(obj)
+        return obj, True
+
+    def raw_query(self, sql: str, params: Optional[dict] = None) -> list[dict]:
+        """
+        Безопасно выполняет сырой SQL (используй плейсхолдеры :name).
+        Возвращает список dict (строки).
+        """
+        res = self.session.execute(text(sql), params or {})
+        # mapping() -> RowMapping (dict-like)
+        return [dict(row) for row in res.mappings().all()]
+
+    def aggregate_avg(self, column_name: str, **filters) -> Optional[float]:
+        col = self._resolve_column(column_name)
+        stmt = select(func.avg(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        stmt = self._apply_filters(stmt, **filters)
+        return self.session.execute(stmt).scalar()
+
+    def aggregate_min(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.min(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return self.session.execute(stmt).scalar()
+
+    def aggregate_max(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.max(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return self.session.execute(stmt).scalar()
+
+    def aggregate_sum(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.sum(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return self.session.execute(stmt).scalar()
+
+    def count(self, **filters) -> int:
+        stmt = select(func.count()).select_from(self.model)
+        if hasattr(self.model, "is_deleted") and not filters.pop("include_deleted", False):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        if filters:
+            stmt = stmt.filter_by(**filters)
+        return int(self.session.execute(stmt).scalar_one())
+
+    def restore(self, id_: Any) -> bool:
+        """
+        Для soft-delete: is_deleted=False. Возвращает True, если восстановили.
+        """
+        if not hasattr(self.model, "is_deleted"):
+            raise RuntimeError(f"{self.model.__name__} has no 'is_deleted' field")
+        obj = self.session.get(self.model, id_)
+        if not obj:
+            return False
+        if getattr(obj, "is_deleted", False):
+            setattr(obj, "is_deleted", False)
+            self.session.flush()
+            return True
+        return False
 
 class SAAsyncRepository(Generic[T]):
     """Async repository implementation for SQLAlchemy 2.x."""
     def __init__(self, model: Type[T], session: AsyncSession):
         self.model = model
         self.session = session
-        
+    
+    def _resolve_column(self, column_name: str):
+        try:
+            return getattr(self.model, column_name)
+        except AttributeError as e:
+            raise ValueError(f"Model {self.model.__name__} has no column '{column_name}'") from e
+
+    def _apply_filters(self, stmt, **filters):
+        if filters:
+            stmt = stmt.filter_by(**filters)
+        return stmt
+    
+    def _select(self):
+        return select(self.model)
+    
     async def getAll(self, limit: Optional[int] = None) -> List[T]:
         stmt = select(self.model)
         if limit is not None:
@@ -92,9 +229,6 @@ class SAAsyncRepository(Generic[T]):
         result = await self.session.execute(stmt)
         return result.scalars().all()
 
-    def _select(self):
-        return select(self.model)
-
     async def get(self, id_: Any) -> T:
         obj = await self.session.get(self.model, id_)
         if not obj:
@@ -150,3 +284,104 @@ class SAAsyncRepository(Generic[T]):
         )
         items = res.scalars().all()
         return Page(items, total, page.page, page.size)
+    
+    async def get_all_by_column(
+        self,
+        column_name: str,
+        value: Any,
+        *,
+        limit: Optional[int] = None,
+        order_by=None,
+        include_deleted: bool = False,
+        **extra_filters
+    ) -> list[T]:
+        col = self._resolve_column(column_name)
+        stmt = select(self.model).where(col == value)
+        if not include_deleted and hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        stmt = self._apply_filters(stmt, **extra_filters)
+        if order_by is not None:
+            stmt = stmt.order_by(order_by)
+        if limit is not None:
+            stmt = stmt.limit(limit)
+        res = await self.session.execute(stmt)
+        return res.scalars().all()
+
+    # Alias
+    async def find_all_by_column(self, *args, **kwargs):
+        return await self.get_all_by_column(*args, **kwargs)
+    
+    async def get_or_create(
+        self,
+        defaults: Optional[dict] = None,
+        **unique_filters
+    ) -> tuple[T, bool]:
+        stmt = select(self.model).filter_by(**unique_filters)
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        obj = (await self.session.execute(stmt)).scalar_one_or_none()
+        if obj:
+            return obj, False
+        payload = {**unique_filters, **(defaults or {})}
+        obj = self.model(**payload)  # type: ignore[call-arg]
+        self.session.add(obj)
+        await self.session.flush()
+        await self.session.refresh(obj)
+        return obj, True
+
+    async def raw_query(self, sql: str, params: Optional[dict] = None) -> list[dict]:
+        res = await self.session.execute(text(sql), params or {})
+        return [dict(row) for row in res.mappings().all()]
+
+    async def aggregate_avg(self, column_name: str, **filters) -> Optional[float]:
+        col = self._resolve_column(column_name)
+        stmt = select(func.avg(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        stmt = self._apply_filters(stmt, **filters)
+        return (await self.session.execute(stmt)).scalar()
+
+    async def aggregate_min(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.min(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return (await self.session.execute(stmt)).scalar()
+
+    async def aggregate_max(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.max(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return (await self.session.execute(stmt)).scalar()
+
+    async def aggregate_sum(self, column_name: str, **filters):
+        col = self._resolve_column(column_name)
+        stmt = select(func.sum(col))
+        if hasattr(self.model, "is_deleted"):
+            stmt = stmt.where(self.model.is_deleted == False)
+        stmt = self._apply_filters(stmt, **filters)
+        return (await self.session.execute(stmt)).scalar()
+
+    async def count(self, **filters) -> int:
+        include_deleted = bool(filters.pop("include_deleted", False))
+        stmt = select(func.count()).select_from(self.model)
+        if hasattr(self.model, "is_deleted") and not include_deleted:
+            stmt = stmt.where(self.model.is_deleted == False)  # noqa: E712
+        if filters:
+            stmt = stmt.filter_by(**filters)
+        return int((await self.session.execute(stmt)).scalar_one())
+
+    async def restore(self, id_: Any) -> bool:
+        if not hasattr(self.model, "is_deleted"):
+            raise RuntimeError(f"{self.model.__name__} has no 'is_deleted' field")
+        obj = await self.session.get(self.model, id_)
+        if not obj:
+            return False
+        if getattr(obj, "is_deleted", False):
+            setattr(obj, "is_deleted", False)
+            await self.session.flush()
+            return True
+        return False

{sarepo-0.1.3.dist-info → sarepo-0.1.4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: SARepo
-Version: 0.1.3
+Version: 0.1.4
 Summary: Minimal, explicit Repository & Unit-of-Work layer over SQLAlchemy 2.x
 Author: nurbergenovv
 License: MIT

sarepo-0.1.4.dist-info/RECORD

@@ -0,0 +1,12 @@
+SARepo/__init__.py,sha256=tNYbuUDloC1qVnXq7uomS3jRcaPUvy0VEZiMdYR6x1M,183
+SARepo/base.py,sha256=UbAdZ9WYh_o93mrCVL3D8Q0tY_8mvm0HspO_L5m0GTQ,874
+SARepo/models.py,sha256=ypSmbKAijvNH4WjSeJBgyNT8mKa_e_7-I5kiNisjGAI,570
+SARepo/repo.py,sha256=WogRS4Ku2DppkLASJdPgK-POBUrUmao9E3NBEiSX2-4,1655
+SARepo/sa_repo.py,sha256=NSv1UyI6zZ5O_wn0QSq__T5e-lnDGhm5HxtkyDynEe0,14926
+SARepo/specs.py,sha256=e-X1cCkva3e71M37hcfbjNDMezZAaOkkRaPToUzhEeU,687
+SARepo/uow.py,sha256=yPlvi7PoH9x2pLNt6hEin9zT5qG9axUKn_TkZcIuz1s,859
+sarepo-0.1.4.dist-info/licenses/LICENSE,sha256=px90NOQCrnZ77qoFT8IvAiNS1CXQ2OU27uVBKbki9DM,131
+sarepo-0.1.4.dist-info/METADATA,sha256=D6lgXeMHrohYrdko9BZPOF9W2e3F7u4-hFYrP6qnXFU,2691
+sarepo-0.1.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+sarepo-0.1.4.dist-info/top_level.txt,sha256=0k952UYVZLIIv3kZzFlxI0yzBMusZo3-XCQtxms_kS0,7
+sarepo-0.1.4.dist-info/RECORD,,

sarepo-0.1.3.dist-info/RECORD

@@ -1,12 +0,0 @@
-SARepo/__init__.py,sha256=tNYbuUDloC1qVnXq7uomS3jRcaPUvy0VEZiMdYR6x1M,183
-SARepo/base.py,sha256=UbAdZ9WYh_o93mrCVL3D8Q0tY_8mvm0HspO_L5m0GTQ,874
-SARepo/models.py,sha256=ypSmbKAijvNH4WjSeJBgyNT8mKa_e_7-I5kiNisjGAI,570
-SARepo/repo.py,sha256=5Af4SLfbKOMJdX7MOev4OcGIGQ0HzN6QDUktURjasyU,597
-SARepo/sa_repo.py,sha256=feuwBHAEdW_STJ6fHxYlSO0KvSruoqiB_v1sTCRy6JE,5332
-SARepo/specs.py,sha256=e-X1cCkva3e71M37hcfbjNDMezZAaOkkRaPToUzhEeU,687
-SARepo/uow.py,sha256=yPlvi7PoH9x2pLNt6hEin9zT5qG9axUKn_TkZcIuz1s,859
-sarepo-0.1.3.dist-info/licenses/LICENSE,sha256=px90NOQCrnZ77qoFT8IvAiNS1CXQ2OU27uVBKbki9DM,131
-sarepo-0.1.3.dist-info/METADATA,sha256=FXf9N-SsghCIQGucviE8GVVxh1viF0BV0FhKkMeg2HQ,2691
-sarepo-0.1.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-sarepo-0.1.3.dist-info/top_level.txt,sha256=0k952UYVZLIIv3kZzFlxI0yzBMusZo3-XCQtxms_kS0,7
-sarepo-0.1.3.dist-info/RECORD,,