aspyx 1.2.0__py3-none-any.whl → 1.3.0__py3-none-any.whl

aspyx/di/threading/__init__.py

@@ -0,0 +1,11 @@
+"""
+threading utilities
+"""
+from .synchronized import synchronized, SynchronizeAdvice
+
+imports = [synchronized, SynchronizeAdvice]
+
+__all__ = [
+    "synchronized",
+    "SynchronizeAdvice",
+]

aspyx/di/threading/synchronized.py

@@ -0,0 +1,46 @@
+"""
+Synchronized decorator and advice
+"""
+from __future__ import annotations
+
+import threading
+from weakref import WeakKeyDictionary
+
+from aspyx.reflection import Decorators
+from aspyx.di.aop import advice, around, methods, Invocation
+
+def synchronized():
+    """
+    decorate methods to synchronize them based on an instance related `RLock`
+    """
+    def decorator(func):
+        Decorators.add(func, synchronized)
+        return func #
+
+    return decorator
+
+@advice
+class SynchronizeAdvice():
+    __slots__ = ("locks")
+
+    # constructor
+
+    def __init__(self):
+        self.locks = WeakKeyDictionary()
+
+    # internal
+
+    def get_lock(self, instance) -> threading.RLock:
+        lock = self.locks.get(instance, None)
+        if lock is None:
+            lock = threading.RLock()
+            self.locks[instance] = lock
+
+        return lock
+
+    # around
+
+    @around(methods().decorated_with(synchronized))
+    def synchronize(self, invocation: Invocation):
+        with self.get_lock(invocation.args[0]):
+            return invocation.proceed()

aspyx/reflection/reflection.py

@@ -17,7 +17,7 @@ class DecoratorDescriptor:
         "args"
     ]
 
-    def __init__(self, decorator, *args):
+    def __init__(self, decorator: Callable, *args):
         self.decorator = decorator
         self.args = args
 
@@ -69,6 +69,9 @@ class TypeDescriptor:
 
         # public
 
+        def is_async(self) -> bool:
+            return inspect.iscoroutinefunction(self.method)
+
         def get_decorator(self, decorator: Callable) -> Optional[DecoratorDescriptor]:
             for dec in self.decorators:
                 if dec.decorator is decorator:

{aspyx-1.2.0.dist-info → aspyx-1.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aspyx
-Version: 1.2.0
+Version: 1.3.0
 Summary: A DI and AOP library for Python
 Author-email: Andreas Ernst <andreas.ernst7@gmail.com>
 License: MIT License
@@ -37,15 +37,18 @@ Dynamic: license-file
 ![Python Versions](https://img.shields.io/badge/python-3.9%20|%203.10%20|%203.11%20|%203.12-blue)
 ![License](https://img.shields.io/github/license/coolsamson7/aspyx)
 ![coverage](https://img.shields.io/badge/coverage-94%25-brightgreen)
+[![PyPI](https://img.shields.io/pypi/v/aspyx)](https://pypi.org/project/aspyx/)
 
 ## Table of Contents
 
-- [Introduction](#aspyx)
+- [Motivation](#motivation)
+- [Introduction](#introduction)
 - [Installation](#installation)
 - [Registration](#registration)
   - [Class](#class)
   - [Class Factory](#class-factory)
   - [Method](#method)
+  - [Conditional](#conditional)
 - [Environment](#environment)
   - [Definition](#definition)
   - [Retrieval](#retrieval)
@@ -59,22 +62,38 @@ Dynamic: license-file
 - [Reflection](#reflection)
 - [Version History](#version-history)
 
+# Motivation
+
+While working on some AI related topics in Python, i required a simple DI framework. 
+Looking at the existing solutions - there are quite a number of - i was not quite happy. Either the solutions 
+lacked functionality - starting with that usually aop and di are separate libraries -, that i am accustomed to from other languages, or the API was in my mind too clumsy and "technical".
+
+So, why not develop one on my own...Having done that in other languages previously, the task was not that hard, and last but not least...it is fun :-) 
+
 # Introduction
 
 Aspyx is a small python libary, that adds support for both dependency injection and aop.
 
-The following features are supported 
+The following di features are supported 
 - constructor and setter injection
+- possibility to define custom injections
 - post processors
-- factory classes and methods
+- support for factory classes and methods
 - support for eager construction
-- support for singleton and request scopes
+- support for scopes singleton, request and thread
 - possibilty to add custom scopes
-- lifecycle events methods
-- bundling of injectable object sets by environment classes including recursive imports and inheritance
-- container instances that relate to environment classes and manage the lifecylce of related objects
+- conditional registration of classes and factories 
+- lifecycle events methods `on_init`, `on_destroy`
+- bundling of injectable objects according to their module location including recursive imports and inheritance
+- instatiation of - possibly multiple - container instances - so called environments -  that manage the lifecylce of related objects
+- filtering of classes by associating "features" sets to environment ( similar to spring profiles )
 - hierarchical environments
 
+With respect to aop:
+- support for before, around, after and error aspects 
+- sync and async method support
+- `synchronized` decorator that adds locking to methods
+
 The library is thread-safe!
 
 Let's look at a simple example
@@ -155,11 +174,11 @@ Let's look at the details
 
 # Installation
 
-`pip install aspyx`
+Just install from PyPI with 
 
-The library is tested with all Python version > 3.9
+`pip install aspyx`
 
-Ready to go...
+The library is tested with all Python version >= 3.9
 
 # Registration
 
@@ -233,6 +252,22 @@ class Foo:
 
  The same arguments as in `@injectable` are possible.
 
+## Conditional
+
+All `@injectable` declarations can be supplemented with 
+
+```python
+@conditional(<condition>, ..., <condition>)
+```
+
+decorators that act as filters in the context of an environment.
+
+Valid conditions are created by:
+- `requires_class(clazz: Type)`  
+  the injectable is valid, if the specified class is registered as well.
+- `requires_feature(feature: str)`  
+  the injectable is valid, if the environment defines the specified feature.
+
 # Environment
 
 ## Definition
@@ -251,6 +286,26 @@ environment = Environment(SampleEnvironment)
 
 The default is that all eligible classes, that are implemented in the containing module or in any submodule will be managed.
 
+By adding the parameter `features: list[str]`, it is possible to filter injectables by evaluating the corresponding `@conditional` decorators.
+
+**Example**: 
+```python
+
+@injectable()
+@conditional(requires_feature("dev"))
+class DevOnly:
+     def __init__(self):
+        pass
+
+@environment()
+class SampleEnvironmen()):
+    def __init__(self):
+        pass
+
+environment = Environment(SampleEnvironment, features=["dev"])
+```
+
+
 By adding an `imports: list[Type]` parameter, specifying other environment types, it will register the appropriate classes recursively.
 
 **Example**: 
@@ -428,18 +483,35 @@ Different aspects - with the appropriate decorator - are possible:
 - `before`  
    methods that will be executed _prior_ to the original method
 - `around`  
-   methods that will be executed _around_ to the original method giving it the possibility add side effects or even change the parameters.
+   methods that will be executed _around_ to the original method giving it the possibility to add side effects or even change the parameters.
 - `after`  
-    methods that will be executed _after_ to the original method
+   methods that will be executed _after_ to the original method
 - `error`  
-   methods that will be executed in case of a caught exception, which can be retrieved by `invocation.exception`
+   methods that will be executed in case of a caught exception
+
+All methods are expected to have single `Invocation` parameter, that stores
 
-All methods are expected to hava single `Invocation` parameter, that stores, the function, args and kwargs, the return value and possible exceptions.
+- `func` the target function
+- `args` the suppliued args
+- `kwargs` the keywords args
+- `result` the result ( initially `None`)
+- `exception` a possible caught excpetion ( initially `None`)
 
 It is essential for `around` methods to call `proceed()` on the invocation, which will call the next around method in the chain and finally the original method.
 If the `proceed` is called with parameters, they will replace the original parameters! 
 
-The argument list to the corresponding decorators control, how aspects are associated with which methods.
+**Example**: Parameter modifications
+
+```python
+@around(methods().named("say"))
+def call_around(self, invocation: Invocation):
+    args = [invocation.args[0],invocation.args[1] + "!"] # 0 is self!
+
+    return invocation.proceed(*args)
+```
+
+The argument list to the corresponding decorators control which methods are targeted by the advice.
+
 A fluent interface is used describe the mapping. 
 The parameters restrict either methods or classes and are constructed by a call to either `methods()` or `classes()`.
 
@@ -448,6 +520,8 @@ Both add the fluent methods:
    defines the matching classes
 - `named(name: str)`  
    defines method or class names
+- `that_are_async()`  
+   defines async methods
 - `matches(re: str)`  
    defines regular expressions for methods or classes
 - `decorated_with(type: Type)`  
@@ -468,6 +542,10 @@ class TransactionAdvice:
         ...
 ```
 
+With respect to async methods, you need to make sure, to replace a `proceeed()` with a `await proceed_async()` to have the overall chain async!
+
+A handy decorator `@synchronized` is implemented that automatically synchronizes methods with a `RLock` associated with the instance.
+
 # Configuration 
 
 It is possible to inject configuration values, by decorating methods with `@inject-value(<name>)` given a configuration key.
@@ -618,6 +696,8 @@ def transactional(scope):
 
 - added `YamlConfigurationSource`
 
+**1.2.1**
+
 
       
 

aspyx-1.3.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+aspyx/di/__init__.py,sha256=OfETLGaquTbFHhhDRzzGtnSu-KkMj68aDdEaVU19KoI,1107
+aspyx/di/di.py,sha256=OmvcEd2Arsyo0n9Vh40LM_-jLFdOg-bKwahcEINJ7GA,38363
+aspyx/di/aop/__init__.py,sha256=nOABex49zSyMZ2w1ezwX3Q3yrOcQRSDjDtSj0DwKVbQ,233
+aspyx/di/aop/aop.py,sha256=GPkNE6CgQZUPeMlDdmE5TiksNLSgPb2A8D2IXRZmJ_M,16887
+aspyx/di/configuration/__init__.py,sha256=mweJ3tZX1YJfY1d4ra-i0TWEcF3EwXBpGbHrKg1Kc6E,380
+aspyx/di/configuration/configuration.py,sha256=KfPjrlUhhmEOUxdJiXePt5RGxKc8JczkWqlEBjpWQTg,4362
+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=awFm8T5_lPw0An-H4-jdTUumPmX348WiYw1x8xyz4qs,1053
+aspyx/di/util/__init__.py,sha256=8H2yKkXu3nkRGeTerb8ialzKGfvzUx44XUWFUYcYuQM,125
+aspyx/di/util/stringbuilder.py,sha256=JywkLxZfaQUUWjSB5wvqA6a6Cfs3sW1jbaZ1z4U0-CQ,540
+aspyx/reflection/__init__.py,sha256=r2sNJrfHDpuqaIYu4fTYsoo046gpgn4VTd7bsS3mQJY,282
+aspyx/reflection/proxy.py,sha256=zJ6Psd6zWfFABdrKOf4cULt3gibyqCRdcR6z8WKIkzE,1982
+aspyx/reflection/reflection.py,sha256=0kQXQcyOCj29vy5Ls4dbAlvOKsY7FRyHndiygZzg7HY,5826
+aspyx-1.3.0.dist-info/licenses/LICENSE,sha256=n4jfx_MNj7cBtPhhI7MCoB_K35cj1icP9yJ4Rh4vlvY,1070
+aspyx-1.3.0.dist-info/METADATA,sha256=lxqBe-dsW1oe6HgBOfoRIUk_q-qFObZSNpO4e8Xi40U,21691
+aspyx-1.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+aspyx-1.3.0.dist-info/top_level.txt,sha256=A_ZwhBY_ybIgjZlztd44eaOrWqkJAndiqjGlbJ3tR_I,6
+aspyx-1.3.0.dist-info/RECORD,,

aspyx-1.2.0.dist-info/RECORD

@@ -1,18 +0,0 @@
-aspyx/di/__init__.py,sha256=xdb2lsKh00uGMFCWYavhUEMGH15OSeAhUC-iSosqHqU,935
-aspyx/di/di.py,sha256=evfhTznmPNRDjamthSPisMpDhGZJdNmEREUhdJ9nsTE,35571
-aspyx/di/aop/__init__.py,sha256=nOABex49zSyMZ2w1ezwX3Q3yrOcQRSDjDtSj0DwKVbQ,233
-aspyx/di/aop/aop.py,sha256=3GKN6sGlsZbJ7_WSxQvHZNFYouAfU4Eq6H5cBBB_e_4,14455
-aspyx/di/configuration/__init__.py,sha256=mweJ3tZX1YJfY1d4ra-i0TWEcF3EwXBpGbHrKg1Kc6E,380
-aspyx/di/configuration/configuration.py,sha256=KfPjrlUhhmEOUxdJiXePt5RGxKc8JczkWqlEBjpWQTg,4362
-aspyx/di/configuration/env_configuration_source.py,sha256=Xh8g3AuQdgk89nG6GKA4iKILXaqHecD0KqMW2w91hXs,1445
-aspyx/di/configuration/yaml_configuration_source.py,sha256=LM-5J6IRxBBbBAjDeGIFsmiT-61WuGv1sU_zXWNzhkI,549
-aspyx/di/util/__init__.py,sha256=8H2yKkXu3nkRGeTerb8ialzKGfvzUx44XUWFUYcYuQM,125
-aspyx/di/util/stringbuilder.py,sha256=JywkLxZfaQUUWjSB5wvqA6a6Cfs3sW1jbaZ1z4U0-CQ,540
-aspyx/reflection/__init__.py,sha256=r2sNJrfHDpuqaIYu4fTYsoo046gpgn4VTd7bsS3mQJY,282
-aspyx/reflection/proxy.py,sha256=zJ6Psd6zWfFABdrKOf4cULt3gibyqCRdcR6z8WKIkzE,1982
-aspyx/reflection/reflection.py,sha256=2oYJKYysH3ULmTzbXdjGBCB1iaLbWh3IPKSnorVLshU,5719
-aspyx-1.2.0.dist-info/licenses/LICENSE,sha256=n4jfx_MNj7cBtPhhI7MCoB_K35cj1icP9yJ4Rh4vlvY,1070
-aspyx-1.2.0.dist-info/METADATA,sha256=wXSu9Clxg4ZZCoiRAhiZzAR1Wcqtjv4NZie4XilJNSs,19009
-aspyx-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-aspyx-1.2.0.dist-info/top_level.txt,sha256=A_ZwhBY_ybIgjZlztd44eaOrWqkJAndiqjGlbJ3tR_I,6
-aspyx-1.2.0.dist-info/RECORD,,