nsj-rest-lib2 0.0.29__py3-none-any.whl → 0.0.31__py3-none-any.whl

nsj_rest_lib2/compiler/util/relation_ref.py

@@ -0,0 +1,118 @@
+import re
+from dataclasses import dataclass
+from typing import Literal, Sequence
+
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
+from nsj_rest_lib2.compiler.edl_model.primitives import (
+    REGEX_EXTERNAL_COMPONENT_REF,
+    REGEX_EXTERNAL_REF,
+    REGEX_INTERNAL_REF,
+)
+
+
+RelationRefType = Literal["internal", "external", "external_component"]
+
+
+@dataclass
+class RelationRef:
+    ref_type: RelationRefType
+    scope: str | None
+    entity: str
+    components: list[str]
+
+    @property
+    def entity_key(self) -> str | None:
+        if not self.scope:
+            return None
+
+        return f"{self.scope}/{self.entity}"
+
+    @property
+    def target_id(self) -> str:
+        return self.components[-1] if self.components else self.entity
+
+    @property
+    def prefx_class_name(self) -> str:
+        if not self.components:
+            return ""
+
+        prefix_parts: list[str] = [self.entity, *self.components[:-1]]
+        return f"_{'_'.join(prefix_parts)}"
+
+    @property
+    def is_external(self) -> bool:
+        return self.ref_type in {"external", "external_component"}
+
+    def resolve_model(
+        self,
+        entity_models: dict[str, EntityModelBase],
+        base_model: EntityModelBase | None = None,
+    ) -> EntityModelBase | None:
+        entity_key = self.entity_key
+        resolved_base: EntityModelBase | None = None
+
+        if entity_key:
+            resolved_base = entity_models.get(entity_key)
+        elif base_model:
+            resolved_base = base_model
+
+        if not resolved_base:
+            return None
+
+        return RelationRefParser.follow_components(resolved_base, self.components)
+
+
+class RelationRefParser:
+    @staticmethod
+    def parse(ref: str) -> RelationRef | None:
+        internal_match = re.match(REGEX_INTERNAL_REF, ref)
+        if internal_match:
+            components = RelationRefParser._split_components(internal_match.group(1))
+            if not components:
+                return None
+            entity = components[0]
+            extra_components = components[1:] if len(components) > 1 else []
+            return RelationRef("internal", None, entity, extra_components)
+
+        external_component_match = re.match(REGEX_EXTERNAL_COMPONENT_REF, ref)
+        if external_component_match:
+            components = RelationRefParser._split_components(
+                external_component_match.group(3)
+            )
+            return RelationRef(
+                "external_component",
+                external_component_match.group(1),
+                external_component_match.group(2),
+                components,
+            )
+
+        external_match = re.match(REGEX_EXTERNAL_REF, ref)
+        if external_match:
+            return RelationRef(
+                "external",
+                external_match.group(1),
+                external_match.group(2),
+                [],
+            )
+
+        return None
+
+    @staticmethod
+    def follow_components(
+        base_model: EntityModelBase, components: Sequence[str]
+    ) -> EntityModelBase | None:
+        target_model: EntityModelBase | None = base_model
+        for component in components:
+            if not target_model or not target_model.components:
+                return None
+            target_model = target_model.components.get(component)
+            if target_model is None:
+                return None
+
+        return target_model
+
+    @staticmethod
+    def _split_components(components_path: str) -> list[str]:
+        # Remove marcadores opcionais '#/components/' intermediários
+        cleaned = components_path.replace("#/components/", "/").replace("#", "")
+        return [part for part in cleaned.split("/") if part]

{nsj_rest_lib2-0.0.29.dist-info → nsj_rest_lib2-0.0.31.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsj_rest_lib2
-Version: 0.0.29
+Version: 0.0.31
 Summary: Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configuradas por meio de EDLs declarativos (em formato JSON).
 Home-page: https://github.com/Nasajon/nsj_rest_lib2
 Author: Nasajon Sistemas

{nsj_rest_lib2-0.0.29.dist-info → nsj_rest_lib2-0.0.31.dist-info}/RECORD

@@ -3,15 +3,18 @@ nsj_rest_lib2/exception.py,sha256=E9uMUdoCCQOVQfc8f6gD9b5Pxurf3Q4SytDCcqSlkZ8,56
 nsj_rest_lib2/redis_config.py,sha256=4KLcvYS3nJO7PMQgF6F9_j6r-TyqcS7TBbd3LEQuKDU,629
 nsj_rest_lib2/settings.py,sha256=Hn_o1HZmievnYb8D1kNT2Nq-OEjxbyNjOiOpbnFsMwE,367
 nsj_rest_lib2/compiler/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-nsj_rest_lib2/compiler/ai_compiler.py,sha256=shAtN4T0ai_52qh15L3mK1QbeC6glHOR6C3J3gj14II,9029
-nsj_rest_lib2/compiler/compiler.py,sha256=8avORndGTPOlQO3-s8PkC3fsfCLsUzBW4Qfq-UaueEE,30403
-nsj_rest_lib2/compiler/compiler_structures.py,sha256=a_DF_nU4VgCt0sWJI03Ky6fPHvoIM0cjMkwQb_dYv6Q,1437
-nsj_rest_lib2/compiler/dto_compiler.py,sha256=ksZ2eYd_urrs6HBNK1m5_LhQhhq7i60GfSzD-AaF0fU,6743
-nsj_rest_lib2/compiler/entity_compiler.py,sha256=-mDA1-dHKYp0umQi1A4GbA0F1hlaC-gQRqj69vkADC4,6536
+nsj_rest_lib2/compiler/compiler.py,sha256=dDH3WXEaWg6eg95Bix1ZMY_fuB3prgps8xsevw9wYE4,30915
+nsj_rest_lib2/compiler/compiler_structures.py,sha256=stspjqJGXU7Vz3BqQ-ZF5ZmumFm3R4jpkWgVVsXW5d0,1488
+nsj_rest_lib2/compiler/dto_compiler.py,sha256=Fs6VysuAjBgct7_Wc0sugvx7z9tfnlZcSrBu0l0Pyp0,7019
+nsj_rest_lib2/compiler/entity_compiler.py,sha256=LeGEBxsjAmZZog2gh4vjUX1aFp9JSVgHHOdTkY0aH-s,6733
 nsj_rest_lib2/compiler/function_compiler.py,sha256=t5e_NoDB0IckiIEuYLsvk2lPSwrcrjL91s4LTQkpRqA,18085
 nsj_rest_lib2/compiler/function_model.py,sha256=iSKMlCSZDWlP_aTdlcbYQhsEAIMH-XbSJUU0-KNtLCs,2066
+nsj_rest_lib2/compiler/migration_compiler.py,sha256=vlG54XmYRqzIo0Iey-4HbSRzPg3Ylp5kpWWCGFAVzx8,29023
+nsj_rest_lib2/compiler/migration_compiler_alter_table.py,sha256=awtqVrKox86rmlQV7K17JzZJZqz9cF7McshLBlLx65s,7969
+nsj_rest_lib2/compiler/migration_compiler_create_table.py,sha256=h22cU53EFnuB5t28fMZ_r7MM-14Vqqu3emebBUJN2LY,2606
+nsj_rest_lib2/compiler/migration_compiler_util.py,sha256=WB_GRX78nTRKlZkgL-4yowwlQoAe81llZ-E2AYfIbh4,5168
 nsj_rest_lib2/compiler/model.py,sha256=8UxzTvcNgZQdLwC592o8ZMVPhG3AloBCg5q2V72Up8U,1688
-nsj_rest_lib2/compiler/property_compiler.py,sha256=7cShFGtbZwSamyS9frSd_CebdmTmWLxpFDsq6vUqj80,47894
+nsj_rest_lib2/compiler/property_compiler.py,sha256=hMQX5vrLqjOEM_wdzuerxuARMq5JhZQ_R8cUVoLHNNM,47631
 nsj_rest_lib2/compiler/edl_model/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nsj_rest_lib2/compiler/edl_model/ai_entity_edl.py,sha256=664QBDcOgVnyfwtUOXO1W7AKaZhueBG335x5DuogruY,7644
 nsj_rest_lib2/compiler/edl_model/api_model.py,sha256=7RpZkUGROZmTBh2psgTG_b3e4xxjc3uBr1EYb-wiAkc,3810
@@ -20,11 +23,12 @@ nsj_rest_lib2/compiler/edl_model/entity_model.py,sha256=Yc6wvjsiwacmz796mZIU-i9h
 nsj_rest_lib2/compiler/edl_model/entity_model_base.py,sha256=eRn0pirIPHvniqGpT0xE-mmgqz5RIVtqghxcnfxKNdQ,4345
 nsj_rest_lib2/compiler/edl_model/entity_model_root.py,sha256=VinsxFlNyCaKKk37ZzcbmWaWgoUP2-dZBG61Ke7NvVs,231
 nsj_rest_lib2/compiler/edl_model/index_model.py,sha256=cXWlu0hxtro5vvYoirkDW4R3PCnBW5oCCWjRJ6AX5zE,508
-nsj_rest_lib2/compiler/edl_model/primitives.py,sha256=y6wvz76R995BHVAW9z2Kywd7sUIF4uwvk0-O2H_Zd1w,1613
+nsj_rest_lib2/compiler/edl_model/primitives.py,sha256=FK2U3rRJIp2j_R_RuQtoRj_MSyua0-eH_QEoCGnutOE,1963
 nsj_rest_lib2/compiler/edl_model/property_meta_model.py,sha256=ciphkgdTtfPfLpeMQpcf3GXQ_qx7xl1tzgeUoJBjPBU,3871
 nsj_rest_lib2/compiler/edl_model/repository_model.py,sha256=OmtUzSq2LKmM76VXefGrKwg8xtVFCutt3JNH2nv42qU,1821
 nsj_rest_lib2/compiler/edl_model/trait_property_meta_model.py,sha256=NtMVZeOPu3LJwXI-8tCOLVuQiGua_0t7kL1h9gL7HuM,657
 nsj_rest_lib2/compiler/util/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+nsj_rest_lib2/compiler/util/relation_ref.py,sha256=1M_e-NyeqozlIYLl1rB76KqkmtMvgtqH_nJS-NK0Pck,3695
 nsj_rest_lib2/compiler/util/str_util.py,sha256=0ReIQ2Vy4zAmVMvGv0FcUehRQw15hlz0e7yDsF89ghk,1178
 nsj_rest_lib2/compiler/util/type_naming_util.py,sha256=fPyzsEsbG9sgzaUJghamijcmZ6Odh_rIv3zk-lcP5pQ,1419
 nsj_rest_lib2/compiler/util/type_util.py,sha256=HTKOH4uRTOY0YgoM8oUv_6cEcReE_bgKYXFBsQCb-3A,357
@@ -33,7 +37,7 @@ nsj_rest_lib2/controller/dynamic_controller.py,sha256=UJtlr0_A6bGJ1gD24oj3481tCb
 nsj_rest_lib2/service/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 nsj_rest_lib2/service/entity_config_writer.py,sha256=DC8M4BYKfaOkNty1YFmAmWiNvENjvmiUqDKgsAV3eNc,4688
 nsj_rest_lib2/service/entity_loader.py,sha256=I8Ua2CPCxxUovHJn8SSRz0bYfmdFqfWj-JQfNTBBypc,17842
-nsj_rest_lib2-0.0.29.dist-info/METADATA,sha256=n4ENC9nHnSZETVqLpUKWLDM8qpf6U_nzpWpG9z1Af9w,1094
-nsj_rest_lib2-0.0.29.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-nsj_rest_lib2-0.0.29.dist-info/top_level.txt,sha256=L6zh0EfH8_rur7OJ8_V-El-XEMf4qg3bkF8ADgqLVIA,14
-nsj_rest_lib2-0.0.29.dist-info/RECORD,,
+nsj_rest_lib2-0.0.31.dist-info/METADATA,sha256=I1o7yO3ACZoRB6Qnw1qRhegqWBv5_MoK_f-VgIppAcM,1094
+nsj_rest_lib2-0.0.31.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+nsj_rest_lib2-0.0.31.dist-info/top_level.txt,sha256=L6zh0EfH8_rur7OJ8_V-El-XEMf4qg3bkF8ADgqLVIA,14
+nsj_rest_lib2-0.0.31.dist-info/RECORD,,

nsj_rest_lib2/compiler/ai_compiler.py

@@ -1,285 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-
-"""
-Gerador de DTO e Entity a partir de um EDL JSON (v1.x) — AGORA usando 'repository'
-no lugar de 'storage', e propagando o de-para de colunas:
- - Entity usa os nomes físicos vindos de model.repository.columns[*].column (quando houver).
- - DTOField ganha entity_field="<nome_do_atributo_na_Entity>" para cada propriedade.
-
-Uso:
-  python generator.py caminho/para/arquivo.edl.json
-"""
-
-import json
-import sys
-import keyword
-from typing import Any, Dict, List, Tuple
-
-# -----------------------
-# Helpers de transformação
-# -----------------------
-
-
-def py_identifier(name: str) -> str:
-    """Garante que o nome é um identificador Python válido."""
-    n = (name or "").strip().replace("-", "_")
-    if not n:
-        n = "_"
-    if not n.isidentifier() or keyword.iskeyword(n):
-        n = f"{n}_"
-    return n
-
-
-def detect_pk(model_props: Dict[str, Any]) -> str:
-    for logical, meta in model_props.items():
-        if isinstance(meta, dict) and meta.get("pk") is True:
-            return logical
-    return ""
-
-
-def to_python_type(prop: Dict[str, Any]) -> str:
-    t = (prop.get("type") or "string").lower()
-    fmt = (prop.get("format") or "").lower()
-
-    if fmt in {"uuid"}:
-        return "uuid.UUID"
-    if t in {"datetime"}:
-        return "datetime.datetime"
-    if t in {"date"}:
-        return "datetime.date"
-    if t in {"integer"}:
-        return "int"
-    if t in {"number"}:
-        return "float"
-    if t in {"boolean"}:
-        return "bool"
-    return "str"
-
-
-def build_entity_field_name(logical: str, columns_map: Dict[str, Any]) -> str:
-    """
-    Retorna o nome do atributo na Entity para um dado campo lógico,
-    priorizando o nome físico em repository.columns[logical].column (se existir).
-    """
-    col_meta = (columns_map or {}).get(logical) or {}
-    entity_attr = col_meta.get("column") or logical
-    return py_identifier(entity_attr)
-
-
-def dto_field_args(
-    logical: str,
-    prop: Dict[str, Any],
-    required: List[str],
-    columns_map: Dict[str, Any],
-) -> Dict[str, Any]:
-    args: Dict[str, Any] = {}
-
-    # Política: sempre expor (resume=True) e nunca ocultar campos que existem na origem
-    args["resume"] = True
-
-    # PK / not_null
-    if prop.get("pk") is True:
-        args["pk"] = True
-        args["not_null"] = True
-    if logical in set(required):
-        args["not_null"] = True
-
-    # Strings: strip + limites
-    t = (prop.get("type") or "string").lower()
-    if t == "string":
-        args["strip"] = True
-        if "length" in prop:
-            args["max"] = int(prop["length"])
-        if "minimum" in prop:
-            args["min"] = int(prop["minimum"])
-
-    # Números
-    if t in {"integer", "number"}:
-        if "minimum" in prop:
-            args["min"] = (
-                int(prop["minimum"]) if t == "integer" else float(prop["minimum"])
-            )
-        if "maximum" in prop:
-            args["max"] = (
-                int(prop["maximum"]) if t == "integer" else float(prop["maximum"])
-            )
-
-    # Formatos especiais
-    fmt = (prop.get("format") or "").lower()
-    if fmt == "uuid":
-        args["validator"] = "DTOFieldValidators().validate_uuid"
-        args["min"] = 36
-        args["max"] = 36
-
-    # Default lógico (quando presente)
-    if "default" in prop and prop["default"] is not None:
-        default_val = prop["default"]
-        if isinstance(default_val, (int, float, bool)):
-            args["default_value"] = repr(default_val)
-        elif isinstance(default_val, str) and default_val.endswith("()"):
-            args["default_value"] = default_val
-        else:
-            args["default_value"] = repr(default_val)
-
-    # Sempre informar o nome do atributo correspondente na Entity
-    args["entity_field"] = build_entity_field_name(logical, columns_map)
-
-    return args
-
-
-def render_dto(edl: Dict[str, Any]) -> Tuple[str, str]:
-    model = edl.get("model", {}) or {}
-    props: Dict[str, Any] = model.get("properties", {}) or {}
-    required: List[str] = model.get("required", []) or []
-    repository = model.get("repository", {}) or {}
-    columns_map: Dict[str, Any] = repository.get("columns", {}) or {}
-
-    entity_name_full = edl.get("id") or "Entity"
-    class_base = entity_name_full.split(".")[-1]
-    class_name = f"{class_base[0].upper()}{class_base[1:]}"
-    dto_class = f"{class_name}DTO"
-
-    # imports
-    need_uuid = any(((p.get("format") or "").lower() == "uuid") for p in props.values())
-    need_datetime = any(
-        ((p.get("type") or "").lower() in {"datetime", "date"}) for p in props.values()
-    )
-
-    header_imports = [
-        "from nsj_rest_lib.decorator.dto import DTO",
-        "from nsj_rest_lib.descriptor.dto_field import DTOField",
-        "from nsj_rest_lib.descriptor.dto_field_validators import DTOFieldValidators",
-        "from nsj_rest_lib.dto.dto_base import DTOBase",
-    ]
-    if need_uuid:
-        header_imports.insert(0, "import uuid")
-    if need_datetime:
-        header_imports.insert(0, "import datetime")
-
-    lines: List[str] = []
-    lines.extend(header_imports)
-    lines.append("")
-    lines.append("")
-    lines.append("@DTO()")
-    lines.append(f"class {dto_class}(DTOBase):")
-    if not props:
-        lines.append("    pass")
-        return (dto_class, "\n".join(lines))
-
-    for logical in props:
-        meta = props[logical] or {}
-        py_type = to_python_type(meta)
-        field_args = dto_field_args(logical, meta, required, columns_map)
-
-        # Monta chamada DTOField(...)
-        arg_parts = []
-        for k, v in field_args.items():
-            if k == "validator":
-                arg_parts.append(f"{k}={v}")
-            else:
-                arg_parts.append(f"{k}={repr(v)}")
-        args_str = ", ".join(arg_parts) if arg_parts else ""
-
-        lines.append("")
-        lines.append(f"    {py_identifier(logical)}: {py_type} = DTOField({args_str})")
-
-    return (dto_class, "\n".join(lines))
-
-
-def render_entity(edl: Dict[str, Any]) -> Tuple[str, str]:
-    model = edl.get("model", {}) or {}
-    props: Dict[str, Any] = model.get("properties", {}) or {}
-    repository = model.get("repository", {}) or {}
-    api = model.get("api", {}) or {}
-
-    entity_name_full = edl.get("id") or "Entity"
-    class_base = entity_name_full.split(".")[-1]
-    class_name = f"{class_base[0].upper()}{class_base[1:]}"
-    entity_class = f"{class_name}Entity"
-
-    table_name = repository.get("map") or "schema.tabela"
-    pk_field = detect_pk(props) or "id"
-
-    # default_order_fields = api.default_sort (removendo prefixos '+'|'-')
-    default_sort: List[str] = []
-    for item in api.get("default_sort", []) or []:
-        fld = str(item).lstrip("+-")
-        if fld in props:
-            default_sort.append(fld)
-    if not default_sort:
-        default_sort = [pk_field] if pk_field else []
-
-    # imports
-    need_uuid = any(((p.get("format") or "").lower() == "uuid") for p in props.values())
-    need_datetime = any(
-        ((p.get("type") or "").lower() in {"datetime", "date"}) for p in props.values()
-    )
-
-    header_imports = [
-        "from nsj_rest_lib.entity.entity_base import EntityBase",
-        "from nsj_rest_lib.decorator.entity import Entity",
-    ]
-    if need_uuid:
-        header_imports.insert(0, "import uuid")
-    if need_datetime:
-        header_imports.insert(0, "import datetime")
-
-    columns_map: Dict[str, Any] = repository.get("columns", {}) or {}
-
-    lines: List[str] = []
-    lines.extend(header_imports)
-    lines.append("")
-    lines.append("")
-    lines.append("@Entity(")
-    lines.append(f"    table_name={repr(table_name)},")
-    lines.append(f"    pk_field={repr(py_identifier(pk_field))},")
-    if default_sort:
-        lines.append(
-            f"    default_order_fields={[py_identifier(x) for x in default_sort]},"
-        )
-    lines.append(")")
-    lines.append(f"class {entity_class}(EntityBase):")
-
-    if not props:
-        lines.append("    pass")
-        return (entity_class, "\n".join(lines))
-
-    for logical, meta in props.items():
-        py_type = to_python_type(meta)
-        entity_attr = build_entity_field_name(logical, columns_map)
-        lines.append(f"    {entity_attr}: {py_type} = None")
-
-    return (entity_class, "\n".join(lines))
-
-
-def generate_from_edl(edl: Dict[str, Any]) -> Tuple[str, str, str, str]:
-    dto_class_name, dto_code = render_dto(edl)
-    entity_class_name, entity_code = render_entity(edl)
-    return (dto_class_name, dto_code, entity_class_name, entity_code)
-
-
-# -----------------------
-# CLI
-# -----------------------
-
-
-def main():
-    if len(sys.argv) < 2:
-        print("Uso: python generator.py caminho/para/arquivo.edl.json", file=sys.stderr)
-        sys.exit(2)
-
-    with open(sys.argv[1], "r", encoding="utf-8") as f:
-        edl = json.load(f)
-
-    _, dto_code, _, entity_code = generate_from_edl(edl)
-
-    sep = "\n" + ("#" * 80) + "\n"
-    print(sep + "# DTO\n" + sep)
-    print(dto_code)
-    print(sep + "# ENTITY\n" + sep)
-    print(entity_code)
-
-
-if __name__ == "__main__":
-    main()