nsj-rest-lib2 0.0.13__tar.gz → 0.0.15__tar.gz

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsj_rest_lib2
-Version: 0.0.13
+Version: 0.0.15
 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.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/compiler.py

@@ -3,10 +3,13 @@ import re
 from typing import Any
 
 from nsj_rest_lib2.compiler.compiler_structures import (
+    ComponentsCompilerStructure,
     IndexCompilerStructure,
     PropertiesCompilerStructure,
 )
 from nsj_rest_lib2.compiler.dto_compiler import DTOCompiler
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
+from nsj_rest_lib2.compiler.edl_model.entity_model_mixin import EntityModelMixin
 from nsj_rest_lib2.compiler.edl_model.primitives import REGEX_EXTERNAL_REF
 from nsj_rest_lib2.compiler.entity_compiler import EntityCompiler
 from nsj_rest_lib2.compiler.model import CompilerResult
@@ -16,16 +19,17 @@ from nsj_rest_lib2.compiler.edl_model.entity_model import EntityModel
 
 from nsj_rest_lib2.settings import get_logger
 
+# TODO Revisar compilação de valores default (sensível a tipos)
+# TODO Implementar suporte a conjuntos
 # TODO Autenticação nas rotas
-# TODO Carregar, dinamicamente, em memória, o código compilado das dependÊncias por relacionamento
 # TODO Atualizar o status da entidade pelo worker de compilação (e talvez parar uma compilação, quando se delete uma entidade)
-# TODO Relacionamentos
 # TODO Classes Abstratas
 # TODO Partial Classes
 # TODO Migrations
-# TODO Adicionar autenticação aos endpoints dinâmicos
 # TODO Criar imagem docker base para as aplicações, usando venv (para poderem atualizar o pydantic)
 
+# TODO Suporte ao "min_items" dos relacionamentos no RestLib1
+
 
 class EDLCompiler:
     def __init__(self) -> None:
@@ -40,8 +44,8 @@ class EDLCompiler:
         compiler_results = []
         for entity_model_id in entity_models:
             entity_model = entity_models[entity_model_id]
-            if not entity_model.abstract:
-                compiler_result = self._compile_model(entity_model, entity_models)
+            compiler_result = self._compile_model(entity_model, entity_models)
+            if compiler_result:
                 compiler_results.append(compiler_result)
 
         return compiler_results
@@ -50,35 +54,46 @@ class EDLCompiler:
         self,
         edl_json: dict[str, Any],
         dependencies_edls: list[dict[str, Any]],
-    ) -> CompilerResult:
+    ) -> CompilerResult | None:
         entity_model = EntityModel(**edl_json)
 
         entity_models = []
         for dependency_edl in dependencies_edls:
-            dependency_entity_model = EntityModel(**dependency_edl)
+            if "mixin" in dependency_edl and dependency_edl["mixin"]:
+                dependency_entity_model = EntityModelMixin(**dependency_edl)
+            else:
+                dependency_entity_model = EntityModel(**dependency_edl)
             entity_models.append(dependency_entity_model)
 
         return self.compile_model(entity_model, entity_models)
 
     def compile_model(
         self,
-        entity_model: EntityModel,
-        dependencies_models: list[EntityModel],
-    ) -> CompilerResult:
+        entity_model: EntityModelBase,
+        dependencies_models: list[tuple[str, EntityModelBase]],
+    ) -> CompilerResult | None:
         entity_models = {}
         for dependency_entity_model in dependencies_models:
-            complete_entity_id = (
-                f"{dependency_entity_model.escopo}/{dependency_entity_model.id}"
-            )
-            entity_models[complete_entity_id] = dependency_entity_model
+            complete_entity_id = dependency_entity_model[0]
+            entity_models[complete_entity_id] = dependency_entity_model[1]
 
         return self._compile_model(entity_model, entity_models)
 
     def _compile_model(
         self,
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         entity_models: dict[str, EntityModel],
-    ) -> CompilerResult:
+        escopo: str | None = None,
+        prefx_class_name: str = "",
+    ) -> CompilerResult | None:
+        if entity_model.mixin:
+            return None
+
+        if escopo is None and (isinstance(entity_model, EntityModel)):
+            escopo = entity_model.escopo
+
+        if not escopo:
+            raise Exception(f"Escopo não definido para a entidade: {entity_model.id}.")
 
         # Criando um mapa de índices por nome de property
         # TODO Implementar tratamento dos índices de apoio às query (não de unicidade)
@@ -109,10 +124,48 @@ class EDLCompiler:
         ) = self._properties_compiler.compile(
             properties_structure,
             map_unique_by_property,
+            escopo,
             entity_model,
             entity_models,
+            prefx_class_name,
         )
 
+        # Gerando o buffer para os códigos de DTO e Entity
+        dto_code = ""
+        entity_code = ""
+        relations_dependencies_complete = []
+
+        # Carregando a estrutura de compilação dos components
+        components_structure = ComponentsCompilerStructure()
+        self._make_components_structures(
+            components_structure, entity_model, entity_models
+        )
+
+        # Gerando o código das entidades filhas (components)
+        for component_key in components_structure.components:
+            component = components_structure.components[component_key]
+            component_compiled = self._compile_model(
+                component,
+                entity_models,
+                escopo,
+                prefx_class_name=f"{prefx_class_name}_{entity_model.id}",
+            )
+
+            if not component_compiled:
+                raise Exception(
+                    f"Erro ao compilar o component '{component_key}' da entidade '{entity_model.id}'. Gerou saída None, como se fosse um mixin."
+                )
+
+            # Guardando o código gerado no buffer
+            if component_compiled.dto_code:
+                dto_code += component_compiled.dto_code + "\n\n"
+            if component_compiled.entity_code:
+                entity_code += component_compiled.entity_code + "\n\n"
+            if component_compiled.relations_dependencies:
+                relations_dependencies_complete.extend(
+                    component_compiled.relations_dependencies
+                )
+
         # Gerando o código do DTO
         dto_class_name, code_dto = self._dto_compiler.compile(
             entity_model,
@@ -120,32 +173,71 @@ class EDLCompiler:
             enum_classes,
             related_imports,
             fixed_filters,
+            prefx_class_name,
         )
 
         # Gerando o código da Entity
         entity_class_name, code_entity = self._entity_compiler.compile(
-            entity_model, ast_entity_attributes, props_pk
+            entity_model,
+            ast_entity_attributes,
+            props_pk,
+            prefx_class_name,
         )
 
+        # Extendendo os buffers com os códigos gerados
+        dto_code += code_dto
+        entity_code += code_entity
+        relations_dependencies_complete.extend(relations_dependencies)
+
         # Construindo o resultado
         compiler_result = CompilerResult()
         compiler_result.entity_class_name = entity_class_name
-        compiler_result.entity_code = code_entity
+        compiler_result.entity_code = entity_code
         compiler_result.dto_class_name = dto_class_name
-        compiler_result.dto_code = code_dto
+        compiler_result.dto_code = dto_code
 
         # Compilando questões das APIs
-        compiler_result.api_expose = entity_model.api.expose
-        compiler_result.api_resource = entity_model.api.resource
-        compiler_result.api_verbs = entity_model.api.verbs
-        compiler_result.relations_dependencies = relations_dependencies
+        if isinstance(entity_model, EntityModel):
+            compiler_result.api_expose = entity_model.api.expose
+            compiler_result.api_resource = entity_model.api.resource
+            compiler_result.api_verbs = entity_model.api.verbs
+            compiler_result.relations_dependencies = relations_dependencies_complete
+
+        get_logger().debug(f"código gerado para a entidade: {entity_model.id}")
+        get_logger().debug("DTO Code:")
+        get_logger().debug(f"\n{dto_code}")
+        get_logger().debug("Entity Code:")
+        get_logger().debug(f"\n{entity_code}")
 
         return compiler_result
 
+    def _make_components_structures(
+        self,
+        components_structure: ComponentsCompilerStructure,
+        entity_model: EntityModelBase,
+        entity_models: dict[str, EntityModel],
+    ):
+        if not entity_model:
+            return
+
+        # Populando com os components do trait
+        if entity_model.trait_from:
+            trait_model = entity_models[entity_model.trait_from]
+
+            self._make_components_structures(
+                components_structure,
+                trait_model,
+                entity_models,
+            )
+
+        # Populando com os components da entidade atual
+        if entity_model.components:
+            components_structure.components.update(entity_model.components)
+
     def _make_properties_structures(
         self,
         properties_structure: PropertiesCompilerStructure,
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         entity_models: dict[str, EntityModel],
     ):
         if not entity_model:
@@ -184,11 +276,24 @@ class EDLCompiler:
                 entity_model.repository.properties
             )
 
+        # Populando com as propriedades dos mixins
+        if entity_model.mixins:
+            for mixin_id in entity_model.mixins:
+                if mixin_id not in entity_models:
+                    raise Exception(f"Mixin '{mixin_id}' não encontrado.")
+
+                mixin_model = entity_models[mixin_id]
+                self._make_properties_structures(
+                    properties_structure,
+                    mixin_model,
+                    entity_models,
+                )
+
     def _make_unique_map_by_property(
         self,
         map_indexes_by_property: dict[str, list[IndexCompilerStructure]],
         map_unique_by_property: dict[str, IndexCompilerStructure],
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         entity_models: dict[str, EntityModel],
         deep: int = 1,
     ):
@@ -233,18 +338,25 @@ class EDLCompiler:
 
     def list_dependencies(
         self, edl_json: dict[str, Any]
-    ) -> tuple[list[str], EntityModel]:
-        entity_model = EntityModel(**edl_json)
+    ) -> tuple[list[str], EntityModelBase]:
+        if edl_json.get("mixin", False):
+            entity_model = EntityModelMixin(**edl_json)
+        else:
+            entity_model = EntityModel(**edl_json)
 
         return (self._list_dependencies(entity_model), entity_model)
 
-    def _list_dependencies(self, entity_model: EntityModel) -> list[str]:
+    def _list_dependencies(self, entity_model: EntityModelBase) -> list[str]:
         entities: list[str] = []
 
         # Adicionando dependências por traits
         if entity_model.trait_from:
             entities.append(entity_model.trait_from)
 
+        # Adicionando dependências por mixins
+        if entity_model.mixins:
+            entities.extend(entity_model.mixins)
+
         # Populando com as dependências de propriedades de relacionamento
         relations = self._list_dependencies_relations(entity_model)
         entities.extend(relations)
@@ -306,7 +418,10 @@ if __name__ == "__main__":
         # Instanciando o objeto de modelo de entidade a partir do JSON,
         # e já realizando as validações básicas de tipo e estrutura.
         print(f"Validando arquivo: {file}")
-        entity_model = EntityModel(**edl)
+        if edl.get("mixin", False):
+            entity_model = EntityModelMixin(**edl)
+        else:
+            entity_model = EntityModel(**edl)
 
         complete_entity_id = f"{entity_model.escopo}/{entity_model.id}"
         entities[complete_entity_id] = entity_model

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/compiler_structures.py

@@ -1,4 +1,5 @@
 from nsj_rest_lib2.compiler.edl_model.column_meta_model import ColumnMetaModel
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
 from nsj_rest_lib2.compiler.edl_model.index_model import IndexModel
 from nsj_rest_lib2.compiler.edl_model.property_meta_model import PropertyMetaModel
 from nsj_rest_lib2.compiler.edl_model.trait_property_meta_model import (
@@ -22,3 +23,8 @@ class PropertiesCompilerStructure:
         self.metric_label: list[str] = []
         self.entity_properties: dict[str, ColumnMetaModel] = {}
         self.trait_properties: dict[str, TraitPropertyMetaModel] = {}
+
+
+class ComponentsCompilerStructure:
+    def __init__(self) -> None:
+        self.components: dict[str, EntityModelBase] = {}

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/dto_compiler.py

@@ -3,8 +3,8 @@ import ast
 import black
 
 from nsj_rest_lib2.compiler.edl_model.entity_model import EntityModel
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
 from nsj_rest_lib2.compiler.edl_model.primitives import BasicTypes
-from nsj_rest_lib2.compiler.util.str_util import CompilerStrUtil
 from nsj_rest_lib2.compiler.util.type_naming_util import compile_dto_class_name
 
 
@@ -14,11 +14,12 @@ class DTOCompiler:
 
     def compile(
         self,
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         ast_dto_attributes: list[ast.stmt],
         enum_classes: list[ast.stmt],
         related_imports: list[tuple[str, str, str]],
         fixed_filters: list[tuple[str, BasicTypes]],
+        prefx_class_name: str,
     ) -> tuple[str, str]:
         """
         Compila o código do DTO a partir do AST e retorna o código compilado.
@@ -117,7 +118,7 @@ class DTOCompiler:
             )
 
         # Criando o ast da classe
-        class_name = compile_dto_class_name(entity_model.id)
+        class_name = compile_dto_class_name(entity_model.id, prefx_class_name)
         ast_class = ast.ClassDef(
             name=class_name,
             bases=[ast.Name(id="DTOBase", ctx=ast.Load())],

nsj_rest_lib2-0.0.15/nsj_rest_lib2/compiler/edl_model/entity_model.py

@@ -0,0 +1,22 @@
+from __future__ import annotations
+
+from pydantic import Field
+from typing import Optional
+
+from nsj_rest_lib2.compiler.edl_model.api_model import APIModel
+from nsj_rest_lib2.compiler.edl_model.entity_model_mixin import EntityModelMixin
+
+
+class EntityModel(EntityModelMixin):
+    edl_version: Optional[str] = Field(default="1.0", description="Versão do EDL")
+    version: Optional[str] = Field(
+        default="1.0", description="Versão da entidade (padrão: 1.0)."
+    )
+    abstract: Optional[bool] = Field(
+        default=False,
+        description="Indica se a entidade é abstrata (padrão: False). Caso positivo, não gera código, mas pode ser usada na geração de código de outras entidades.",
+    )
+    api: APIModel = Field(
+        ...,
+        description="Definição da API REST associada ao modelo, com todos os seus endpoints.",
+    )

nsj_rest_lib2-0.0.13/nsj_rest_lib2/compiler/edl_model/entity_model.py → nsj_rest_lib2-0.0.15/nsj_rest_lib2/compiler/edl_model/entity_model_base.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import uuid
 
 from pydantic import BaseModel, Field
@@ -5,15 +7,12 @@ from typing import Dict, List, Optional
 
 from nsj_rest_lib2.compiler.edl_model.property_meta_model import PropertyMetaModel
 from nsj_rest_lib2.compiler.edl_model.repository_model import RepositoryModel
-from nsj_rest_lib2.compiler.edl_model.api_model import APIModel
 from nsj_rest_lib2.compiler.edl_model.trait_property_meta_model import (
     TraitPropertyMetaModel,
 )
 
 
-class EntityModel(BaseModel):
-    edl_version: Optional[str] = Field(default="1.0", description="Versão do EDL")
-    escopo: str = Field(..., description="Escopo do EDL (define a aplicação).")
+class EntityModelBase(BaseModel):
     description: str = Field(..., description="Descrição da entidade.")
     id: str = Field(
         ...,
@@ -22,13 +21,6 @@ class EntityModel(BaseModel):
     trait_from: Optional[str] = Field(
         None, description="Identificador da entidade que a trait estende."
     )
-    version: Optional[str] = Field(
-        default="1.0", description="Versão da entidade (padrão: 1.0)."
-    )
-    abstract: Optional[bool] = Field(
-        default=False,
-        description="Indica se a entidade é abstrata (padrão: False). Caso positivo, não gera código, mas pode ser usada na geração de código de outras entidades.",
-    )
     mixins: Optional[List[str]] = Field(
         None,
         description="Lista de mixins (blocos reutilizáveis) aplicados ao modelo.",
@@ -36,6 +28,10 @@ class EntityModel(BaseModel):
     required: Optional[List[str]] = Field(
         None, description="Lista de campos obrigatórios no modelo."
     )
+    mixin: Optional[bool] = Field(
+        False,
+        description="Indica se o modelo é um mixin (bloco reutilizável, que não gera contém tabela própria no banco).",
+    )
     partition_data: Optional[List[str]] = Field(
         None,
         description="Lista de propriedades da entidade, que serã usadas para particionamento dos dados no banco (sendo obrigatórias em todas as chamadas, inclusive como um tipo de filtro obrigatório).",
@@ -59,16 +55,19 @@ class EntityModel(BaseModel):
     properties: Dict[str, PropertyMetaModel] = Field(
         ..., description="Dicionário de propriedades do modelo."
     )
+    components: Optional[Dict[str, "EntityModelBase"]] = Field(
+        None,
+        description="Entidades filhas, relacionadas por composição e definidas inline (evitando a criação de novos arquivos EDL para a definição de entidades componentes da entidade atual).",
+    )
     repository: RepositoryModel = Field(
         ..., description="Configurações de mapeamento para o banco de dados."
     )
-    api: APIModel = Field(
-        ...,
-        description="Definição da API REST associada ao modelo, com todos os seus endpoints.",
-    )
 
     # Propriedades de controle da compilação (não fazem parte do JSON de representação das entidades)
     tenant: int = Field(default=0, exclude=True)
     grupo_empresarial: uuid.UUID = Field(
         default=uuid.UUID("00000000-0000-0000-0000-000000000000"), exclude=True
     )
+
+
+EntityModelBase.model_rebuild()

nsj_rest_lib2-0.0.15/nsj_rest_lib2/compiler/edl_model/entity_model_mixin.py

@@ -0,0 +1,7 @@
+from pydantic import Field
+
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
+
+
+class EntityModelMixin(EntityModelBase):
+    escopo: str = Field(..., description="Escopo do EDL (define a aplicação).")

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/edl_model/primitives.py

@@ -4,7 +4,7 @@ from typing import Annotated, List, Union
 from pydantic import StringConstraints
 
 REGEX_EXTERNAL_REF = r"^(\w+)\/(\w+)$"
-REGEX_INTERNAL_REF = r"^#\/(\w+)\/(\w+)$"
+REGEX_INTERNAL_REF = r"^#\/components\/(\w+)$"
 
 ExternalRefType = Annotated[str, StringConstraints(pattern=REGEX_EXTERNAL_REF)]
 InternalRefType = Annotated[str, StringConstraints(pattern=REGEX_INTERNAL_REF)]

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/entity_compiler.py

@@ -3,7 +3,7 @@ import ast
 import black
 
 from nsj_rest_lib2.compiler.edl_model.entity_model import EntityModel
-from nsj_rest_lib2.compiler.edl_model.repository_model import RepositoryModel
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
 from nsj_rest_lib2.compiler.util.str_util import CompilerStrUtil
 from nsj_rest_lib2.compiler.util.type_naming_util import compile_entity_class_name
 
@@ -14,9 +14,10 @@ class EntityCompiler:
 
     def compile(
         self,
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         ast_entity_attributes: list[ast.stmt],
         props_pk: list[str],
+        prefix_class_name: str,
     ) -> tuple[str, str]:
         # Imports
         imports = [
@@ -49,7 +50,11 @@ class EntityCompiler:
             )
 
         default_order_props = []
-        if entity_model.api and entity_model.api.default_sort:
+        if (
+            isinstance(entity_model, EntityModel)
+            and entity_model.api
+            and entity_model.api.default_sort
+        ):
             default_order_props = entity_model.api.default_sort
 
         default_order_fields = []
@@ -67,7 +72,7 @@ class EntityCompiler:
         if CompilerStrUtil.to_snake_case(props_pk[0]) not in default_order_fields:
             default_order_fields.append(CompilerStrUtil.to_snake_case(props_pk[0]))
 
-        class_name = compile_entity_class_name(entity_model.id)
+        class_name = compile_entity_class_name(entity_model.id, prefix_class_name)
         ast_class = ast.ClassDef(
             name=class_name,
             bases=[ast.Name(id="EntityBase", ctx=ast.Load())],

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/compiler/property_compiler.py

@@ -6,6 +6,7 @@ from nsj_rest_lib2.compiler.compiler_structures import (
     PropertiesCompilerStructure,
 )
 from nsj_rest_lib2.compiler.edl_model.entity_model import EntityModel
+from nsj_rest_lib2.compiler.edl_model.entity_model_base import EntityModelBase
 from nsj_rest_lib2.compiler.edl_model.primitives import (
     BasicTypes,
     CardinalityTypes,
@@ -29,16 +30,18 @@ from nsj_rest_lib2.compiler.util.type_util import TypeUtil
 # TODO pattern
 # TODO lowercase
 # TODO uppercase
-# TODO Adicionar o nome da entidade, no nome das classes de enum (para evitar conflitos no caso das traits)
 
 
 class EDLPropertyCompiler:
+
     def compile(
         self,
         properties_structure: PropertiesCompilerStructure,
         map_unique_by_property: dict[str, IndexCompilerStructure],
-        entity_model: EntityModel,
+        escopo: str,
+        entity_model: EntityModelBase,
         entity_models: dict[str, EntityModel],
+        prefx_class_name: str,
     ) -> tuple[
         list[ast.stmt],
         list[ast.stmt],
@@ -52,22 +55,24 @@ class EDLPropertyCompiler:
         # TODO Criar opção de campo calculado?
 
         # Descobrindo os atributos marcados como PK (e recuperando a chave primária)
-        # pk_keys = []
-        # for pkey in properties_structure.properties:
-        #     prop = properties_structure.properties[pkey]
-
-        #     if isinstance(prop.type, PrimitiveTypes):
-        #         if prop.pk:
-        #             pk_keys.append(pkey)
-
-        # if len(pk_keys) > 1:
-        #     raise Exception(
-        #         f"Entidade '{entity_model.id}' possui mais de uma chave primária (ainda não suportado): {pk_keys}"
-        #     )
-        # elif len(pk_keys) == 0:
-        #     raise Exception(
-        #         f"Entidade '{entity_model.id}' não tem nenhuma chave primária (ainda não suportado)"
-        #     )
+        # TODO Verificar se devemos manter essa verificação
+        pk_keys = []
+        for pkey in properties_structure.properties:
+            prop = properties_structure.properties[pkey]
+
+            if isinstance(prop.type, PrimitiveTypes):
+                if prop.pk:
+                    pk_keys.append(pkey)
+
+        if not entity_model.mixin:
+            if len(pk_keys) > 1:
+                raise Exception(
+                    f"Entidade '{entity_model.id}' possui mais de uma chave primária (ainda não suportado): {pk_keys}"
+                )
+            elif len(pk_keys) == 0:
+                raise Exception(
+                    f"Entidade '{entity_model.id}' não tem nenhuma chave primária (ainda não suportado)"
+                )
 
         # pk_key = pk_keys[0]
 
@@ -87,11 +92,12 @@ class EDLPropertyCompiler:
             prop = properties_structure.properties[pkey]
 
             # DTO
-            ## Tratando propriedade simples (não array, não object)
             if isinstance(prop.type, PrimitiveTypes):
+                # Tratando propriedade simples (não array, não object)
                 self._compile_simple_property(
                     properties_structure,
                     map_unique_by_property,
+                    escopo,
                     entity_model,
                     ast_dto_attributes,
                     ast_entity_attributes,
@@ -99,9 +105,11 @@ class EDLPropertyCompiler:
                     enum_classes,
                     pkey,
                     prop,
+                    prefx_class_name,
                 )
 
             elif isinstance(prop.type, str):
+                # Tratando propriedade de relacionamento
                 external_match = re.match(REGEX_EXTERNAL_REF, prop.type)
                 internal_match = re.match(REGEX_INTERNAL_REF, prop.type)
 
@@ -125,8 +133,18 @@ class EDLPropertyCompiler:
                     )
 
                 elif internal_match:
-                    # TODO
-                    pass
+                    related_entity_id = internal_match.group(1)
+
+                    self._compile_internal_relation(
+                        related_entity_id,
+                        entity_model,
+                        properties_structure,
+                        ast_dto_attributes,
+                        ast_entity_attributes,
+                        pkey,
+                        prop,
+                        prefx_class_name,
+                    )
                 else:
                     raise Exception(
                         f"Tipo da propriedade '{pkey}' não suportado: {prop.type}"
@@ -143,8 +161,10 @@ class EDLPropertyCompiler:
                 ast_dto_attributes,
                 ast_entity_attributes,
                 fixed_filters,
+                escopo,
                 entity_model,
                 enum_classes,
+                prefx_class_name,
             )
 
         return (
@@ -166,8 +186,10 @@ class EDLPropertyCompiler:
         ast_dto_attributes: list[ast.stmt],
         ast_entity_attributes: list[ast.stmt],
         fixed_filters: list[tuple[str, BasicTypes]],
-        entity_model: EntityModel,
+        escopo: str,
+        entity_model: EntityModelBase,
         enum_classes: list[ast.stmt],
+        prefx_class_name: str,
     ):
         enum_class_name = None
         keywords = []
@@ -273,7 +295,9 @@ class EDLPropertyCompiler:
 
         # Trtando de uma definição de enum
         if prop.domain_config:
-            result = self._compile_domain_config(pkey, prop, entity_model)
+            result = self._compile_domain_config(
+                pkey, prop, escopo, entity_model, prefx_class_name
+            )
             if not result:
                 raise Exception(f"Erro desconhecido ao compilar a propriedade {pkey}")
 
@@ -343,14 +367,14 @@ class EDLPropertyCompiler:
         ast_entity_attributes.append(ast_entity_attr)
 
         # Guardando como um fixed_filter
-        # TODO Pernsar em validações para esse value (se está de acordo com o tipo ou enum)
+        # TODO Pensar em validações para esse value (se está de acordo com o tipo ou enum)
         fixed_filters.append((pkey, prop.value))
 
     def _compile_external_relation(
         self,
         related_entity_id: str,
         related_entity_key: str,
-        entity_model: EntityModel,
+        entity_model: EntityModelBase,
         entity_models: dict[str, EntityModel],
         properties_structure: PropertiesCompilerStructure,
         ast_dto_attributes: list[ast.stmt],
@@ -414,6 +438,57 @@ class EDLPropertyCompiler:
                 pkey,
                 related_dto_class_name,
                 related_entity_class_name,
+                prop,
+            )
+
+        elif prop.cardinality == CardinalityTypes.C1_1:
+            self._build_ast_1_1(
+                properties_structure,
+                ast_dto_attributes,
+                ast_entity_attributes,
+                pkey,
+                related_dto_class_name,
+                related_entity_class_name,
+                prop,
+            )
+
+        elif prop.cardinality == CardinalityTypes.CN_N:
+            # TODO
+            pass
+        else:
+            raise Exception(
+                f"Propriedade '{pkey}' da entidade '{entity_model.id}' possui cardinalidade inválida ou não suportada: {prop.cardinality}"
+            )
+
+    def _compile_internal_relation(
+        self,
+        related_entity_id: str,
+        entity_model: EntityModelBase,
+        properties_structure: PropertiesCompilerStructure,
+        ast_dto_attributes: list[ast.stmt],
+        ast_entity_attributes: list[ast.stmt],
+        pkey: str,
+        prop: PropertyMetaModel,
+        prefx_class_name: str,
+    ):
+        # Resolvendo o nome das classes de DTO e Entity
+        related_dto_class_name = compile_dto_class_name(
+            related_entity_id, f"{prefx_class_name}_{entity_model.id}"
+        )
+        related_entity_class_name = compile_entity_class_name(
+            related_entity_id, f"{prefx_class_name}_{entity_model.id}"
+        )
+
+        # Instanciando o ast
+        if prop.cardinality == CardinalityTypes.C1_N:
+            # Para relacionamentos 1_N
+            self._build_ast_1_N(
+                properties_structure,
+                ast_dto_attributes,
+                pkey,
+                related_dto_class_name,
+                related_entity_class_name,
+                prop,
             )
 
         elif prop.cardinality == CardinalityTypes.C1_1:
@@ -424,6 +499,7 @@ class EDLPropertyCompiler:
                 pkey,
                 related_dto_class_name,
                 related_entity_class_name,
+                prop,
             )
 
         elif prop.cardinality == CardinalityTypes.CN_N:
@@ -441,7 +517,10 @@ class EDLPropertyCompiler:
         pkey: str,
         related_dto_class_name: str,
         related_entity_class_name: str,
+        prop: PropertyMetaModel,
     ):
+        # TODO Verificar uso da propriedade relation_key_field do Rest_lib_1
+
         # Propriedade do property descriptor
         keywords = [
             ast.keyword(
@@ -454,6 +533,23 @@ class EDLPropertyCompiler:
             ),
         ]
 
+        # Tratando das opções básicas do descritor de propriedade
+        if properties_structure.required and pkey in properties_structure.required:
+            keywords.append(ast.keyword(arg="not_null", value=ast.Constant(True)))
+
+        if prop.max_length:
+            keywords.append(ast.keyword(arg="max", value=ast.Constant(prop.max_length)))
+        if prop.min_length:
+            keywords.append(ast.keyword(arg="min", value=ast.Constant(prop.min_length)))
+
+        if prop.validator:
+            keywords.append(
+                ast.keyword(
+                    arg="validator",
+                    value=ast.Name(prop.validator, ctx=ast.Load()),
+                )
+            )
+
         # Resolvendo a coluna usada no relacionamento
         if (
             not properties_structure.entity_properties
@@ -464,7 +560,10 @@ class EDLPropertyCompiler:
                 f"Propriedade '{pkey}' possui um relacionamento, mas nenhuma coluna de relacioanamento foi apontada na propriedade correspondente no repository."
             )
 
-        relation_column = properties_structure.entity_properties[pkey].relation_column
+        relation_column_ref = properties_structure.entity_properties[
+            pkey
+        ].relation_column
+        relation_column = str(relation_column_ref).split("/")[-1]
 
         keywords.append(
             ast.keyword(
@@ -497,6 +596,7 @@ class EDLPropertyCompiler:
         pkey: str,
         related_dto_class_name: str,
         related_entity_class_name: str,
+        prop: PropertyMetaModel,
     ):
         # Propriedade do property descriptor
         keywords = [
@@ -506,6 +606,24 @@ class EDLPropertyCompiler:
             ),
         ]
 
+        # Tratando das opções básicas do descritor de propriedade
+        if properties_structure.required and pkey in properties_structure.required:
+            keywords.append(ast.keyword(arg="not_null", value=ast.Constant(True)))
+
+        if (
+            properties_structure.main_properties
+            and pkey in properties_structure.main_properties
+        ):
+            keywords.append(ast.keyword(arg="resume", value=ast.Constant(True)))
+
+        if prop.validator:
+            keywords.append(
+                ast.keyword(
+                    arg="validator",
+                    value=ast.Name(prop.validator, ctx=ast.Load()),
+                )
+            )
+
         # Resolvendo a coluna usada no relacionamento
         if (
             not properties_structure.entity_properties
@@ -525,6 +643,9 @@ class EDLPropertyCompiler:
             owner_relation = True
             relation_column = relation_column.split("/")[-1]
 
+        # TODO Verificar, porque desconfio que o apontamento para a coluna de relacionamento
+        # para o caso do relacionamento OTHER, não é suportado pelo RestLib (acho que, quando
+        # o dono é OTHER, o RestLib sempre aponta para a PK da entidade corrente).
         keywords.append(
             ast.keyword(
                 arg="relation_field",
@@ -621,6 +742,7 @@ class EDLPropertyCompiler:
         self,
         properties_structure,
         map_unique_by_property,
+        escopo,
         entity_model,
         ast_dto_attributes,
         ast_entity_attributes,
@@ -628,6 +750,7 @@ class EDLPropertyCompiler:
         enum_classes,
         pkey,
         prop,
+        prefx_class_name: str,
     ):
         enum_class_name = None
         keywords = []
@@ -681,18 +804,18 @@ class EDLPropertyCompiler:
         if prop.type in [PrimitiveTypes.STRING, PrimitiveTypes.EMAIL]:
             if prop.max_length:
                 max = prop.max_length
-            elif prop.min_length:
+            if prop.min_length:
                 min = prop.min_length
         elif prop.type in [PrimitiveTypes.INTEGER, PrimitiveTypes.NUMBER]:
             if prop.minimum:
                 min = prop.minimum
-            elif prop.maximum:
+            if prop.maximum:
                 max = prop.maximum
 
         if max:
-            keywords.append(ast.keyword(arg="max", value=ast.Constant(prop.max_length)))
+            keywords.append(ast.keyword(arg="max", value=ast.Constant(max)))
         if min:
-            keywords.append(ast.keyword(arg="min", value=ast.Constant(prop.min_length)))
+            keywords.append(ast.keyword(arg="min", value=ast.Constant(min)))
 
         if (
             properties_structure.search_properties
@@ -796,7 +919,9 @@ class EDLPropertyCompiler:
             )
 
         if prop.domain_config:
-            result = self._compile_domain_config(pkey, prop, entity_model)
+            result = self._compile_domain_config(
+                pkey, prop, escopo, entity_model, prefx_class_name
+            )
             if not result:
                 raise Exception(f"Erro desconhecido ao compilar a propriedade {pkey}")
 
@@ -839,7 +964,9 @@ class EDLPropertyCompiler:
         self,
         pkey: str,
         prop: PropertyMetaModel | TraitPropertyMetaModel,
-        entity_model: EntityModel,
+        escopo: str,
+        entity_model: EntityModelBase,
+        prefx_class_name: str,
     ) -> tuple[str, ast.stmt] | None:
         if not prop.domain_config:
             return None
@@ -881,7 +1008,7 @@ class EDLPropertyCompiler:
             ast_values.append(ast_value)
 
         # Instanciando o atributo AST
-        enum_class_name = f"{CompilerStrUtil.to_pascal_case(entity_model.escopo)}{CompilerStrUtil.to_pascal_case(entity_model.id)}{CompilerStrUtil.to_pascal_case(pkey)}Enum"
+        enum_class_name = f"{CompilerStrUtil.to_pascal_case(escopo)}{CompilerStrUtil.to_pascal_case(prefx_class_name)}{CompilerStrUtil.to_pascal_case(entity_model.id)}{CompilerStrUtil.to_pascal_case(pkey)}Enum"
         ast_enum_class = ast.ClassDef(
             name=enum_class_name,
             bases=[

nsj_rest_lib2-0.0.15/nsj_rest_lib2/compiler/util/type_naming_util.py

@@ -0,0 +1,21 @@
+import uuid
+
+from nsj_rest_lib2.compiler.util.str_util import CompilerStrUtil
+
+
+def compile_namespace_keys(
+    tenant: str | int | None, grupo_empresarial: str | uuid.UUID | None
+) -> tuple[str, str, str]:
+    grupo_key = f"tenant_{tenant}.ge_{grupo_empresarial}"
+    tenant_key = f"tenant_{tenant}"
+    default_key = "default"
+
+    return (grupo_key, tenant_key, default_key)
+
+
+def compile_dto_class_name(entity_id: str, prefx_class_name: str = "") -> str:
+    return f"{CompilerStrUtil.to_pascal_case(prefx_class_name)}{CompilerStrUtil.to_pascal_case(entity_id)}DTO"
+
+
+def compile_entity_class_name(entity_id: str, prefx_class_name: str = "") -> str:
+    return f"{CompilerStrUtil.to_pascal_case(prefx_class_name)}{CompilerStrUtil.to_pascal_case(entity_id)}Entity"

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2/service/entity_loader.py

@@ -317,8 +317,14 @@ class EntityLoader:
                 namespace.module = module
                 namespace.entities_dict = module.__dict__
 
-            self._safe_exec(source_dto, namespace.entities_dict, "DTO source")
+            get_logger().debug(
+                f"Executando o código da entidade {entity_resource} no namespace {entity_config_key}. Código:"
+            )
+            get_logger().debug(f"Entity source:\n{source_entity}")
+            get_logger().debug(f"DTO source:\n{source_dto}")
+
             self._safe_exec(source_entity, namespace.entities_dict, "Entity source")
+            self._safe_exec(source_dto, namespace.entities_dict, "DTO source")
 
             # Gravando a entidade no dict de entidades carregadas
             loaded_entity = LoadedEntity()

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsj_rest_lib2
-Version: 0.0.13
+Version: 0.0.15
 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.13 → nsj_rest_lib2-0.0.15}/nsj_rest_lib2.egg-info/SOURCES.txt

@@ -23,6 +23,8 @@ setup.cfg
 ./nsj_rest_lib2/compiler/edl_model/api_model.py
 ./nsj_rest_lib2/compiler/edl_model/column_meta_model.py
 ./nsj_rest_lib2/compiler/edl_model/entity_model.py
+./nsj_rest_lib2/compiler/edl_model/entity_model_base.py
+./nsj_rest_lib2/compiler/edl_model/entity_model_mixin.py
 ./nsj_rest_lib2/compiler/edl_model/index_model.py
 ./nsj_rest_lib2/compiler/edl_model/primitives.py
 ./nsj_rest_lib2/compiler/edl_model/property_meta_model.py
@@ -58,6 +60,8 @@ nsj_rest_lib2/compiler/edl_model/ai_entity_edl.py
 nsj_rest_lib2/compiler/edl_model/api_model.py
 nsj_rest_lib2/compiler/edl_model/column_meta_model.py
 nsj_rest_lib2/compiler/edl_model/entity_model.py
+nsj_rest_lib2/compiler/edl_model/entity_model_base.py
+nsj_rest_lib2/compiler/edl_model/entity_model_mixin.py
 nsj_rest_lib2/compiler/edl_model/index_model.py
 nsj_rest_lib2/compiler/edl_model/primitives.py
 nsj_rest_lib2/compiler/edl_model/property_meta_model.py

{nsj_rest_lib2-0.0.13 → nsj_rest_lib2-0.0.15}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = nsj_rest_lib2
-version = 0.0.13
+version = 0.0.15
 author = Nasajon Sistemas
 author_email = contact.dev@nasajon.com.br
 description = Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configuradas por meio de EDLs declarativos (em formato JSON).

nsj_rest_lib2-0.0.13/nsj_rest_lib2/compiler/util/type_naming_util.py

@@ -1,21 +0,0 @@
-import uuid
-
-from nsj_rest_lib2.compiler.util.str_util import CompilerStrUtil
-
-
-def compile_namespace_keys(
-    tenant: str | int | None, grupo_empresarial: str | uuid.UUID | None
-) -> tuple[str, str, str]:
-    grupo_key = f"tenant_{tenant}.ge_{grupo_empresarial}"
-    tenant_key = f"tenant_{tenant}"
-    default_key = "default"
-
-    return (grupo_key, tenant_key, default_key)
-
-
-def compile_dto_class_name(entity_id: str) -> str:
-    return f"{CompilerStrUtil.to_pascal_case(entity_id)}DTO"
-
-
-def compile_entity_class_name(entity_id: str) -> str:
-    return f"{CompilerStrUtil.to_pascal_case(entity_id)}Entity"