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

aspyx/di/configuration/configuration.py

@@ -106,9 +106,6 @@ class ConfigurationSource(ABC):
 
     __slots__ = []
 
-    def __init__(self):
-        pass
-
     @inject()
     def set_manager(self, manager: ConfigurationManager):
         manager._register(self)

aspyx/di/configuration/env_configuration_source.py

@@ -14,11 +14,6 @@ class EnvConfigurationSource(ConfigurationSource):
 
     __slots__ = []
 
-    # constructor
-
-    def __init__(self):
-        super().__init__()
-
     # implement
 
     def load(self) -> dict:

aspyx/di/configuration/yaml_configuration_source.py

@@ -15,8 +15,6 @@ class YamlConfigurationSource(ConfigurationSource):
     # constructor
 
     def __init__(self, file: str):
-        super().__init__()
-
         self.file = file
 
     # implement

aspyx/di/di.py

@@ -8,6 +8,7 @@ import logging
 import importlib
 import pkgutil
 import sys
+import time
 
 from abc import abstractmethod, ABC
 from enum import Enum
@@ -405,12 +406,10 @@ class ClassInstanceProvider(InstanceProvider):
         # check constructor
 
         init = TypeDescriptor.for_type(self.type).get_method("__init__")
-        if init is None:
-            raise DIRegistrationException(f"{self.type.__name__} does not implement __init__")
-
-        self.params = len(init.param_types)
-        for param in init.param_types:
-            types.append(param)
+        if init is not None:
+            self.params = len(init.param_types)
+            for param in init.param_types:
+                types.append(param)
 
         # check @inject
 
@@ -976,7 +975,7 @@ class Environment:
         """
 
         def add_provider(type: Type, provider: AbstractInstanceProvider):
-            Environment.logger.debug("\tadd provider %s for %s", provider, type)
+            Environment.logger.info("\tadd provider %s for %s", provider, type)
 
             self.providers[type] = provider
 
@@ -989,6 +988,8 @@ class Environment:
         if self.parent is None and env is not Boot:
             self.parent = Boot.get_environment() # inherit environment including its manged instances!
 
+        start = time.perf_counter()
+
         self.features = features
         self.providers: Dict[Type, AbstractInstanceProvider] = {}
         self.instances = []
@@ -1138,6 +1139,13 @@ class Environment:
         for instance in self.instances:
             self.execute_processors(Lifecycle.ON_RUNNING, instance)
 
+        # done
+
+        end = time.perf_counter()
+
+        Environment.logger.info("created environment for class %s in %s ms, created %s instances", env.__qualname__, 1000 * (end - start),  len(self.instances))
+
+
     def is_registered_type(self, type: Type) -> bool:
         provider = self.providers.get(type, None)
         return provider is not None and not isinstance(provider, AmbiguousProvider)

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aspyx
-Version: 1.6.0
+Version: 1.6.1
 Summary: A DI and AOP library for Python
 Author-email: Andreas Ernst <andreas.ernst7@gmail.com>
 License: MIT License
@@ -117,9 +117,6 @@ from aspyx.di import injectable, on_init, on_destroy, module, Environment
 
 @injectable()
 class Foo:
-    def __init__(self):
-        pass
-
     def hello(self, msg: str):
         print(f"hello {msg}")
 
@@ -138,9 +135,7 @@ class Bar:
 
 @module()
 class SampleModule:
-    def __init__(self):
-        pass
-
+    pass
 
 # create environment
 
@@ -148,7 +143,7 @@ environment = Environment(SampleModule)
 
 # fetch an instance
 
-bar = env.read(Bar)
+bar = environment.get(Bar)
 
 bar.foo.hello("world")
 ```
@@ -206,10 +201,7 @@ class Foo:
     def __init__(self):
         pass
 ```
-⚠️ **Attention:** Please make sure, that the class defines a local constructor, as this is _required_ to determine injected instances. 
-All referenced types will be injected by the environment. 
-
-Only eligible types are allowed, of course!
+If the class defines a constructor, all parameters - which are expected to be registered as well - will be injected automatically.
 
 The decorator accepts the keyword arguments
 - `eager : boolean`  
@@ -235,9 +227,6 @@ Classes that implement the `Factory` base class and are annotated with `@factory
 ```python
 @factory()
 class TestFactory(Factory[Foo]):
-    def __init__(self):
-        pass
-
     def create(self) -> Foo:
         return Foo()
 ```
@@ -252,9 +241,6 @@ Any `injectable` can define methods decorated with `@create()`, that will create
 ```python
 @injectable()
 class Foo:
-    def __init__(self):
-        pass
-
     @create(scope="request")
     def create(self) -> Baz:
         return Baz()
@@ -290,8 +276,7 @@ constructor type argument called `module`.
 ```python
 @module()
 class SampleModule:
-    def __init__(self):
-        pass
+    pass
 ```
 
 A module is a regular injectable class decorated with `@module` that controls the discovery of injectable classes, by filtering classes according to their module location relative to this class. 
@@ -311,13 +296,11 @@ By adding the parameter `features: list[str]`, it is possible to filter injectab
 @injectable()
 @conditional(requires_feature("dev"))
 class DevOnly:
-     def __init__(self):
-        pass
+     pass
 
 @module()
 class SampleModule():
-    def __init__(self):
-        pass
+    pass
 
 environment = Environment(SampleModule, features=["dev"])
 ```
@@ -329,8 +312,7 @@ By adding an `imports: list[Type]` parameter, specifying other module types, it
 ```python
 @module()
 class SampleModule(imports=[OtherModule]):
-    def __init__(self):
-        pass
+    pass
 ```
 
 Another possibility is to add a parent environment as an `Environment` constructor parameter
@@ -392,11 +374,8 @@ Different decorators are implemented, that call methods with computed values
 ```python
 @injectable()
 class Foo:
-    def __init__(self):
-        pass
-
     @inject_environment()
-    def initEnvironment(self, env: Environment):
+    def set_environment(self, env: Environment):
         ...
 
     @inject()
@@ -586,9 +565,6 @@ A handy decorator `@synchronized` in combination with the respective advice is i
 ```python
 @injectable()
 class Foo:
-    def __init__(self):
-        pass
-
     @synchronized()
     def execute_synchronized(self):
         ...
@@ -601,9 +577,6 @@ It is possible to inject configuration values, by decorating methods with `@inje
 ```python
 @injectable()
 class Foo:
-    def __init__(self):
-        pass
-
     @inject_value("HOME")
     def inject_home(self, os: str):
         ...
@@ -615,13 +588,13 @@ Configuration values are managed centrally using a `ConfigurationManager`, which
 
 ```python
 class ConfigurationSource(ABC):
-    def __init__(self):
-        pass
-
-   ...
+    @inject()
+    def set_manager(self, manager: ConfigurationManager):
+        manager._register(self)
 
     @abstractmethod
     def load(self) -> dict:
+       pass
 ```
 
 The `load` method is able to return a tree-like structure by returning a `dict`.
@@ -670,11 +643,6 @@ Typically you create the required configuration sources in an environment class,
 ```python
 @module()
 class SampleModule:
-    # constructor
-
-    def __init__(self):
-        pass
-
     @create()
     def create_env_source(self) -> EnvConfigurationSource:
         return EnvConfigurationSource()
@@ -733,7 +701,7 @@ def transactional(scope):
 The class `ExceptionManager` is used to collect dynamic handlers for specific exceptions and is able to dispatch to the concrete functions
 given a specific exception.
 
-The handlers are declared by annoting a class with `@exception_handler` and decorating specific methods with `@handle`
+The handlers are declared by annoting a class with `@exception_handler` and decorating specific methods with `@catch`
 
 **Example**:
 
@@ -745,11 +713,6 @@ class DerivedException(Exception):
 
 @module()
 class SampleModule:
-    # constructor
-
-    def __init__(self):
-        pass
-
     @create()
     def create_exception_manager(self) -> ExceptionManager:
         return ExceptionManager()
@@ -758,19 +721,16 @@ class SampleModule:
 @injectable()
 @exception_handler()
 class TestExceptionHandler:
-    def __init__(self):
-        pass
-
-    @handle()
-    def handle_derived_exception(self, exception: DerivedException):
+    @catch()
+    def catch_derived_exception(self, exception: DerivedException):
         ExceptionManager.proceed()
 
-    @handle()
-    def handle_exception(self, exception: Exception):
+    @catch()
+    def catch_exception(self, exception: Exception):
         pass
 
-    @handle()
-    def handle_base_exception(self, exception: BaseException):
+    @catch()
+    def catch_base_exception(self, exception: BaseException):
         pass
 
 
@@ -798,9 +758,6 @@ Together with a simple around advice we can now add exception handling to any me
 ```python
 @injectable()
 class Service:
-    def __init__(self):
-        pass
-
     def throw(self):
         raise DerivedException()
 
@@ -843,3 +800,7 @@ class ExceptionAdvice:
 **1.4.1**
 
 - mkdocs
+
+**1.6.1**
+
+- default constructors not requires anymore

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

@@ -1,12 +1,12 @@
 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/di.py,sha256=HgmLl84s3FLKUs6UO5ULzLcwuyDIzo0Ev8WrPQm3INg,44821
 aspyx/di/aop/__init__.py,sha256=rn6LSpzFtUOlgaBATyhLRWBzFmZ6XoVKA9B8SgQzYEI,746
 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/configuration/configuration.py,sha256=GVk_oGi7H0COBD_q__ZydIXyl7PgxvwW2Lplr-t44ck,4337
+aspyx/di/configuration/env_configuration_source.py,sha256=mVZXRTBn-zbkqGMV9Yn5EZsae4MlpAzc8nVozXaVwnE,1375
+aspyx/di/configuration/yaml_configuration_source.py,sha256=FmtM3-Xi1waxurdI5NVWUNTCcrv6q_azk5XniOL0Pg0,522
 aspyx/di/threading/__init__.py,sha256=qrWdaq7MewQ2UmZy4J0Dn6BhY-ahfiG3xsv-EHqoqSE,191
 aspyx/di/threading/synchronized.py,sha256=6JOg5BXWrRIS5nRPH9iWR7T-kUglO4qWBQpLwhy99pI,1325
 aspyx/exception/__init__.py,sha256=HfK0kk1Tcw9QaUYgIyMeBFDAIE83pkTrIGYUnoKJXPE,231
@@ -21,7 +21,7 @@ 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.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,,
+aspyx-1.6.1.dist-info/METADATA,sha256=H7d-mtHxb57xtVyxbvcz2385TvqslMxGHXzCtbDxdk8,26017
+aspyx-1.6.1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+aspyx-1.6.1.dist-info/licenses/LICENSE,sha256=n4jfx_MNj7cBtPhhI7MCoB_K35cj1icP9yJ4Rh4vlvY,1070
+aspyx-1.6.1.dist-info/RECORD,,