maleo-foundation 0.0.74__py3-none-any.whl → 0.0.76__py3-none-any.whl

maleo_foundation/utils/controller.py

@@ -1,9 +1,13 @@
 from fastapi import status
-from typing import Type, Any
+from functools import wraps
+from typing import Awaitable, Callable, Dict, List, Type, Any
+from maleo_foundation.types import BaseTypes
 from maleo_foundation.enums import BaseEnums
 from maleo_foundation.models.responses import BaseResponses
-from maleo_foundation.models.transfers.results.service.controllers.rest import BaseServiceRESTControllerResults
+from maleo_foundation.models.transfers.parameters.general import BaseGeneralParametersTransfers
 from maleo_foundation.models.transfers.parameters.service import BaseServiceParametersTransfers
+from maleo_foundation.models.transfers.results.service.controllers.rest import BaseServiceRESTControllerResults
+from maleo_foundation.expanded_types.general import BaseGeneralExpandedTypes
 from maleo_foundation.expanded_types.service import ExpandedServiceTypes
 
 class BaseControllerUtils:
@@ -47,4 +51,59 @@ class BaseControllerUtils:
             return BaseServiceRESTControllerResults(success=False, content=content, status_code=status.HTTP_400_BAD_REQUEST)
 
         #* No duplicates found
-        return BaseServiceRESTControllerResults(success=True, content=None)
+        return BaseServiceRESTControllerResults(success=True, content=None)
+
+    @staticmethod
+    def field_expansion_handler(
+        expandable_fields_dependencies_map:BaseTypes.OptionalStringToListOfStringDict = None,
+        field_expansion_processors:BaseGeneralExpandedTypes.OptionalListOfFieldExpansionProcessor = None
+    ):
+        """
+        Decorator to handle expandable fields validation and processing.
+        
+        Args:
+            validation_rules: Dictionary where keys are required fields and values are lists of dependent fields
+            field_expansion_processors: Dictionary of field names to processor functions that handle that field's data
+        """
+        def decorator(func:Callable[..., Awaitable[BaseServiceRESTControllerResults]]):
+            @wraps(func)
+            async def wrapper(parameters, *args, **kwargs):
+                expand:BaseTypes.OptionalListOfStrings = getattr(parameters, 'expand', None)
+
+                #* Validate expandable fields dependencies
+                if expand is not None and expandable_fields_dependencies_map is not None:
+                    for dependency, dependents in expandable_fields_dependencies_map.items():
+                        if dependency not in expand:
+                            for dependent in dependents:
+                                if dependent in expand:
+                                    other = f"'{dependency}' must also be expanded if '{dependent}' is expanded"
+                                    content = BaseResponses.InvalidExpand(other=other).model_dump()
+                                    return BaseServiceRESTControllerResults(success=False, content=content, status_code=status.HTTP_400_BAD_REQUEST)
+
+                #* Call the original function
+                result = await func(parameters, *args, **kwargs)
+
+                if not isinstance(result.content, Dict):
+                    return result
+
+                #* Process the fields if needed
+                if result.success and result.content.get("data", None) is not None and field_expansion_processors is not None:
+                    data = result.content["data"]
+                    if isinstance(data, List):
+                        for idx, dt in enumerate(data):
+                            for processor in field_expansion_processors:
+                                raw_parameters = {"data": dt, "expand": expand}
+                                parameters = BaseGeneralParametersTransfers.FieldExpansionProcessor.model_validate(raw_parameters)
+                                dt = processor(parameters)
+                                data[idx] = dt
+                    elif isinstance(data, Dict):
+                        raw_parameters = {"data": data, "expand": expand}
+                        parameters = BaseGeneralParametersTransfers.FieldExpansionProcessor.model_validate(raw_parameters)
+                        for processor in field_expansion_processors:
+                            data = processor(parameters)
+                    result.content["data"] = data
+                    result.process_response()
+
+                return result
+            return wrapper
+        return decorator

{maleo_foundation-0.0.74.dist-info → maleo_foundation-0.0.76.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: maleo_foundation
-Version: 0.0.74
+Version: 0.0.76
 Summary: Foundation package for Maleo
 Author-email: Agra Bima Yuda <agra@nexmedis.com>
 License: MIT

{maleo_foundation-0.0.74.dist-info → maleo_foundation-0.0.76.dist-info}/RECORD

@@ -48,13 +48,13 @@ maleo_foundation/models/transfers/results/service/query.py,sha256=G5A4FRkHyRRlpu
 maleo_foundation/models/transfers/results/service/controllers/__init__.py,sha256=HZJWMy2dskzOCzLmp_UaL9rjbQ-sDMI7sd2bXb-4QOU,175
 maleo_foundation/models/transfers/results/service/controllers/rest.py,sha256=wCuFyOTQkuBs2cqjPsWnPy0XIsCfMqGByhrSy57qp7Y,1107
 maleo_foundation/utils/__init__.py,sha256=FavmL5XYGCm955EAKiWWcXYeU15p5rSzfcglpV2yI6c,387
-maleo_foundation/utils/controller.py,sha256=hapDGng4q5XTfaG18M3bbFsFGqEOlkNKRzGf8BMKrhs,2996
+maleo_foundation/utils/controller.py,sha256=vC2B2IfuwM4CqsFgpmawT1uniAJ_S9-rP7vXXAMlmrY,6397
 maleo_foundation/utils/exceptions.py,sha256=nk3rD57fDR-D7BQkU1JEKV-Mu7FGMpLSEsqxdDZdKjU,4532
 maleo_foundation/utils/logger.py,sha256=978P57JOhGR-WIu7xdPXBIwd3JrfLLA8WerVzxhE_Fs,3408
 maleo_foundation/utils/query.py,sha256=ODQ3adOYQNj5E2cRW9ytbjBz56nEDcnfq8mQ6YZbCCM,4375
 maleo_foundation/utils/formatter/__init__.py,sha256=iKf5YCbEdg1qKnFHyKqqcQbqAqEeRUf8mhI3v3dQoj8,78
 maleo_foundation/utils/formatter/case.py,sha256=TmvvlfzGdC_omMTB5vAa40TZBxQ3hnr-SYeo0M52Rlg,1352
-maleo_foundation-0.0.74.dist-info/METADATA,sha256=-rTma8SV5Tz_cF6NY8alxEwNyFZ2aGyZHGoXqNWgOaQ,3160
-maleo_foundation-0.0.74.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
-maleo_foundation-0.0.74.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
-maleo_foundation-0.0.74.dist-info/RECORD,,
+maleo_foundation-0.0.76.dist-info/METADATA,sha256=R2JVBCmmGvCNmNzP9of4uM3tbCo4eCaN7slXucM1FMk,3160
+maleo_foundation-0.0.76.dist-info/WHEEL,sha256=SmOxYU7pzNKBqASvQJ7DjX3XGUF92lrGhMb3R6_iiqI,91
+maleo_foundation-0.0.76.dist-info/top_level.txt,sha256=_iBos3F_bhEOdjOnzeiEYSrCucasc810xXtLBXI8cQc,17
+maleo_foundation-0.0.76.dist-info/RECORD,,