orionis 0.606.0__py3-none-any.whl → 0.608.0__py3-none-any.whl

orionis/metadata/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.606.0"
+VERSION = "0.608.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

orionis/services/introspection/concretes/reflection.py

@@ -317,27 +317,44 @@ class ReflectionConcrete(IReflectionConcrete):
         """
         return attribute in self.getAttributes()
 
-    def getAttribute(self, attribute: str):
+    def getAttribute(self, name: str, default: Any = None) -> Any:
         """
-        Get the value of a specific class attribute.
+        Retrieve the value of a specific class attribute.
+
+        This method attempts to fetch the value of the specified attribute from the class.
+        It first checks the combined attributes dictionary (including public, protected,
+        private, and dunder attributes). If the attribute is not found there, it falls
+        back to using `getattr` on the class itself. If the attribute does not exist,
+        the provided default value is returned.
 
         Parameters
         ----------
-        attribute : str
+        name : str
             The name of the attribute to retrieve.
+        default : Any, optional
+            The value to return if the attribute is not found (default is None).
 
         Returns
         -------
         Any
-            The value of the specified attribute, or None if not found.
+            The value of the specified attribute if found; otherwise, the provided default value.
 
         Raises
         ------
         ReflectionValueError
             If the attribute does not exist or is not accessible.
+
+        Notes
+        -----
+        This method does not raise an exception if the attribute is missing; it returns
+        the default value instead.
         """
+
+        # Get all attributes from the class (public, protected, private, dunder)
         attrs = self.getAttributes()
-        return attrs.get(attribute, None)
+
+        # Try to get the attribute from the attributes dictionary; if not found, use getattr on the class
+        return attrs.get(name, getattr(self._concrete, name, default))
 
     def setAttribute(self, name: str, value) -> bool:
         """

orionis/services/introspection/instances/reflection.py

@@ -247,27 +247,39 @@ class ReflectionInstance(IReflectionInstance):
         """
         return name in self.getAttributes()
 
-    def getAttribute(self, name: str) -> Any:
+    def getAttribute(self, name: str, default: Any = None) -> Any:
         """
-        Get an attribute value by name.
+        Retrieve the value of an attribute by its name from the instance.
 
         Parameters
         ----------
         name : str
-            The attribute name
+            The name of the attribute to retrieve.
+        default : Any, optional
+            The value to return if the attribute does not exist (default is None).
 
         Returns
         -------
         Any
-            The attribute value
+            The value of the specified attribute if it exists; otherwise, returns the provided `default` value.
 
         Raises
         ------
         AttributeError
-            If the attribute doesn't exist
+            If the attribute does not exist and no default value is provided.
+
+        Notes
+        -----
+        This method first checks the instance's attributes dictionary for the given name.
+        If not found, it attempts to retrieve the attribute directly from the instance using `getattr`.
+        If the attribute is still not found, the `default` value is returned.
         """
+
+        # Get all attributes of the instance (public, protected, private, dunder)
         attrs = self.getAttributes()
-        return attrs.get(name, None)
+
+        # Try to get the attribute from the attributes dictionary; if not found, use getattr with default
+        return attrs.get(name, getattr(self._instance, name, default))
 
     def setAttribute(self, name: str, value: Any) -> bool:
         """
@@ -532,33 +544,13 @@ class ReflectionInstance(IReflectionInstance):
         if not callable(method):
             raise ReflectionAttributeError(f"Cannot set attribute '{name}' to a non-callable value.")
 
-        # Extarct the signature of the method and classtype
-        sign = inspect.signature(method)
-        classtype = self.getClass()
-
-        # Check first parameter is 'cls'
-        params = list(sign.parameters.values())
-        if not params or params[0].name != "cls":
-            raise ReflectionAttributeError(f"The first (or only) argument of the method must be named 'cls' and must be of type {classtype}.")
-
-        # Get the expected type from the first parameter's annotation
-        annotation = params[0].annotation
-        if annotation != classtype:
-            raise ReflectionAttributeError(
-                f"The first argument has an incorrect annotation. Expected '{classtype}', but got '{annotation}'."
-            )
-
         # Handle private method name mangling
         if name.startswith("__") and not name.endswith("__"):
             class_name = self.getClassName()
             name = f"_{class_name}{name}"
 
-        # Check if the method already exists
-        if hasattr(self._instance, name):
-            raise ReflectionAttributeError(f"Attribute '{name}' already exists on '{self.getClassName()}'.")
-
         # Set the method on the instance
-        setattr(self._instance.__class__, name, method)
+        setattr(self._instance, name, method)
 
         # Return True
         return True

orionis/test/core/unit_test.py

@@ -17,6 +17,7 @@ from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.foundation.config.testing.enums.drivers import PersistentDrivers
 from orionis.foundation.config.testing.enums.mode import ExecutionMode
 from orionis.foundation.contracts.application import IApplication
+from orionis.services.introspection.concretes.reflection import ReflectionConcrete
 from orionis.services.introspection.instances.reflection import ReflectionInstance
 from orionis.support.performance.contracts.counter import IPerformanceCounter
 from orionis.test.contracts.test_result import IOrionisTestResult
@@ -27,21 +28,12 @@ from orionis.test.exceptions import OrionisTestValueError, OrionisTestFailureExc
 from orionis.test.output.printer import TestPrinter
 from orionis.test.records.logs import TestLogs
 from orionis.test.validators import (
-    ValidBasePath,
-    ValidExecutionMode,
-    ValidFailFast,
-    ValidFolderPath,
-    ValidModuleName,
-    ValidNamePattern,
-    ValidPattern,
-    ValidPersistentDriver,
-    ValidPersistent,
-    ValidThrowException,
-    ValidVerbosity,
-    ValidWebReport,
-    ValidWorkers,
+    ValidBasePath, ValidExecutionMode, ValidFailFast, ValidFolderPath,
+    ValidModuleName, ValidNamePattern, ValidPattern, ValidPersistentDriver,
+    ValidPersistent, ValidThrowException, ValidVerbosity, ValidWebReport, ValidWorkers,
 )
 from orionis.test.view.render import TestingResultRender
+import asyncio
 
 class UnitTest(IUnitTest):
     """
@@ -521,72 +513,6 @@ class UnitTest(IUnitTest):
                 "Please ensure the test case is correctly defined and contains valid test methods."
             )
 
-    def __isDecoratedMethod(
-        self,
-        test_case: unittest.TestCase
-    ) -> bool:
-        """
-        Determines whether the test method of a given test case is decorated (i.e., wrapped by one or more Python decorators).
-
-        This method inspects the test method associated with the provided `unittest.TestCase` instance to detect the presence of decorators.
-        It traverses the decorator chain by following the `__wrapped__` attribute, which is set by Python's `functools.wraps` or similar mechanisms.
-        Decorators are identified by the existence of the `__wrapped__` attribute, and their names are collected from the `__qualname__` or `__name__` attributes.
-
-        Parameters
-        ----------
-        test_case : unittest.TestCase
-            The test case instance whose test method will be checked for decorators.
-
-        Returns
-        -------
-        bool
-            True if the test method has one or more decorators applied (i.e., if any decorators are found in the chain).
-            False if the test method is not decorated or if no test method is found.
-
-        Notes
-        -----
-        - The method checks for decorators by traversing the `__wrapped__` attribute chain.
-        - Decorator names are collected for informational purposes but are not returned.
-        - If the test method is not decorated, or if no test method is found, the method returns False.
-        - This method does not modify the test case or its method; it only inspects for decoration.
-        """
-
-        # Retrieve the test method from the test case's class using the test method name
-        test_method = getattr(test_case.__class__, getattr(test_case, "_testMethodName"), None)
-
-        # List to store decorator names found during traversal
-        decorators = []
-
-        # Check if the method has the __wrapped__ attribute, indicating it is decorated
-        if hasattr(test_method, '__wrapped__'):
-
-            # Start with the outermost decorated method
-            original = test_method
-
-            # Traverse the decorator chain by following __wrapped__ attributes
-            while hasattr(original, '__wrapped__'):
-
-                # Collect decorator name information for tracking purposes
-                if hasattr(original, '__qualname__'):
-
-                    # Prefer __qualname__ for detailed naming information
-                    decorators.append(original.__qualname__)
-
-                elif hasattr(original, '__name__'):
-
-                    # Fall back to __name__ if __qualname__ is not available
-                    decorators.append(original.__name__)
-
-                # Move to the next level in the decorator chain
-                original = original.__wrapped__
-
-        # Return True if any decorators were found during the traversal
-        if decorators:
-            return True
-
-        # Return False if no decorators are found or if the method is not decorated
-        return False
-
     def __loadTests(
         self
     ) -> None:
@@ -667,10 +593,7 @@ class UnitTest(IUnitTest):
 
                         # Categorize and resolve test dependencies efficiently
                         target_list = debug_tests if self.__withDebugger(test) else normal_tests
-                        resolved_test = test
-                        if not self.__isDecoratedMethod(test):
-                            resolved_test = self.__resolveTestDependencies(test)
-                        target_list.append(resolved_test)
+                        target_list.append(self.__resolveTestDependencies(test))
 
                     # If no tests are found, raise an error
                     if not flat_tests:
@@ -943,10 +866,10 @@ class UnitTest(IUnitTest):
         """
         Inject dependencies into a single test case if required, returning a TestSuite containing the resolved test case.
 
-        This method uses reflection to inspect the test method's dependencies. If all dependencies are resolved,
-        it injects them using the application's resolver. If there are unresolved dependencies, the original test case
-        is returned as-is. Decorated methods and failed imports are also returned without modification. The returned
-        TestSuite contains the test case with dependencies injected if applicable.
+        This method uses reflection to inspect the test method for dependency requirements. If dependencies are resolved,
+        it injects them into the test method. Supports both synchronous and asynchronous test methods: async methods are
+        wrapped to run in an event loop. If dependencies cannot be resolved, the original test case is returned as-is
+        within a TestSuite.
 
         Parameters
         ----------
@@ -956,7 +879,7 @@ class UnitTest(IUnitTest):
         Returns
         -------
         unittest.TestSuite
-            A TestSuite containing the test case with dependencies injected if required.
+            A TestSuite containing the test case with injected dependencies if resolution is successful.
             If dependency injection is not possible or fails, the original test case is returned as-is within the suite.
 
         Raises
@@ -966,10 +889,10 @@ class UnitTest(IUnitTest):
 
         Notes
         -----
-        - Uses reflection to determine method dependencies.
+        - Uses ReflectionInstance to determine method dependencies.
         - If dependencies are resolved, injects them into the test method.
+        - Supports async test methods by running them in an event loop.
         - If dependencies are unresolved or an error occurs, the original test case is returned.
-        - The returned value is always a unittest.TestSuite containing the test case (with or without injected dependencies).
         """
 
         # Create a new TestSuite to hold the resolved test case
@@ -977,46 +900,68 @@ class UnitTest(IUnitTest):
 
         try:
 
-            # Get the reflection instance for the test case
+            # Use reflection to inspect the test case for dependency requirements
             rf_instance = ReflectionInstance(test_case)
-
-            # Get the test method name
-            method_name = getattr(test_case, "_testMethodName", None)
-
-            # Get method dependencies (resolved and unresolved)
+            method_name = rf_instance.getAttribute("_testMethodName", None)
             dependencies = rf_instance.getMethodDependencies(method_name)
 
-            # If there are unresolved dependencies, return the original test case as-is
+            # If there are unresolved dependencies, return the original test case
             if dependencies.unresolved:
                 return test_case
 
-            # If there are resolved dependencies, inject them into the test method
+            # If dependencies are resolved, inject them into the test method
             if dependencies.resolved:
 
-                # Get the test class and original method
-                test_class = rf_instance.getClass()
-                original_method = getattr(test_class, method_name)
+                # Get the test case class
+                test_cls = rf_instance.getClass()
+
+                # Create a ReflectionConcrete instance for the test case class
+                rf_concrete = ReflectionConcrete(test_cls)
+
+                # Get the original test method
+                original_method = rf_concrete.getAttribute(method_name)
+
+                # Resolve the actual arguments to inject
+                resolved_args = self.__app.resolveDependencyArguments(
+                    rf_instance.getClassName(),
+                    dependencies
+                )
+
+                # If the test method is asynchronous, wrap it to run in an event loop
+                if asyncio.iscoroutinefunction(original_method):
+
+                    # Define an async wrapper to inject dependencies
+                    async def async_wrapper(self_instance):
+                        return await original_method(self_instance, **resolved_args)
+
+                    # Wrap with a sync function for unittest compatibility
+                    def sync_wrapper(self_instance):
+                        return asyncio.run(async_wrapper(self_instance))
+
+                    # Bind the wrapped method to the test case instance
+                    bound_method = sync_wrapper.__get__(test_case, test_cls)
+
+                else:
 
-                # Resolve dependencies using the application container
-                resolved_args = self.__app.resolveDependencyArguments(rf_instance.getClassName(), dependencies)
+                    # For synchronous methods, inject dependencies directly
+                    def wrapper(self_instance):
+                        return original_method(self_instance, **resolved_args)
 
-                # Define a wrapper function to inject dependencies
-                def wrapper(self_instance):
-                    return original_method(self_instance, **resolved_args)
+                    # Bind the wrapped method to the test case instance
+                    bound_method = wrapper.__get__(test_case, test_cls)
 
-                # Bind the wrapped method to the test case instance
-                bound_method = wrapper.__get__(test_case, test_case.__class__)
-                setattr(test_case, method_name, bound_method)
+                # Replace the test method with the dependency-injected version
+                rf_instance.setMethod(method_name, bound_method)
 
-            # Add the test case to the suite (with injected dependencies if applicable)
-            suite.addTest(test_case)
+            # Add the (possibly resolved) test case to the suite
+            suite.addTest(rf_instance.getInstance())
 
-            # Return the TestSuite containing the resolved test case
+            # Return the suite containing the resolved test case
             return suite
 
         except Exception:
 
-            # On any error, return the original test case without injection
+            # On error, return the original test case
             return test_case
 
     def __runTestsSequentially(

{orionis-0.606.0.dist-info → orionis-0.608.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.606.0
+Version: 0.608.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

{orionis-0.606.0.dist-info → orionis-0.608.0.dist-info}/RECORD

@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=irwkjMiq-HpsbJxAOnhjji
 orionis/foundation/providers/testing_provider.py,sha256=2akFnabtH_cV_7z_2cCL7u8cPCGvCJAmlhMcnlCrc4c,3742
 orionis/foundation/providers/workers_provider.py,sha256=P_YtJuPNrdJAQJkAqI11KI0c6GSB9NqIuuCKpRytE0g,3937
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=odWSJSUt5IWkgay1iLh-7SeBkjLj7pKW8VDc-bGBjz8,4109
+orionis/metadata/framework.py,sha256=mHrtbv7UZURpFJdeEpp8Dnaje-qCMCpwZDVEfXFE0Fc,4109
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -267,7 +267,7 @@ orionis/services/introspection/callables/reflection.py,sha256=zzxrjExc2iIlfs3xfo
 orionis/services/introspection/callables/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/callables/contracts/reflection.py,sha256=EZi9VfTf5GJBnMd47j_oJ8dENQ5-HzDbQ-4zSffrvpM,5523
 orionis/services/introspection/concretes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/concretes/reflection.py,sha256=ZOScKOATUNA-gOJIG_8Z2Q5XXI2kAmDRCg8fg2SFklg,55872
+orionis/services/introspection/concretes/reflection.py,sha256=vKgkDfIbuRYH4iTcHaYoHIAMalZfGjmJ_tYTG7mhsbQ,56823
 orionis/services/introspection/concretes/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/concretes/contracts/reflection.py,sha256=LwEAgdN_WLCfS9b8pnFRVfN0PTRK4Br9qngu5km5aIk,24955
 orionis/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -280,7 +280,7 @@ orionis/services/introspection/dependencies/entities/resolve_argument.py,sha256=
 orionis/services/introspection/exceptions/__init__.py,sha256=uVRbnndapr9veJps8EzFJeLItxnMEbjUDdPBy3dQbeM,221
 orionis/services/introspection/exceptions/introspection.py,sha256=Qd021psWiXyY9HQVNWIBVZ3KNfHGSgq8NL4btUTR8tg,2532
 orionis/services/introspection/instances/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/introspection/instances/reflection.py,sha256=vn43FdZNP-tkIbKvX0TdptGRQZ1FntZ49xDJ_VAM4jM,54937
+orionis/services/introspection/instances/reflection.py,sha256=WTkHHST8DIjKV_-DygzOsx2IA7yL5aqkr0Zn6EWm2Xo,54809
 orionis/services/introspection/instances/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/instances/contracts/reflection.py,sha256=OBZ7vI6KsII76oqIF63v1I-msh94_xGfhPZQvqAVLgY,20834
 orionis/services/introspection/modules/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -371,7 +371,7 @@ orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZ
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
 orionis/test/contracts/unit_test.py,sha256=EyidHoOPJItwgkBWGYY1TymbNklyn2EUXnghVvW4htc,4652
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=3fj_u1fJHhnitfLfcAL3-KeEc_Zt-mQNX9Np4sPxrbY,72952
+orionis/test/core/unit_test.py,sha256=_-Q50AsPNy8NYrlHn2JyKQNU3ohWG2BFZnfh_k5AdEI,70695
 orionis/test/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZzGo,4777
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
@@ -404,8 +404,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.606.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.606.0.dist-info/METADATA,sha256=wfgtPHMn36qRmNCqbl8zfkH5oUX3kvWnALfHtyEsRe4,4801
-orionis-0.606.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.606.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.606.0.dist-info/RECORD,,
+orionis-0.608.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.608.0.dist-info/METADATA,sha256=Dg4sMgNBKxL6QBvK42DbwGmwHAOJrViOuWZPnPYtLtM,4801
+orionis-0.608.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.608.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.608.0.dist-info/RECORD,,