nsj-rest-lib2 0.0.16__tar.gz → 0.0.18__tar.gz

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsj_rest_lib2
-Version: 0.0.16
+Version: 0.0.18
 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
@@ -31,3 +31,6 @@ Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configur
 * Rever modo de usar o InjectFactory (talvez dando ciência, ao RestLib, do padrão multibanco)
 * Implementar e documentar campos join
 * Implementar e documentar conjuntos
+* Dar erro ao haver conflito de nomes das propriedades (por qualquer tipo de herança)
+* Rotas para o inline
+* inline será para composição (arquivo externo é agregação)

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/README.md

@@ -9,4 +9,7 @@ Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configur
 * Usar pydantic, ou similar, para transformar a configuração das entidades, no redis, num objeto
 * Rever modo de usar o InjectFactory (talvez dando ciência, ao RestLib, do padrão multibanco)
 * Implementar e documentar campos join
-* Implementar e documentar conjuntos
+* Implementar e documentar conjuntos
+* Dar erro ao haver conflito de nomes das propriedades (por qualquer tipo de herança)
+* Rotas para o inline
+* inline será para composição (arquivo externo é agregação)

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/compiler.py

@@ -118,7 +118,7 @@ class EDLCompiler:
             ast_dto_attributes,
             ast_entity_attributes,
             props_pk,
-            enum_classes,
+            aux_classes,
             related_imports,
             relations_dependencies,
             fixed_filters,
@@ -171,7 +171,7 @@ class EDLCompiler:
         dto_class_name, code_dto = self._dto_compiler.compile(
             entity_model,
             ast_dto_attributes,
-            enum_classes,
+            aux_classes,
             related_imports,
             fixed_filters,
             prefx_class_name,
@@ -305,6 +305,16 @@ class EDLCompiler:
         if entity_model.trait_properties:
             properties_structure.trait_properties.update(entity_model.trait_properties)
 
+        if entity_model.extends_properties:
+            properties_structure.extends_properties.update(
+                entity_model.extends_properties
+            )
+
+        if entity_model.composed_properties:
+            properties_structure.composed_properties.update(
+                entity_model.composed_properties
+            )
+
         if entity_model.repository.properties:
             properties_structure.entity_properties.update(
                 entity_model.repository.properties

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/compiler_structures.py

@@ -3,6 +3,7 @@ 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 (
+    ExtendsPropertyMetaModel,
     TraitPropertyMetaModel,
 )
 
@@ -23,6 +24,8 @@ class PropertiesCompilerStructure:
         self.metric_label: list[str] = []
         self.entity_properties: dict[str, ColumnMetaModel] = {}
         self.trait_properties: dict[str, TraitPropertyMetaModel] = {}
+        self.extends_properties: dict[str, ExtendsPropertyMetaModel] = {}
+        self.composed_properties: dict[str, list[str]] = {}
 
 
 class ComponentsCompilerStructure:

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/dto_compiler.py

@@ -16,7 +16,7 @@ class DTOCompiler:
         self,
         entity_model: EntityModelBase,
         ast_dto_attributes: list[ast.stmt],
-        enum_classes: list[ast.stmt],
+        aux_classes: list[ast.stmt],
         related_imports: list[tuple[str, str, str]],
         fixed_filters: list[tuple[str, BasicTypes]],
         prefx_class_name: str,
@@ -30,8 +30,8 @@ class DTOCompiler:
         :param ast_dto_attributes: Atributos do DTO
         :type ast_dto_attributes: list[ast.stmt]
 
-        :param enum_classes: Classes de enumeração
-        :type enum_classes: list[ast.stmt]
+        :param aux_classes: Classes auxiliares (enums, agregadores, etc.)
+        :type aux_classes: list[ast.stmt]
 
         :return: Código compilado do DTO
         :rtype: str
@@ -86,6 +86,12 @@ class DTOCompiler:
                 names=[ast.alias(name="DTOObjectField", asname=None)],
                 level=0,
             ),
+            # from nsj_rest_lib.descriptor import DTOAggregator
+            ast.ImportFrom(
+                module="nsj_rest_lib.descriptor",
+                names=[ast.alias(name="DTOAggregator", asname=None)],
+                level=0,
+            ),
         ]
 
         for import_ in related_imports:
@@ -135,7 +141,7 @@ class DTOCompiler:
 
         # Definindo o módulo
         module = ast.Module(
-            body=imports + enum_classes + [ast_class],
+            body=imports + aux_classes + [ast_class],
             type_ignores=[],
         )
         module = ast.fix_missing_locations(module)

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/edl_model/entity_model_base.py

@@ -8,6 +8,7 @@ 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.trait_property_meta_model import (
+    ExtendsPropertyMetaModel,
     TraitPropertyMetaModel,
 )
 
@@ -55,9 +56,17 @@ class EntityModelBase(BaseModel):
         None,
         description="Dicionário de propriedades condicionais da trait (isso é, especifica propriedades, e seus valores fixos, que serão usados como um tipo de filtro fixo usado como condição para que a propridade principal assum o papel daquele tipo de trait).",
     )
+    extends_properties: Optional[Dict[str, ExtendsPropertyMetaModel]] = Field(
+        None,
+        description="Dicionário de propriedades condicionais associadas ao uso de extends (especifica propriedades e seus valores fixos, usados como filtros quando a entidade é uma especialização via extends).",
+    )
     properties: Dict[str, PropertyMetaModel] = Field(
         ..., description="Dicionário de propriedades do modelo."
     )
+    composed_properties: Optional[Dict[str, List[str]]] = Field(
+        None,
+        description="Dicionário que define grupos de propriedades compostas, permitindo agrupar propriedades existentes em DTOs agregados.",
+    )
     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).",

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/edl_model/trait_property_meta_model.py

@@ -14,3 +14,6 @@ class TraitPropertyMetaModel(BaseModel):
         None,
         description="Lista de valores permitidos.",
     )
+
+
+ExtendsPropertyMetaModel = TraitPropertyMetaModel

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2/compiler/property_compiler.py

@@ -80,17 +80,60 @@ class EDLPropertyCompiler:
         ast_dto_attributes = []
         ast_entity_attributes = []
         props_pk = []
-        enum_classes = []
+        aux_classes = []
         related_imports = []
         relations_dependencies = []
         fixed_filters = []
 
         if properties_structure.properties is None:
-            return (ast_dto_attributes, ast_entity_attributes, props_pk, enum_classes)
+            return (ast_dto_attributes, ast_entity_attributes, props_pk, aux_classes)
+
+        composed_properties = properties_structure.composed_properties or {}
+
+        aggregator_class_names: dict[str, str] = {}
+        aggregator_dto_attributes: dict[str, list[ast.stmt]] = {}
+        aggregated_property_to_group: dict[str, str] = {}
+
+        for composed_key, composed_list in composed_properties.items():
+            if not composed_list:
+                continue
+
+            composed_class_name = (
+                f"{CompilerStrUtil.to_pascal_case(escopo)}"
+                f"{CompilerStrUtil.to_pascal_case(prefx_class_name)}"
+                f"{CompilerStrUtil.to_pascal_case(entity_model.id)}"
+                f"{CompilerStrUtil.to_pascal_case(composed_key)}AggregatorDTO"
+            )
+
+            aggregator_class_names[composed_key] = composed_class_name
+            aggregator_dto_attributes[composed_key] = []
+
+            for composed_property in composed_list:
+                if composed_property in aggregated_property_to_group:
+                    raise Exception(
+                        f"Propriedade '{composed_property}' da entidade '{entity_model.id}' está associada a mais de um composed_property."
+                    )
+
+                if composed_property not in properties_structure.properties:
+                    raise Exception(
+                        f"Propriedade '{composed_property}' referenciada no composed_property '{composed_key}' não encontrada na entidade '{entity_model.id}'."
+                    )
+
+                aggregated_property_to_group[composed_property] = composed_key
 
         for pkey in properties_structure.properties:
             prop = properties_structure.properties[pkey]
 
+            composed_key = aggregated_property_to_group.get(pkey)
+            if composed_key:
+                if prop.pk:
+                    raise Exception(
+                        f"Propriedade '{pkey}' não pode ser utilizada em composed_properties por ser chave primária."
+                    )
+                target_dto_attributes = aggregator_dto_attributes[composed_key]
+            else:
+                target_dto_attributes = ast_dto_attributes
+
             # DTO
             if isinstance(prop.type, PrimitiveTypes):
                 # Tratando propriedade simples (não array, não object)
@@ -99,10 +142,10 @@ class EDLPropertyCompiler:
                     map_unique_by_property,
                     escopo,
                     entity_model,
-                    ast_dto_attributes,
+                    target_dto_attributes,
                     ast_entity_attributes,
                     props_pk,
-                    enum_classes,
+                    aux_classes,
                     pkey,
                     prop,
                     prefx_class_name,
@@ -124,7 +167,7 @@ class EDLPropertyCompiler:
                         entity_model,
                         entity_models,
                         properties_structure,
-                        ast_dto_attributes,
+                        target_dto_attributes,
                         ast_entity_attributes,
                         related_imports,
                         relations_dependencies,
@@ -139,7 +182,7 @@ class EDLPropertyCompiler:
                         related_entity_id,
                         entity_model,
                         properties_structure,
-                        ast_dto_attributes,
+                        target_dto_attributes,
                         ast_entity_attributes,
                         pkey,
                         prop,
@@ -153,7 +196,24 @@ class EDLPropertyCompiler:
         for pkey in properties_structure.trait_properties:
             prop = properties_structure.trait_properties[pkey]
 
-            self._compile_trait_property(
+            self._compile_trait_extends_property(
+                properties_structure,
+                map_unique_by_property,
+                pkey,
+                prop,
+                ast_dto_attributes,
+                ast_entity_attributes,
+                fixed_filters,
+                escopo,
+                entity_model,
+                aux_classes,
+                prefx_class_name,
+            )
+
+        for pkey in properties_structure.extends_properties:
+            prop = properties_structure.extends_properties[pkey]
+
+            self._compile_trait_extends_property(
                 properties_structure,
                 map_unique_by_property,
                 pkey,
@@ -163,21 +223,38 @@ class EDLPropertyCompiler:
                 fixed_filters,
                 escopo,
                 entity_model,
-                enum_classes,
+                aux_classes,
                 prefx_class_name,
             )
 
+        for composed_key, class_name in aggregator_class_names.items():
+            dto_attributes = aggregator_dto_attributes.get(composed_key, [])
+
+            aux_classes.append(
+                self._build_aggregator_class_ast(
+                    class_name=class_name,
+                    dto_attributes=dto_attributes,
+                )
+            )
+
+            ast_dto_attributes.append(
+                self._build_dto_aggregator_ast(
+                    name=composed_key,
+                    class_name=class_name,
+                )
+            )
+
         return (
             ast_dto_attributes,
             ast_entity_attributes,
             props_pk,
-            enum_classes,
+            aux_classes,
             related_imports,
             relations_dependencies,
             fixed_filters,
         )
 
-    def _compile_trait_property(
+    def _compile_trait_extends_property(
         self,
         properties_structure: PropertiesCompilerStructure,
         map_unique_by_property: dict[str, IndexCompilerStructure],
@@ -188,7 +265,7 @@ class EDLPropertyCompiler:
         fixed_filters: list[tuple[str, BasicTypes]],
         escopo: str,
         entity_model: EntityModelBase,
-        enum_classes: list[ast.stmt],
+        aux_classes: list[ast.stmt],
         prefx_class_name: str,
     ):
         enum_class_name = None
@@ -302,7 +379,7 @@ class EDLPropertyCompiler:
                 raise Exception(f"Erro desconhecido ao compilar a propriedade {pkey}")
 
             enum_class_name, ast_enum_class = result
-            enum_classes.append(ast_enum_class)
+            aux_classes.append(ast_enum_class)
 
         # Resolvendo o nome da propriedade no Entity
         if (
@@ -370,6 +447,49 @@ class EDLPropertyCompiler:
         # TODO Pensar em validações para esse value (se está de acordo com o tipo ou enum)
         fixed_filters.append((pkey, prop.value))
 
+    def _build_aggregator_class_ast(
+        self,
+        class_name: str,
+        dto_attributes: list[ast.stmt],
+    ):
+        body = dto_attributes if dto_attributes else [ast.Pass()]
+
+        return ast.ClassDef(
+            name=class_name,
+            bases=[ast.Name(id="DTOBase", ctx=ast.Load())],
+            keywords=[],
+            decorator_list=[
+                ast.Call(
+                    func=ast.Name(id="DTO", ctx=ast.Load()),
+                    args=[],
+                    keywords=[],
+                )
+            ],
+            body=body,
+        )
+
+    def _build_dto_aggregator_ast(
+        self,
+        name: str,
+        class_name: str,
+    ):
+        return ast.AnnAssign(
+            target=ast.Name(
+                id=CompilerStrUtil.to_snake_case(name),
+                ctx=ast.Store(),
+            ),
+            annotation=ast.Name(
+                id=class_name,
+                ctx=ast.Load(),
+            ),
+            value=ast.Call(
+                func=ast.Name(id="DTOAggregator", ctx=ast.Load()),
+                args=[ast.Name(id=class_name, ctx=ast.Load())],
+                keywords=[],
+            ),
+            simple=1,
+        )
+
     def _compile_external_relation(
         self,
         related_entity_id: str,
@@ -757,7 +877,7 @@ class EDLPropertyCompiler:
         ast_dto_attributes,
         ast_entity_attributes,
         props_pk,
-        enum_classes,
+        aux_classes,
         pkey,
         prop,
         prefx_class_name: str,
@@ -936,7 +1056,7 @@ class EDLPropertyCompiler:
                 raise Exception(f"Erro desconhecido ao compilar a propriedade {pkey}")
 
             enum_class_name, ast_enum_class = result
-            enum_classes.append(ast_enum_class)
+            aux_classes.append(ast_enum_class)
 
         # Resolvendo o nome da propriedade no Entity
         if (

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/nsj_rest_lib2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nsj_rest_lib2
-Version: 0.0.16
+Version: 0.0.18
 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
@@ -31,3 +31,6 @@ Biblioteca para permitir a distribuição de rotas dinâmicas numa API, configur
 * Rever modo de usar o InjectFactory (talvez dando ciência, ao RestLib, do padrão multibanco)
 * Implementar e documentar campos join
 * Implementar e documentar conjuntos
+* Dar erro ao haver conflito de nomes das propriedades (por qualquer tipo de herança)
+* Rotas para o inline
+* inline será para composição (arquivo externo é agregação)

{nsj_rest_lib2-0.0.16 → nsj_rest_lib2-0.0.18}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = nsj_rest_lib2
-version = 0.0.16
+version = 0.0.18
 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).