tai-sql 0.7.14__tar.gz → 0.7.16__tar.gz

tai_sql-0.7.16/LICENSE

@@ -0,0 +1,32 @@
+Licencia propietaria
+
+Copyright (c) 2025-2026 Triple Alpha Innovation. Todos los derechos reservados.
+
+tai-sql (el «Software»), incluidos su código fuente, su código objeto, su
+documentación y cualquier material asociado, es propiedad exclusiva de Triple
+Alpha Innovation y está protegido por la legislación de propiedad intelectual e
+industrial aplicable.
+
+No se concede ninguna licencia ni ningún otro derecho sobre el Software, de
+forma expresa o implícita, salvo los que Triple Alpha Innovation otorgue por
+escrito. En particular, sin esa autorización previa y por escrito queda
+prohibido:
+
+  1. usar, ejecutar o instalar el Software;
+  2. copiar, reproducir o modificar el Software, total o parcialmente;
+  3. distribuir, publicar, sublicenciar, ceder, alquilar o vender el Software o
+     cualquier obra derivada de él;
+  4. descompilar, desensamblar o aplicar ingeniería inversa al Software, salvo
+     en los casos en que la ley lo permita expresamente.
+
+El acceso al Software o su obtención por cualquier medio, incluidos los
+repositorios públicos de paquetes, no implica la concesión de ninguna licencia.
+
+EL SOFTWARE SE PROPORCIONA «TAL CUAL», SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O
+IMPLÍCITA, INCLUIDAS, SIN LIMITACIÓN, LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD
+PARA UN FIN DETERMINADO Y NO INFRACCIÓN. EN NINGÚN CASO TRIPLE ALPHA INNOVATION
+SERÁ RESPONSABLE DE NINGUNA RECLAMACIÓN, DAÑO U OTRA RESPONSABILIDAD DERIVADA DEL
+SOFTWARE O DE SU USO, SALVO EN LO QUE ESTABLEZCA EL ACUERDO ESCRITO QUE AUTORICE
+ESE USO.
+
+Para solicitar autorización: Triple Alpha Innovation, https://www.triplealpha.in/

{tai_sql-0.7.14 → tai_sql-0.7.16}/PKG-INFO

@@ -1,8 +1,8 @@
 Metadata-Version: 2.4
 Name: tai-sql
-Version: 0.7.14
+Version: 0.7.16
 Summary: SQL database management and code generation tool
-License-Expression: MIT
+License-Expression: LicenseRef-Proprietary
 License-File: LICENSE
 Keywords: sql,database,code-generation,orm,sqlalchemy
 Author: MateoSaezMata
@@ -51,10 +51,10 @@ Requires-Dist: rich (>=15.0.0,<16.0.0)
 Requires-Dist: sqlalchemy (>=2.0.42,<3.0)
 Requires-Dist: sqlalchemy-bigquery (>=1.11.0,<2.0) ; extra == "all"
 Requires-Dist: sqlalchemy-bigquery (>=1.11.0,<2.0) ; extra == "bigquery"
-Requires-Dist: tai-alphi (>=2.0.1,<3.0) ; extra == "all"
-Requires-Dist: tai-alphi (>=2.0.1,<3.0) ; extra == "backup"
-Requires-Dist: tai-storage (>=0.1.0) ; extra == "all"
-Requires-Dist: tai-storage (>=0.1.0) ; extra == "backup"
+Requires-Dist: tai-alphi (>=2.1.0,<3.0) ; extra == "all"
+Requires-Dist: tai-alphi (>=2.1.0,<3.0) ; extra == "backup"
+Requires-Dist: tai-storage (>=0.2.0,<0.3) ; extra == "all"
+Requires-Dist: tai-storage (>=0.2.0,<0.3) ; extra == "backup"
 Project-URL: Documentation, https://triplealpha-innovation.github.io/tai-sql/
 Project-URL: Homepage, https://www.triplealpha.in/es/
 Project-URL: Issues, https://github.com/triplealpha-innovation/tai-sql/issues
@@ -65,7 +65,7 @@ Description-Content-Type: text/markdown
 
 [![PyPI](https://img.shields.io/pypi/v/tai-sql.svg)](https://pypi.org/project/tai-sql/)
 [![Python](https://img.shields.io/pypi/pyversions/tai-sql.svg)](https://pypi.org/project/tai-sql/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Licencia: propietaria](https://img.shields.io/badge/licencia-propietaria-red.svg)](LICENSE)
 [![Manual](https://img.shields.io/badge/manual-github.io-blue.svg)](https://triplealpha-innovation.github.io/tai-sql/)
 
 **Framework declarativo de Python, sobre SQLAlchemy, que gestiona el ciclo de vida completo de
@@ -248,7 +248,7 @@ Cada uno de esos paquetes tiene su propio `README.md` con el detalle.
 
 ## Licencia
 
-MIT. Ver [LICENSE](LICENSE).
+Propietaria: © Triple Alpha Innovation, todos los derechos reservados. Ver [LICENSE](LICENSE).
 
 ---
 

{tai_sql-0.7.14 → tai_sql-0.7.16}/README.md

@@ -2,7 +2,7 @@
 
 [![PyPI](https://img.shields.io/pypi/v/tai-sql.svg)](https://pypi.org/project/tai-sql/)
 [![Python](https://img.shields.io/pypi/pyversions/tai-sql.svg)](https://pypi.org/project/tai-sql/)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Licencia: propietaria](https://img.shields.io/badge/licencia-propietaria-red.svg)](LICENSE)
 [![Manual](https://img.shields.io/badge/manual-github.io-blue.svg)](https://triplealpha-innovation.github.io/tai-sql/)
 
 **Framework declarativo de Python, sobre SQLAlchemy, que gestiona el ciclo de vida completo de
@@ -185,7 +185,7 @@ Cada uno de esos paquetes tiene su propio `README.md` con el detalle.
 
 ## Licencia
 
-MIT. Ver [LICENSE](LICENSE).
+Propietaria: © Triple Alpha Innovation, todos los derechos reservados. Ver [LICENSE](LICENSE).
 
 ---
 

{tai_sql-0.7.14 → tai_sql-0.7.16}/pyproject.toml

@@ -1,8 +1,8 @@
 [project]
 name = "tai-sql"
-version = "0.7.14"
+version = "0.7.16"
 description = "SQL database management and code generation tool"
-license = "MIT"
+license = "LicenseRef-Proprietary"
 license-files = ["LICENSE"]
 authors = [
     {name = "MateoSaezMata", email = "msaez@triplealpha.in"},
@@ -99,7 +99,7 @@ diagrams = ["graphviz>=0.20.3,<1.0"]
 # `deploy`: nada hoy — el comando está **desactivado a propósito** (comentado en
 #     `cli/main.py`). El extra se conserva para no romper a quien lo tenga instalado, pero
 #     instalarlo no habilita ningún comando.
-backup = ["tai-storage>=0.1.0", "tai-alphi>=2.0.1,<3.0"]
+backup = ["tai-storage>=0.2.0,<0.3", "tai-alphi>=2.1.0,<3.0"]
 deploy = ["requests>=2.32.4,<3.0", "pynacl>=1.5.0,<2.0"]
 
 # ── Todo ──────────────────────────────────────────────────────────────────────
@@ -115,8 +115,8 @@ all = [
     "cryptography>=45.0.4,<46.0",
     "bcrypt>=4.0.0,<6.0",
     "graphviz>=0.20.3,<1.0",
-    "tai-storage>=0.1.0",
-    "tai-alphi>=2.0.1,<3.0",
+    "tai-storage>=0.2.0,<0.3",
+    "tai-alphi>=2.1.0,<3.0",
     "requests>=2.32.4,<3.0",
     "pynacl>=1.5.0,<2.0",
 ]
@@ -125,7 +125,7 @@ all = [
 tai-sql = "tai_sql.cli.main:cli"
 
 [build-system]
-# poetry-core 2 hace falta para `license = "MIT"` como expresión SPDX (PEP 639).
+# poetry-core 2 hace falta para `license` como expresión SPDX (PEP 639).
 requires = ["poetry-core>=2.0.0,<3.0.0"]
 build-backend = "poetry.core.masonry.api"
 
@@ -147,11 +147,9 @@ dev = [
     # lo que hay que poder afirmar es que el código que se despliega está probado.
     # Ver `tests/_client_coverage.py`.
     "coverage (>=7.0)",
-    # No lo importa tai-sql: lo importan el cliente generado (`as_dataframe`,
-    # `from_dataframe`) y `tai_storage`, que carga su submódulo `data` al importarse y
-    # ahí exige pandas y numpy. Sin declararlo, el CI instalaba tai-storage por el extra
-    # `backup` y **la colección de toda la suite se rompía** al importarlo, mientras en
-    # local pasaba porque pandas estaba instalado sin que nadie lo hubiera pedido.
+    # No lo importa tai-sql: lo importa el cliente generado (`as_dataframe`,
+    # `from_dataframe`), y sus tests lo ejercitan. Hasta tai-storage 0.1.16 también lo
+    # exigía `import tai_storage` (cargaba su submódulo `data`); desde la 0.2 ya no.
     "pandas (>=2.0,<3.0)",
     # Lo mismo por el otro lado: `test_generated_runtime.py` ejercita el cliente async
     # contra PostgreSQL, y su dialecto es asyncpg. Sin declararlo, esos 22 tests pasaban

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/cli/commands/cmd_init/model.py

@@ -23,7 +23,7 @@ PYPROJECT_TEMPLATE = dedent('''\
     dependencies = [
         "sqlalchemy (>=2.0.42,<3.0)",
         "pydantic (>=2.11.7,<3.0)",
-        "tai-alphi (>=2.0.1,<3.0)",
+        "tai-alphi (>=2.1.0,<3.0)",
         "rich (>=14.0.0,<15.0)"
     ]
 

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/cli/commands/cmd_schema/schemas/auth.py

@@ -16,7 +16,7 @@ class AuthSchema(SchemaTemplate):
             Modela un control de acceso multi-realm — cada Realm agrupa sus propios
             usuarios y roles, y las tablas puente UserRole/RolePermission resuelven las
             relaciones muchos-a-muchos. Los roles admiten anidamiento vía
-            `parent_role_name` (self_reference).
+            `parent_role_name`: una FK compuesta que obliga a que el padre sea del mismo realm.
 
             Requisitos:
             - Variable de entorno MAIN_DATABASE_URL con la conexión.
@@ -80,6 +80,7 @@ class AuthSchema(SchemaTemplate):
                 users: onetomany[User]
                 roles: onetomany[Role]
                 permissions: onetomany[Permission]
+                rls_rules: onetomany[RowLevelSecurity]
 
                 def feed(self) -> list:
                     return [
@@ -145,9 +146,17 @@ class AuthSchema(SchemaTemplate):
                 description: col[str | None] = column(description="Descripción del rol")
                 attributes: col[dict | None] = column(description="Atributos adicionales del rol (JSON)")
 
-                parent_role_name: col[str | None] = column(description="ID del rol padre para subroles (roles anidados)", self_reference="name")
+                parent_role_name: col[str | None] = column(description="Rol padre, del mismo realm, para subroles (roles anidados)")
 
                 realm: manytoone[Realm] = relation(fields=["realm_name"], references=["name"], backref="roles")
+                # El padre es del mismo realm porque la clave lo dice: la FK es compuesta y
+                # comparte `realm_name`. Con `self_reference="name"` la jerarquía no tenía FK y
+                # se resolvía solo por nombre, así que un padre podía no existir o ser otro rol
+                # homónimo de otro realm. `restrict`: borrar un rol con subroles es un error,
+                # no una cascada que se los lleve (y `set null` vaciaría también `realm_name`).
+                parent: manytoone[Role] = relation(fields=["parent_role_name", "realm_name"], references=["name", "realm_name"], backref="subroles", onDelete="restrict")
+
+                subroles: onetomany[Role]
 
                 role_permissions: onetomany[RolePermission]
                 user_roles: onetomany[UserRole]
@@ -248,6 +257,9 @@ class AuthSchema(SchemaTemplate):
                 table_name: col[str] = column(primary_key=True, description="Nombre de la tabla a la que aplica la regla RLS")
                 column_name: col[str] = column(primary_key=True, description="Nombre de la columna a la que se le aplica la regla RLS")
 
+                # Una regla es de un realm: sin la FK, borrar el realm dejaba sus reglas sueltas.
+                realm: manytoone[Realm] = relation(fields=["realm_name"], references=["name"], backref="rls_rules")
+
         ''').strip()
 
     def create_views(self, views_dir: Path) -> None:

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/cli/services/backup.py

@@ -7,6 +7,7 @@ import re
 import shutil
 import subprocess
 import tempfile
+from pathlib import Path
 from datetime import datetime
 from typing import List, Optional
 
@@ -153,10 +154,8 @@ class BackupService:
                 msg = _parse_stderr(result.stderr, 'backup')
                 raise RuntimeError(f"Falló el backup con {tool}:\n   {msg}")
 
-            # Subir al storage
-            folder = origin.get_folder('.')
-            with open(tmp_path, 'rb') as f:
-                folder.upload_file(f.read(), filename)
+            # Subir al storage: desde la ruta, por trozos, sin cargar el volcado en memoria
+            origin.get_folder('.').upload_file(Path(tmp_path), filename)
 
         # Aplicar retención
         if self.sm.backup_retention is not None:
@@ -183,9 +182,7 @@ class BackupService:
         with tempfile.TemporaryDirectory() as tmpdir:
             tmp_path = os.path.join(tmpdir, filename)
 
-            data = file.read()
-            with open(tmp_path, 'wb') as f:
-                f.write(data)
+            file.download_to_local(tmp_path)
 
             target = self.sm.restore_provider
 

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/generators/python_client/context.py

@@ -329,8 +329,65 @@ class TemplateContextBuilder:
             # clase destino tal y como el usuario la escribió.
             'description': (target.declared_by.__doc__ or '') if target.declared_by else '',
             'target_has_create_triggers': self._has_create_triggers(relation.target),
+            'overlaps': self._overlaps(relation),
+            'remote_side': self._remote_side(relation),
         }
 
+    @staticmethod
+    def _remote_side(relation: RelationModel) -> List[str]:
+        """
+        Las columnas del padre en una relación de una tabla consigo misma.
+
+        Si `local` y `target` son la misma clase, SQLAlchemy no puede deducir qué lado es
+        el padre —las dos puntas son la misma tabla— y rechaza la pareja por tener la
+        misma dirección. En el lado que posee la FK, el remoto son las columnas
+        referenciadas: es la *composite adjacency list* de la documentación de SQLAlchemy,
+        y vale también cuando la FK comparte una columna con la PK (`realm_name` en
+        `Role.parent`). El lado inverso no lo necesita: lo deduce del `back_populates`.
+        """
+        owns_fk = relation.direction == 'many-to-one' or (
+            relation.is_one_to_one and not relation.implicit
+        )
+        if relation.local != relation.target or not owns_fk:
+            return []
+        return [f'{relation.target}.{ref}' for ref in relation.references]
+
+    def _overlaps(self, relation: RelationModel) -> List[str]:
+        """
+        Relaciones que escriben alguna de las columnas FK de ésta.
+
+        Dos claves foráneas compuestas pueden compartir una columna: en un schema
+        multi-tenant, `UserRole(user_name, realm_name) → User` y
+        `UserRole(role_name, realm_name) → Role` comparten `realm_name`, y esa
+        columna compartida es justo lo que obliga a que usuario y rol sean del mismo
+        realm. Es intencionado, pero SQLAlchemy no lo sabe: al configurar los mappers
+        avisa de que las dos relaciones copiarían valores a la misma columna. Se le
+        dice con `overlaps=`, que en cada lado nombra las relaciones del otro.
+
+        La columna compartida vive en la tabla que posee la FK: en el lado explícito
+        es `local` y sus columnas son `fields`; en el implícito es `target`, y las
+        columnas, `references`.
+        """
+        owns_fk = relation.direction == 'many-to-one' or (
+            relation.is_one_to_one and not relation.implicit
+        )
+        if owns_fk:
+            owner_name, columns, own = relation.local, relation.fields, relation.name
+        else:
+            owner_name, columns, own = relation.target, relation.references, relation.backref
+
+        owner = self.schema.entity(owner_name)
+        shared = set(columns)
+        names: set[str] = set()
+        for fk in getattr(owner, 'foreign_keys', ()):
+            if fk.relation == own or not shared & set(fk.local_columns):
+                continue
+            names.add(fk.relation)
+            other = owner.relations.get(fk.relation)
+            if other is not None and other.backref:
+                names.add(other.backref)
+        return sorted(names)
+
     def foreign_key(self, fk: ForeignKeyModel) -> Dict[str, Any]:
         """
         Contexto de una clave foránea.

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/generators/python_client/templates/domain/model.py.jinja2

@@ -279,7 +279,8 @@ class {{ model.name }}(Base):
 {# SQLAlchemy relationship() with:
    - back_populates for bidirectional navigation
    - foreign_keys as string expression to avoid circular import issues
-   - passive_deletes="all" on one-to-many to let the DB handle cascades #}
+   - passive_deletes="all" on one-to-many to let the DB handle cascades
+   - overlaps when two FKs share a column (context.py: _overlaps) #}
 {% if model.relations | default([]) | list %}
 {% for rel in model.relations %}
     {% if rel.direction == "one-to-many" %}
@@ -294,6 +295,8 @@ class {{ model.name }}(Base):
     {% set _ = rel_args.append('foreign_keys="[' + fk_parts | join(', ') + ']"') %}
     {% if rel.direction == "one-to-many" %}{% set _ = rel_args.append('passive_deletes="all"') %}{% endif %}
     {% if rel.direction == "one-to-one" %}{% set _ = rel_args.append('uselist=False') %}{% endif %}
+    {% if rel.remote_side %}{% set _ = rel_args.append('remote_side="[' + rel.remote_side | join(', ') + ']"') %}{% endif %}
+    {% if rel.overlaps %}{% set _ = rel_args.append('overlaps="' + rel.overlaps | join(',') + '"') %}{% endif %}
     {{ rel.name }}: Mapped[{{ rel.target_type }}] = relationship({{ rel_args | join(', ') }})
 {% endfor %}
 {% endif %}

{tai_sql-0.7.14 → tai_sql-0.7.16}/tai_sql/schema.py

@@ -144,7 +144,8 @@ class SchemaManager:
         if self._backup_storage is None:
             from tai_storage import StorageFactory
             from tai_alphi import Alphi
-            Alphi.configure_logger('tai-storage', {'consola': {'log_level': 'ERROR'}})
+            # Default de librería: la aplicación puede seguir ajustando el logger de tai-storage
+            Alphi.set_default_config('tai-storage', {'consola': {'log_level': 'ERROR'}})
             root_path = f'.database_backups/{self.schema_name}'
             self._backup_storage = StorageFactory.create_local(root_path=root_path)
         return self._backup_storage