python-general-be-lib 0.5.1__tar.gz → 0.5.3__tar.gz

{python_general_be_lib-0.5.1 → python_general_be_lib-0.5.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-general-be-lib
-Version: 0.5.1
+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.1 → python_general_be_lib-0.5.3}/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 *

{python_general_be_lib-0.5.1 → python_general_be_lib-0.5.3}/general/interface/repository/handler/interval_handler.py

@@ -31,12 +31,14 @@ class IntervalHandler(BaseHandler):
         >>> repo.find(where={"start_date": "2024-01-01", "end_date": "2024-12-31"})
         # WHERE start_date >= '2024-01-01' AND (end_date <= '2024-12-31' OR end_date IS NULL)
     """
-    __slots__ = "from_", "to_", "inf_is_none"
+    __slots__ = "from_", "to_", "inf_is_none", "from_alias", "to_alias", "between"
     from_: Any
     to_: Any
+    from_alias: str
+    to_alias: str
     inf_is_none: bool
 
-    def __init__(self, columns: ReadOnlyColumnCollection[str, Column[Any]], from_: Any = None, to_: Any = None, inf_is_none: bool = False):
+    def __init__(self, columns: ReadOnlyColumnCollection[str, Column[Any]], from_: Any = None, from_alias: str = None, to_: Any = None, to_alias: str = None, inf_is_none: bool = False):
         """Inizializza l'handler con le chiavi per il limite inferiore e superiore.
 
         Args:
@@ -52,7 +54,10 @@ class IntervalHandler(BaseHandler):
         self.columns = columns
         self.from_ = from_
         self.to_ = to_
+        self.from_alias = from_alias if from_alias else str(from_)
+        self.to_alias = to_alias if to_alias else str(to_)
         self.inf_is_none = inf_is_none
+        self.between = True if self.from_alias == self.to_alias else False
 
     def handle(self, stmt: Select | Update | Delete, where: dict[str, Any] = None, **kwargs):
         """Applica le condizioni di range allo statement estraendo i valori da ``where``.
@@ -75,8 +80,8 @@ class IntervalHandler(BaseHandler):
             - Limite superiore: ``col <= value`` oppure ``(col <= value OR col IS NULL)``
               se ``inf_is_none=True``.
         """
-        from_condition = where.pop(self.from_, None)
-        to_condition = where.pop(self.to_, None)
+        from_condition = where.pop(self.from_alias, None)
+        to_condition = where.pop(self.to_alias, None) if not self.between else from_condition
         if from_condition:
             stmt = stmt.where(self.columns[self.from_] >= from_condition)
         if to_condition:

python_general_be_lib-0.5.3/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.1 → python_general_be_lib-0.5.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.backends.legacy:build"
 
 [project]
 name = "python-general-be-lib"
-version = "0.5.1"
+version = "0.5.3"
 description = "General purpose backend library — SQLAlchemy CRUD/Geometry repositories, FastAPI exceptions, Pydantic base models, logger utilities."
 readme = "README.md"
 license = { text = "MIT" }

{python_general_be_lib-0.5.1 → python_general_be_lib-0.5.3}/python_general_be_lib.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-general-be-lib
-Version: 0.5.1
+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.1 → python_general_be_lib-0.5.3}/python_general_be_lib.egg-info/SOURCES.txt

@@ -25,6 +25,7 @@ general/interface/repository/handler/base_handler.py
 general/interface/repository/handler/ilike_handler.py
 general/interface/repository/handler/interval_handler.py
 general/interface/repository/handler/json_handler.py
+general/interface/repository/handler/json_ilike_handler.py
 general/interface/repository/handler/statement_manager.py
 python_general_be_lib.egg-info/PKG-INFO
 python_general_be_lib.egg-info/SOURCES.txt

{python_general_be_lib-0.5.1 → python_general_be_lib-0.5.3}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="python-general-be-lib",
-    version="0.5.1",
+    version="0.5.3",
     packages=find_packages(include=["general*"]),
     python_requires=">=3.12",
     install_requires=[
@@ -11,4 +11,4 @@ setup(
         "sqlalchemy>=2.0.0",
         "geoalchemy2>=0.14.0",
     ],
-)
+)