pancakes-orm 3.0.0__tar.gz → 3.2.0__tar.gz

{pancakes_orm-3.0.0/pancakes_orm.egg-info → pancakes_orm-3.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pancakes-orm
-Version: 3.0.0
+Version: 3.2.0
 Summary: Un ORM simple, potente y flexible llamado PanCakes
 Author-email: Andres Alberto Lopez Mendoza <andres.lopez.full.dev@gmail.com>
 License: Apache-2.0
@@ -79,7 +79,7 @@ PanCakesORM no es solo una cara bonita; está construido para ser el motor confi
         Streamlit: Ideal para aplicaciones de datos donde la velocidad de desarrollo es clave.
 
     Calidad Garantizada: La robustez de la librería está respaldada por una batería
-    de más de 120 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
+    de más de 125 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
 
 🏗️ Arquitectura de Consultas (QueryBox)
 

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0}/README.md

@@ -61,7 +61,7 @@ PanCakesORM no es solo una cara bonita; está construido para ser el motor confi
         Streamlit: Ideal para aplicaciones de datos donde la velocidad de desarrollo es clave.
 
     Calidad Garantizada: La robustez de la librería está respaldada por una batería
-    de más de 120 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
+    de más de 125 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
 
 🏗️ Arquitectura de Consultas (QueryBox)
 

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0}/pancakes/cook/layer.py

@@ -40,7 +40,8 @@ def query(
     condition: list = None,
     group_by: list = None,
     order_by: list = None,
-    limit: int = None
+    limit: int = None,
+    offset: int = None
 ):
     """
     Ejecuta una consulta SQL avanzada, sanitizada y dinámica.
@@ -482,6 +483,19 @@ def query(
         limit_clause = "LIMIT ?"
         c_data.append(limit)
 
+    # CONSTRUCCIÓN 'OFFSET' CLAUSE
+    offset_clause = ""
+
+    if offset:
+
+        if not isinstance(offset, int):
+            msg = f"Invalid datatype: {offset}."
+            logger.critical(msg)
+            raise TypeError(type(offset))
+
+        offset_clause = "OFFSET ?"
+        c_data.append(offset)
+
     # Construccion del Query Final
     sql = (
         f"{select_clause} "
@@ -489,7 +503,8 @@ def query(
         f"{where_clause} "
         f"{group_clause} "
         f"{order_clause} "
-        f"{limit_clause};"
+        f"{limit_clause} "
+        f"{offset_clause};"
     )
 
     sql = " ".join(sql.split()).strip()

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0}/pancakes/cook/mold.py

@@ -103,7 +103,6 @@ class PanCakesORM:
     _family = {}
     _db_dir = DEFAULT_DIR
     _db_file = DEFAULT_DB_FILE
-    _depends = "self"
     _metadata = {}
     _order = []
 
@@ -176,7 +175,7 @@ class PanCakesORM:
     @classmethod
     def _check_dependencies(cls) -> None:
         """
-        Evalua el atributo de clase cls.depends:
+        Evalua el atributo de clase cls._depends:
         1. Valida el tipo de dato
         2. Valida: O string valido o iterable valido.
         3. Se guardan las dependencias en una lista de diccionarios.
@@ -185,6 +184,16 @@ class PanCakesORM:
 
         externals = []
 
+        if '_depends' not in cls.__dict__.keys():
+            msg = (
+                f"Model {cls._table} does not have declared attribute "
+                f"'_depends' which must be specified for relations "
+                f"among tables in database. PanCakesORM set _'depends' "
+                f"to 'self'; table - {cls._table}"
+            )
+            logger.warning(msg)
+            cls._depends = "self"
+
         # Validar tipo de dato
         if not isinstance(cls._depends, (str, list, tuple)):
             msg = (
@@ -199,8 +208,8 @@ class PanCakesORM:
         if isinstance(cls._depends, str) and cls._depends != "self":
             msg = (
                 f"Class attribute _depends only accepts the "
-                f"following string when there is no dependencies "
-                f"on other tables: 'self'. Any other string will "
+                f"following string when there are no dependencies "
+                f"to other tables: 'self'. Any other string will "
                 f"raise this message."
             )
             logger.critical(msg)
@@ -490,7 +499,8 @@ class PanCakesORM:
         condition: list = None,
         group_by: list = None,
         order_by: list = None,
-        limit: int = None
+        limit: int = None,
+        offset: int = None
     ):
         """
         Llama a la funcion de consulta global.
@@ -505,6 +515,7 @@ class PanCakesORM:
         group_by = None if group_by is None else group_by
         order_by = None if order_by is None else order_by
         limit = None if limit is None else limit
+        offset = None if offset is None else offset
 
         res, col = query(
             db_path=db_path,
@@ -515,7 +526,8 @@ class PanCakesORM:
             condition=condition,
             group_by=group_by,
             order_by=order_by,
-            limit=limit
+            limit=limit,
+            offset=offset
         )
 
         return res, col
@@ -617,6 +629,10 @@ class PanCakesORM:
     def lim(cls, num: int = None):
         return cls.q().lim(num)
 
+    @classmethod  # Inyección Segura
+    def off(cls, num: int = None):
+        return cls.q().off(num)
+
     @classmethod  # Inyeccion Segura
     def all(cls):
         return cls.q().all()

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0}/pancakes/tool/box.py

@@ -51,6 +51,7 @@ class QueryBox:
         self.group = None
         self.order = None
         self.limit = None
+        self.offset = None
         self.ids = False
         self.row = None
         self.col = None
@@ -385,6 +386,10 @@ class QueryBox:
         return
 
     def select(self, *columns):
+
+        if not columns:
+            return self
+
         AGGS = {
             "min": 'MIN',
             "max": 'MAX',
@@ -459,17 +464,35 @@ class QueryBox:
                 self.sp_select.append(dicc)
                 continue
 
-            # Obtenemos el comment desde la tabla main
-            lab = [c.comment for c in self.model._fields if c._name == col]
-            lab = f"{"".join(lab)} {agg.upper()}"
-            lab = " ".join(lab.split(" ")).strip()
-            self.s_label.append(lab)
+            elif tab == m_tab:
+                # Obtenemos el comment desde la tabla main
+                lab = [c.comment for c in self.model._fields if c._name == col]
+                lab = f"{"".join(lab)} {agg.upper()}"
+                lab = " ".join(lab.split(" ")).strip()
+                self.s_label.append(lab)
 
-            dicc = {
-                "name": col,
-                "agg": agg
-            }
-            self.s_select.append(dicc)
+                dicc = {
+                    "name": col,
+                    "agg": agg
+                }
+                self.s_select.append(dicc)
+                continue
+
+        # Validar; no s_select, si sp_select
+        if not self.s_select:
+            m_tab = self.model._table
+            name = self.model._table
+            if "_" in name:
+                name = name.split("_")
+                name = " ".join(name)
+
+            self.s_label.append(f"{name} id".upper())
+            self.s_select = [
+                {
+                    "name": f"{m_tab}_id",
+                    "agg": ""
+                }
+            ]
 
         return self
 
@@ -826,6 +849,7 @@ class QueryBox:
 
     def sort(self, **kwargs):
         """
+        Equivalente a ORDER BY
         """
         DIRECTION = {'DESC', 'ASC', ''}
 
@@ -887,6 +911,20 @@ class QueryBox:
         self.limit = limit
         return self
 
+    def off(self, offset: int):
+        """
+        Asigna un valor integer para seleccionar
+        el comienzo del query.
+        """
+        if not isinstance(offset, int):
+            msg = f"Invalid datatype: {offset}."
+            logger.critical(msg)
+            raise TypeError(type(offset))
+
+        offset = offset if offset else None
+        self.offset = offset
+        return self
+
     def id(self):
         """
         Bandera que especifica al query devolver
@@ -913,6 +951,7 @@ class QueryBox:
         group = self.group if self.group else None
         order = self.order if self.order else None
         limit = self.limit if self.limit else None
+        offset = self.offset if self.offset else None
 
         ambiguous = (
             ids and s_select,
@@ -934,8 +973,7 @@ class QueryBox:
             sp_select = None
 
         # Evaluar cuando .all() no contiene select():
-
-        if not s_select:
+        if s_select is None and sp_select is None:
             self._if_no_select()
             self.all()
             return self
@@ -949,7 +987,8 @@ class QueryBox:
             condition=condition,
             group_by=group,
             order_by=order,
-            limit=limit
+            limit=limit,
+            offset=offset
         )
 
         self.row = row
@@ -958,15 +997,15 @@ class QueryBox:
         return self
 
     def link(self, *relation):
+        """ Esta función imita **kwargs de add()
+        tipo de union + __ + tabla extra = [id referencia, tabla]
+        """
 
         # Si no hay datos, salir
         if not relation:
             return self
 
-        # Obtener las relaciones en una lista de diccionarios
-        # Imitan el **kwargs de .add()
-        # tipo de union + __ + tabla extra = [id referencia, tabla]
-
+        by_dependency = False
         kwargs = {}
 
         # Iteracion sobre los nombre de tablas dadas
@@ -1033,10 +1072,115 @@ class QueryBox:
             # Por defecto INNER JOIN
             kwargs[f"in__{rel}"] = [field, self.model._table]
 
-        # Ejecutamos la union
-        # Desempaquetamos el diccionario:
-        self.add(**kwargs)
+        dicc_values = kwargs.values()
+        for v in dicc_values:
+            if v[0] is None or v[1] is None:
+                by_dependency = True
+                break
+
+        if by_dependency:
+            copy = list(relation)
+
+            # Orden de relacion por dependencia:
+            DEP = reversed(self.model._order)
+            copy.insert(0, self.model._table)
+            REL = [d for d in DEP if d in copy]
+            winner = self.model
+
+            # Iterar esquema de relación
+            kwargs = {}
+            for t in REL:
+
+                # Bandera Validación
+                flag = True
+
+                TABS = REL
+                MODEL = self.model._family[t]
+                TABS.remove(MODEL._table)
+
+                # Iteracion sobre los nombre de tablas dadas
+                for rel in TABS:
+
+                    # validar que se hayan pasado strings
+                    if not isinstance(rel, str):
+                        msg = (
+                            f"Passed table name {rel} "
+                            f"must be a string."
+                        )
+                        logger.critical(msg)
+                        raise TypeError(type(rel))
+
+                    field = None
+
+                    # Iteramos los "objetos" tipo "campos" <- o sea columnas
+                    # "_fields"
+                    for f in MODEL._fields:
+
+                        # Evaluamos que el campo tenga el atributo:
+                        # "second_table".
+                        # Que el nombre dado y que el nombre del campo
+                        # sean iguales
+                        #
+                        # Se guarda y salimos de bucle
+                        if (
+                            hasattr(f, "second_table") and
+                            rel == f.second_table
+                        ):
+
+                            field = f._name
+                            winner = MODEL
+                            break
+
+                    # Validamos que la operacion directa no encontro campos
+                    # Pasamos a la operacion inversa (de tabla padre a hija).
+                    if field is None:
+
+                        # Buscamos relacion del PRIMARY KEY de la tabla
+                        # A la FOREIGN KEY de la tabla hija
+                        c_id = f"{MODEL._table}_id"
+                        # Buscamos que la tabla exista en la base de datos
+                        if rel not in MODEL._family:
+                            msg = (
+                                f"Passed {rel} tables does not exists. "
+                                "Make sure of the spelling and "
+                                "make sure of relation before "
+                                "trying again."
+                            )
+                            logger.critical(msg)
+                            raise KeyError(rel)
+
+                        # Si existe accedemos a la tabla entera
+                        # e iteramos sus campos
+                        tab2 = MODEL._family[rel]
+
+                        for f in tab2._fields:
+                            if c_id == f._name:
+                                field = f._name
+                                winner = MODEL
+                                break
+
+                    # Si no relación absoluta; reportar cambio de esquema
+                    if field is None:
+                        flag = False
+                        break
+
+                    # Agregamos la relacion al dicc "kwargs"
+                    # Por defecto INNER JOIN
+                    kwargs[f"in__{rel}"] = [field, MODEL._table]
+
+                # Cambiamos el esquema de busqueda
+                if flag is False:
+                    continue
+                else:
+                    break
+
+            # Si se encontraron nulos:
+            self.model = winner
+            self.add(**kwargs)
+            return self
 
+        # Si no hay nulos retornamos
+        self.add(**kwargs)
         return self
 
     def count(self):

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0/pancakes_orm.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pancakes-orm
-Version: 3.0.0
+Version: 3.2.0
 Summary: Un ORM simple, potente y flexible llamado PanCakes
 Author-email: Andres Alberto Lopez Mendoza <andres.lopez.full.dev@gmail.com>
 License: Apache-2.0
@@ -79,7 +79,7 @@ PanCakesORM no es solo una cara bonita; está construido para ser el motor confi
         Streamlit: Ideal para aplicaciones de datos donde la velocidad de desarrollo es clave.
 
     Calidad Garantizada: La robustez de la librería está respaldada por una batería
-    de más de 120 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
+    de más de 125 pruebas automatizadas utilizando pytest. Puedes consultar la suite completa en la carpeta /tests.
 
 🏗️ Arquitectura de Consultas (QueryBox)
 

{pancakes_orm-3.0.0 → pancakes_orm-3.2.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pancakes-orm"
-version = "3.0.0"
+version = "3.2.0"
 description = "Un ORM simple, potente y flexible llamado PanCakes"
 readme = "README.md"
 requires-python = ">=3.12"