python-general-be-lib 0.5.2__py3-none-any.whl → 0.5.3__py3-none-any.whl

general/interface/repository/handler/__init__.py

@@ -2,4 +2,5 @@ from .base_handler import *
 from .ilike_handler import *
 from .interval_handler import *
 from .json_handler import *
+from .json_ilike_handler import *
 from .statement_manager import *

general/interface/repository/handler/json_ilike_handler.py

@@ -0,0 +1,104 @@
+__all__ = ["JsonILikeHandler"]
+
+from typing import Any
+
+from general.interface.repository.handler import BaseHandler
+from sqlalchemy import Column, Select, Update, Delete, or_
+from sqlalchemy.sql.base import ReadOnlyColumnCollection
+
+
+class JsonILikeHandler(BaseHandler):
+    """Handler per ricerche case-insensitive (ILIKE) su più colonne tramite un alias.
+
+    Permette di esporre un singolo parametro di ricerca testuale (es. ``"search"``)
+    che viene applicato come ``ILIKE '%value%'`` su un insieme di colonne con ``OR``.
+
+    Attributes:
+        ilike_aliases (list[str]): Chiavi nel dizionario ``where`` che attivano
+            la ricerca ILIKE (es. ``["search", "q"]``).
+        ilike_attributes (list[str]): Nomi delle colonne su cui applicare ILIKE
+            (es. ``["name", "surname", "email"]``).
+
+    Example:
+        >>> handler = JsonILikeHandler(
+        ...     columns=User.columns(),
+        ...     ilike_aliases=["search"],
+        ...     ilike_attributes=["name", "surname"]
+        ... )
+        >>> repo.find(where={"search": "mario"})
+        # WHERE name ILIKE '%mario%' OR surname ILIKE '%mario%'
+    """
+    __slots__ = "ilike_aliases", "ilike_attributes", "json_column", "json_ilike_keys"
+    ilike_aliases: list[str]
+    ilike_attributes: list[str]
+    json_ilike_keys: list[str]
+    json_column: str
+
+    def __init__(self, columns: ReadOnlyColumnCollection[str, Column[Any]], ilike_aliases: list[str] = None, ilike_attributes: list[str] = None):
+        """Inizializza l'handler validando che le colonne ILIKE esistano sull'entità.
+
+        Args:
+            columns (ReadOnlyColumnCollection): Colonne della tabella.
+            ilike_aliases (list[str], optional): Chiavi alias che attivano la ricerca.
+                Default: lista vuota.
+            ilike_attributes (list[str], optional): Colonne su cui applicare ILIKE.
+                Default: lista vuota.
+
+        Raises:
+            ValueError: Se uno degli ``ilike_attributes`` non è presente tra le colonne.
+        """
+        self.columns = columns
+        self.ilike_aliases = ilike_aliases if ilike_aliases is not None else []
+        self.ilike_attributes = []
+        self.json_ilike_keys = []
+
+        if ilike_attributes:
+            for ilike_attribute in ilike_attributes:
+                if ilike_attribute not in self.columns:
+                    self.json_ilike_keys.append(ilike_attribute)
+                else:
+                    self.ilike_attributes.append(ilike_attribute)
+
+        for key, column in columns.items():
+            try:
+                if column.type.python_type == dict:
+                    self.json_column = key
+                    break
+            except NotImplementedError:
+                continue
+
+    def handle(self, stmt: Select | Update | Delete, where: dict[str, Any] = None, **kwargs):
+        """Applica i filtri ILIKE allo statement per ogni alias trovato in ``where``.
+
+        Per ogni alias presente in ``ilike_aliases`` e trovato in ``where``,
+        estrae il valore, lo rimuove dal dizionario e aggiunge la condizione ILIKE
+        su tutte le colonne in ``ilike_attributes`` con ``OR``.
+
+        Args:
+            stmt (Select | Update | Delete): Statement su cui applicare i filtri.
+            where (dict[str, Any]): Dizionario dei filtri. Gli alias ILIKE vengono
+                estratti e rimossi in-place.
+            **kwargs: Ignorati (compatibilità con l'interfaccia base).
+
+        Returns:
+            Select | Update | Delete: Statement con le condizioni ILIKE aggiunte.
+        """
+
+        for alias in self.ilike_aliases:
+            condition = where.pop(alias, None)
+            if condition:
+                stmt = stmt.where(self._handle(alias, condition))
+        return stmt
+
+    def _handle(self, alias: str, condition: str, neq: bool = False):
+        """Costruisce la condizione ILIKE con OR su tutte le colonne configurate.
+
+        Args:
+            alias (str): Alias attivato (usato per identificare la ricerca, non la colonna).
+            condition (str): Stringa da cercare (viene wrappata con ``%``).
+            neq (bool): Non utilizzato in questa implementazione.
+
+        Returns:
+            ColumnElement: Espressione ``OR(col1 ILIKE '%val%', col2 ILIKE '%val%', ...)``.
+        """
+        return or_(*[self.columns[col].ilike(f'%{condition}%') for col in self.ilike_attributes], *[self.columns[self.json_column][key].as_string().ilike(f'%{condition}%') for key in self.json_ilike_keys])

{python_general_be_lib-0.5.2.dist-info → python_general_be_lib-0.5.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-general-be-lib
-Version: 0.5.2
+Version: 0.5.3
 Summary: General purpose backend library — SQLAlchemy CRUD/Geometry repositories, FastAPI exceptions, Pydantic base models, logger utilities.
 Author-email: Andrea Di Placido <a.diplacido@arpes.it>, "Arpes S.r.l." <it.admin@arpes.it>
 License: MIT

{python_general_be_lib-0.5.2.dist-info → python_general_be_lib-0.5.3.dist-info}/RECORD

@@ -17,14 +17,15 @@ general/interface/repository/crud_repository.py,sha256=j70VKjcVmkFVTZTYA9KQBKSnZ
 general/interface/repository/geometry_repository.py,sha256=bJVPhsr-fGhVTywdHwx9Qt_inWPHk5wqq9EFWFLfuGU,11181
 general/interface/repository/many_to_many_repository.py,sha256=iEhWyD8nPZSAPL8Z2wXrK-aRBnoh3evaSN-voaf0EP0,8662
 general/interface/repository/view_repository.py,sha256=Sm591FUP0iBYlI-ULNWszD5fOvTGwXX0iYoeDbUqo34,5397
-general/interface/repository/handler/__init__.py,sha256=-WaJmlNxA4oDw_4lWgUsqoqo1UHABY8hmnXG1lDfOrI,150
+general/interface/repository/handler/__init__.py,sha256=J-fc-5Dl_C821oy_EVRdyU-L2iXiNFriYJDbK4ODIMM,184
 general/interface/repository/handler/base_handler.py,sha256=YEdE-S1JnLMo0LZn_9rHjEUgDNEM-qjcbNZ_rhsBnpg,2800
 general/interface/repository/handler/ilike_handler.py,sha256=_HHTvj6Tm1L-WvUy1S9faRChoRZni11i9mv76I4Xak0,3919
 general/interface/repository/handler/interval_handler.py,sha256=XxMQr6UuWnoCtbOOO7l80_Yja_aPKYtHhDfhFCRMaKg,4135
 general/interface/repository/handler/json_handler.py,sha256=7bS59seB-It5KHsWXTbHGsEvbQZ6lYyvX-d29BcRLVE,2956
+general/interface/repository/handler/json_ilike_handler.py,sha256=yDuKER3yqtnHpVWndF8PVEaqDThcq1EhZzLaqxbQ0bU,4491
 general/interface/repository/handler/statement_manager.py,sha256=2_AjORmDnKtRaHxZc8RLKe68soNVv2YBRCB5jihgvcY,4392
-python_general_be_lib-0.5.2.dist-info/licenses/LICENSE,sha256=iUaO1XZyB9P3Tmog0OILuTisP6vXGe3QKz-4yRTxOFk,1069
-python_general_be_lib-0.5.2.dist-info/METADATA,sha256=08TJivyau73qu4SUj1i11ZDyKsVDWAXHBfDYNT7sRCo,1384
-python_general_be_lib-0.5.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-python_general_be_lib-0.5.2.dist-info/top_level.txt,sha256=tTZePW8_CNUqSgKFd2SEH72ZbnhS0OYjRsgcv0ikSFY,8
-python_general_be_lib-0.5.2.dist-info/RECORD,,
+python_general_be_lib-0.5.3.dist-info/licenses/LICENSE,sha256=iUaO1XZyB9P3Tmog0OILuTisP6vXGe3QKz-4yRTxOFk,1069
+python_general_be_lib-0.5.3.dist-info/METADATA,sha256=ppE7Y1Ij9o6lkL9QY0Kn8NLBPfvaFRHFMmmtEnK8tKU,1384
+python_general_be_lib-0.5.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+python_general_be_lib-0.5.3.dist-info/top_level.txt,sha256=tTZePW8_CNUqSgKFd2SEH72ZbnhS0OYjRsgcv0ikSFY,8
+python_general_be_lib-0.5.3.dist-info/RECORD,,