aspyx 1.5.3__py3-none-any.whl → 1.6.0__py3-none-any.whl

aspyx/di/aop/aop.py

@@ -490,7 +490,7 @@ class Invocation:
             self.args = args
             self.kwargs = kwargs
 
-        # next one please...
+        # next one, please...
 
         return await self.current_aspect.next.call_async(self)
 

aspyx/exception/__init__.py

@@ -1,10 +1,11 @@
 """
 This module provides exception handling functions.
 """
-from .exception_manager import exception_handler, handle, ExceptionManager
+from .exception_manager import exception_handler, handle, catch, ExceptionManager
 
 __all__ = [
     "exception_handler",
     "handle",
+    "catch",
     "ExceptionManager"
 ]

aspyx/exception/exception_manager.py

@@ -32,6 +32,16 @@ def handle():
 
     return decorator
 
+def catch():
+    """
+    Any method annotated with @catch will be registered as an exception handler method.
+    """
+    def decorator(func):
+        Decorators.add(func, handle)
+        return func
+
+    return decorator
+
 class Handler:
     # constructor
 
@@ -174,7 +184,7 @@ class ExceptionManager:
             exception (BaseException): the exception
 
         Returns:
-            BaseException: the resulting exception
+            BaseException: the resulting - possible transformed - exception
         """
         chain = self.get_handlers(type(exception))
         if chain is not None:

aspyx/threading/context_local.py

@@ -1,3 +1,6 @@
+"""
+context utility
+"""
 import contextvars
 from contextlib import contextmanager
 from typing import Generic, Optional, TypeVar, Any
@@ -30,12 +33,18 @@ class ContextLocal(Generic[T]):
 
         Args:
             value: the value
+
+        Returns:
+            a token that can be used as an argument to `reset`
         """
         return self.var.set(value)
 
     def reset(self, token) -> None:
         """
         clear the value in the current thread
+
+        Args:
+            token: the token to clear
         """
         self.var.reset(token)
 
@@ -45,4 +54,4 @@ class ContextLocal(Generic[T]):
         try:
             yield
         finally:
-            self.reset(token)
+            self.reset(token)

aspyx/util/__init__.py

@@ -3,8 +3,14 @@ This module provides utility functions.
 """
 from .stringbuilder import StringBuilder
 from .logger import Logger
+from .serialization import TypeSerializer, TypeDeserializer, get_serializer, get_deserializer
 
 __all__ = [
     "StringBuilder",
-    "Logger"
+    "Logger",
+
+    "TypeSerializer",
+    "TypeDeserializer",
+    "get_serializer",
+    "get_deserializer"
 ]

aspyx/util/logger.py

@@ -1,4 +1,8 @@
+"""
+Logging utility class
+"""
 import logging
+import sys
 from typing import Optional, Dict
 
 class Logger:
@@ -8,8 +12,8 @@ class Logger:
     def configure(cls,
                  default_level: int = logging.INFO,
                  format: str = "[%(asctime)s] %(levelname)s in %(filename)s:%(lineno)d - %(message)s",
-                 levels: Optional[Dict[str, int]] = None):
+                 levels: Optional[Dict[str, int]] = None, stream=sys.stdout):
         logging.basicConfig(level=default_level, format=format)
         if levels is not None:
             for name, level in levels.items():
-                logging.getLogger(name).setLevel(level)
+                logging.getLogger(name).setLevel(level)

aspyx/util/serialization.py

@@ -0,0 +1,137 @@
+"""
+deserialization functions
+"""
+from dataclasses import is_dataclass, fields
+from functools import lru_cache
+from typing import get_origin, get_args, Union
+
+from pydantic import BaseModel
+
+class TypeDeserializer:
+    # constructor
+
+    def __init__(self, typ):
+        self.typ = typ
+        self.deserializer = self._build_deserializer(typ)
+
+    def __call__(self, value):
+        return self.deserializer(value)
+
+    # internal
+
+    def _build_deserializer(self, typ):
+        origin = get_origin(typ)
+        args = get_args(typ)
+
+        if origin is Union:
+            deserializers = [TypeDeserializer(arg) for arg in args if arg is not type(None)]
+            def deser_union(value):
+                if value is None:
+                    return None
+                for d in deserializers:
+                    try:
+                        return d(value)
+                    except Exception:
+                        continue
+                return value
+            return deser_union
+
+        if isinstance(typ, type) and issubclass(typ, BaseModel):
+            return typ.model_validate
+
+        if is_dataclass(typ):
+            field_deserializers = {f.name: TypeDeserializer(f.type) for f in fields(typ)}
+            def deser_dataclass(value):
+                if is_dataclass(value):
+                    return value
+
+                return typ(**{
+                    k: field_deserializers[k](v) for k, v in value.items()
+                })
+            return deser_dataclass
+
+        if origin is list:
+            item_deser = TypeDeserializer(args[0]) if args else lambda x: x
+            return lambda v: [item_deser(item) for item in v]
+
+        if origin is dict:
+            key_deser = TypeDeserializer(args[0]) if args else lambda x: x
+            val_deser = TypeDeserializer(args[1]) if len(args) > 1 else lambda x: x
+            return lambda v: {key_deser(k): val_deser(val) for k, val in v.items()}
+
+        # Fallback
+        return lambda v: v
+
+class TypeSerializer:
+    def __init__(self, typ):
+        self.typ = typ
+        self.serializer = self._build_serializer(typ)
+
+    def __call__(self, value):
+        return self.serializer(value)
+
+    def _build_serializer(self, typ):
+        origin = get_origin(typ)
+        args = get_args(typ)
+
+        if origin is Union:
+            serializers = [TypeSerializer(arg) for arg in args if arg is not type(None)]
+            def ser_union(value):
+                if value is None:
+                    return None
+                for s in serializers:
+                    try:
+                        return s(value)
+                    except Exception:
+                        continue
+                return value
+            return ser_union
+
+        if isinstance(typ, type) and issubclass(typ, BaseModel):
+            return lambda v: v.model_dump() if v is not None else None
+
+        if is_dataclass(typ):
+            field_serializers = {f.name: TypeSerializer(f.type) for f in fields(typ)}
+            def ser_dataclass(obj):
+                if obj is None:
+                    return None
+                return {k: field_serializers[k](getattr(obj, k)) for k in field_serializers}
+            return ser_dataclass
+
+        if origin is list:
+            item_ser = TypeSerializer(args[0]) if args else lambda x: x
+            return lambda v: [item_ser(item) for item in v] if v is not None else None
+
+        if origin is dict:
+            key_ser = TypeSerializer(args[0]) if args else lambda x: x
+            val_ser = TypeSerializer(args[1]) if len(args) > 1 else lambda x: x
+            return lambda v: {key_ser(k): val_ser(val) for k, val in v.items()} if v is not None else None
+
+        # Fallback: primitive Typen oder unbekannt
+        return lambda v: v
+
+@lru_cache(maxsize=512)
+def get_deserializer(typ) -> TypeDeserializer:
+    """
+    return a function that is able to deserialize a value of the specified type
+
+    Args:
+        typ: the type
+
+    Returns:
+
+    """
+    return TypeDeserializer(typ)
+
+@lru_cache(maxsize=512)
+def get_serializer(typ) -> TypeSerializer:
+    """
+    return a function that is able to deserialize a value of the specified type
+
+    Args:
+        typ: the type
+
+    Returns:
+
+    """
+    return TypeSerializer(typ)

{aspyx-1.5.3.dist-info → aspyx-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aspyx
-Version: 1.5.3
+Version: 1.6.0
 Summary: A DI and AOP library for Python
 Author-email: Andreas Ernst <andreas.ernst7@gmail.com>
 License: MIT License
@@ -26,6 +26,8 @@ License: MIT License
         SOFTWARE.
 License-File: LICENSE
 Requires-Python: >=3.9
+Requires-Dist: cachetools~=5.5.2
+Requires-Dist: pydantic<3.0,>=2.0
 Requires-Dist: python-dotenv~=1.1.0
 Requires-Dist: pyyaml~=6.0.2
 Description-Content-Type: text/markdown
@@ -146,7 +148,7 @@ environment = Environment(SampleModule)
 
 # fetch an instance
 
-bar = env.get(Bar)
+bar = env.read(Bar)
 
 bar.foo.hello("world")
 ```
@@ -734,11 +736,13 @@ given a specific exception.
 The handlers are declared by annoting a class with `@exception_handler` and decorating specific methods with `@handle`
 
 **Example**:
+
 ```python
 class DerivedException(Exception):
     def __init__(self):
         pass
 
+
 @module()
 class SampleModule:
     # constructor
@@ -750,6 +754,7 @@ class SampleModule:
     def create_exception_manager(self) -> ExceptionManager:
         return ExceptionManager()
 
+
 @injectable()
 @exception_handler()
 class TestExceptionHandler:
@@ -778,9 +783,10 @@ class ExceptionAdvice:
     def handle_error(self, invocation: Invocation):
         self.exceptionManager.handle(invocation.exception)
 
-environment =  Environment(SampleEnvironment)
 
-environment.get(ExceptionManager).handle(DerivedException())
+environment = Environment(SampleEnvironment)
+
+environment.read(ExceptionManager).handle(DerivedException())
 ```
 
 The exception maanger will first call the most appropriate method. 

{aspyx-1.5.3.dist-info → aspyx-1.6.0.dist-info}/RECORD

@@ -2,25 +2,26 @@ aspyx/__init__.py,sha256=MsSFjiLMLJZ7QhUPpVBWKiyDnCzryquRyr329NoCACI,2
 aspyx/di/__init__.py,sha256=AGVU2VBWQyBxSssvbk_GOKrYWIYtcmSoIlupz-Oqxi4,1138
 aspyx/di/di.py,sha256=V_BAV6DmFCoepPqAXhBz2GW6NwYaKokHb03HMz6A5Sw,44639
 aspyx/di/aop/__init__.py,sha256=rn6LSpzFtUOlgaBATyhLRWBzFmZ6XoVKA9B8SgQzYEI,746
-aspyx/di/aop/aop.py,sha256=RaZRmQ1Ie6jZqYm0X93hWQ89xHn8vpDSnsmRgfAV68k,19180
+aspyx/di/aop/aop.py,sha256=y300DG713Gcn97CdTKuBdFL2jaS5ouW6J0azZk0Byws,19181
 aspyx/di/configuration/__init__.py,sha256=flM9A79J2wfA5I8goQbxs4tTqYustR9tn_9s0YO2WJQ,484
 aspyx/di/configuration/configuration.py,sha256=cXW40bPXiUZ9hUtBoZkSATT3nLrDPWsSqxtgASIBQaM,4375
 aspyx/di/configuration/env_configuration_source.py,sha256=FXPvREzq2ZER6_GG5xdpx154TQQDxZVf7LW7cvaylAk,1446
 aspyx/di/configuration/yaml_configuration_source.py,sha256=NDl3SeoLMNVlzHgfP-Ysvhco1tRew_zFnBL5gGy2WRk,550
 aspyx/di/threading/__init__.py,sha256=qrWdaq7MewQ2UmZy4J0Dn6BhY-ahfiG3xsv-EHqoqSE,191
 aspyx/di/threading/synchronized.py,sha256=6JOg5BXWrRIS5nRPH9iWR7T-kUglO4qWBQpLwhy99pI,1325
-aspyx/exception/__init__.py,sha256=OZwv-C3ZHD0Eg1rohCQMj575WLJ7lfYuk6PZD6sh1MA,211
-aspyx/exception/exception_manager.py,sha256=CVOjdI-y4m5GiE3TvSbwLpXXoAYqEyQLMN7jQhJYRn8,5228
+aspyx/exception/__init__.py,sha256=HfK0kk1Tcw9QaUYgIyMeBFDAIE83pkTrIGYUnoKJXPE,231
+aspyx/exception/exception_manager.py,sha256=wTxLjSVZ_vYfeo06PKZZS9hbrv_dRCwQotSwowUHLZY,5475
 aspyx/reflection/__init__.py,sha256=r2sNJrfHDpuqaIYu4fTYsoo046gpgn4VTd7bsS3mQJY,282
 aspyx/reflection/proxy.py,sha256=1-pgw-TNORFXbV0gowFZqGd-bcWv1ny69bJhq8TLsKs,2761
 aspyx/reflection/reflection.py,sha256=BcqXJcMO36Gzq71O4aBsMqPynmBhYLI8V6J7DOInPAM,9142
 aspyx/threading/__init__.py,sha256=YWqLk-MOtSg4i3cdzRZUBR25okbbftRRxkaEdfrdMZo,207
-aspyx/threading/context_local.py,sha256=IBjqfmuGgQSMB3EhYW9etcKEnErMQKaAVHD45s1mqOA,1111
+aspyx/threading/context_local.py,sha256=2I-942IHbR0jCrM1N6Mo56VJwuNWMs2f3R8NJsHygBI,1270
 aspyx/threading/thread_local.py,sha256=86dNtbA4k2B-rNUUnZgn3_pU0DAojgLrRnh8RL6zf1E,1196
-aspyx/util/__init__.py,sha256=Uu6uZySb5v9WHS8ZooHmRXAxK_BhhKPUotv-LZyGQAI,165
-aspyx/util/logger.py,sha256=S358l7RpBTSZtN8nivVLgX6HAp32vOQV-SDHDH0n9gc,547
+aspyx/util/__init__.py,sha256=B7QK3alguZqExBFGzx-OpHpYeoIc3ZGAL7pJnq8NNvI,352
+aspyx/util/logger.py,sha256=Hti5JyajdPXlf_1jvVT3e6Gf9eLyAsIVJRdNBMahbJs,608
+aspyx/util/serialization.py,sha256=BRsg-2S7E3IukJqxZGm7FvjTvV5d6rcyrpJT3aKoVmM,4252
 aspyx/util/stringbuilder.py,sha256=a-0T4YEXSJFUuQ3ztKN1ZPARkh8dIGMSkNEEJHRN7dc,856
-aspyx-1.5.3.dist-info/METADATA,sha256=hPk9M5CUZDxxvrzf0s1hTnpfw-XTJu1gPqgTzAVf6w0,26490
-aspyx-1.5.3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-aspyx-1.5.3.dist-info/licenses/LICENSE,sha256=n4jfx_MNj7cBtPhhI7MCoB_K35cj1icP9yJ4Rh4vlvY,1070
-aspyx-1.5.3.dist-info/RECORD,,
+aspyx-1.6.0.dist-info/METADATA,sha256=fYorC9QmB3Yo6sQwu4TfMpJOI9eQk02P3Tmz6UCBrgo,26562
+aspyx-1.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aspyx-1.6.0.dist-info/licenses/LICENSE,sha256=n4jfx_MNj7cBtPhhI7MCoB_K35cj1icP9yJ4Rh4vlvY,1070
+aspyx-1.6.0.dist-info/RECORD,,