orionis 0.471.0__py3-none-any.whl → 0.473.0__py3-none-any.whl

orionis/console/core/reactor.py

@@ -520,7 +520,7 @@ class Reactor(IReactor):
                 command_instance._args = {}
 
             # Call the handle method of the command instance
-            output =  self.__app.call(command_instance, 'handle')
+            output = self.__app.call(command_instance, 'handle')
 
             # Log the command execution completion with DONE state
             elapsed_time = round(time.perf_counter() - start_time, 2)

orionis/container/container.py

@@ -1,4 +1,5 @@
 import abc
+import asyncio
 import inspect
 import threading
 import typing
@@ -106,6 +107,122 @@ class Container(IContainer):
             # Mark this instance as initialized
             self.__initialized = True
 
+    def __handleSyncAsyncResult(
+        self,
+        result: Any
+    ) -> Any:
+        """
+        Universal helper to handle both synchronous and asynchronous results.
+
+        This method automatically detects if a result is a coroutine and handles
+        it appropriately based on the current execution context.
+
+        Parameters
+        ----------
+        result : Any
+            The result to handle, which may be a coroutine or regular value.
+
+        Returns
+        -------
+        Any
+            The resolved result. If the result was a coroutine, it will be awaited
+            if possible, or scheduled appropriately.
+        """
+
+        # If the result is not a coroutine, return it directly
+        if not asyncio.iscoroutine(result):
+            return result
+
+        try:
+
+            # Check if we're currently in an event loop
+            loop = asyncio.get_running_loop()
+
+            # If we're in an async context, we need to let the caller handle the coroutine
+            # Since we can't await here, we'll create a task and get the result synchronously
+            # This is a compromise for mixed sync/async environments
+            if loop.is_running():
+
+                # For running loops, we create a new thread to run the coroutine
+                import concurrent.futures
+
+                # Define a function to run the coroutine in a new event loop
+                def run_coroutine():
+
+                    # Create a new event loop for this thread
+                    new_loop = asyncio.new_event_loop()
+                    asyncio.set_event_loop(new_loop)
+
+                    # Run the coroutine until completion
+                    try:
+                        return new_loop.run_until_complete(result)
+
+                    # Finally, ensure the loop is closed to free resources
+                    finally:
+                        new_loop.close()
+
+                # Use ThreadPoolExecutor to run the coroutine in a separate thread
+                with concurrent.futures.ThreadPoolExecutor() as executor:
+                    future = executor.submit(run_coroutine)
+                    return future.result()
+
+            else:
+                # If loop exists but not running, we can run the coroutine
+                return loop.run_until_complete(result)
+
+        except RuntimeError:
+
+            # No event loop running, we can run the coroutine directly
+            return asyncio.run(result)
+
+    def __invokeCallableUniversal(
+        self,
+        fn: Callable[..., Any],
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Universal callable invoker that handles both sync and async callables.
+
+        Parameters
+        ----------
+        fn : Callable[..., Any]
+            The callable to invoke.
+        *args : tuple
+            Positional arguments to pass to the callable.
+        **kwargs : dict
+            Keyword arguments to pass to the callable.
+
+        Returns
+        -------
+        Any
+            The result of the callable invocation.
+
+        Raises
+        ------
+        OrionisContainerException
+            If the callable invocation fails.
+        """
+
+        try:
+
+            # Check if the callable is a coroutine function
+            result = fn(*args, **kwargs)
+            return self.__handleSyncAsyncResult(result)
+
+        except TypeError as e:
+
+            # If invocation fails, use ReflectionCallable for better error messaging
+            rf_callable = ReflectionCallable(fn)
+            function_name = rf_callable.getName()
+            signature = rf_callable.getSignature()
+
+            # Raise a more informative exception with the function name and signature
+            raise OrionisContainerException(
+                f"Failed to invoke function [{function_name}] with the provided arguments: {e}\n"
+                f"Expected function signature: [{signature}]"
+            ) from e
+
     def transient(
         self,
         abstract: Callable[..., Any],
@@ -1284,6 +1401,7 @@ class Container(IContainer):
     ) -> Any:
         """
         Invokes a callable with the provided arguments.
+        Supports both synchronous and asynchronous callables automatically.
 
         Parameters
         ----------
@@ -1297,27 +1415,10 @@ class Container(IContainer):
         Returns
         -------
         Any
-            The result of the callable.
+            The result of the callable. If the callable is async,
+            the coroutine will be handled automatically.
         """
-
-        # Try to invoke the callable with the provided arguments
-        try:
-
-            # If the callable is a function, invoke it directly
-            return fn(*args, **kwargs)
-
-        except TypeError as e:
-
-            # If invocation fails, use ReflectionCallable to get function name and signature
-            rf_callable = ReflectionCallable(fn)
-            function_name = rf_callable.getName()
-            signature = rf_callable.getSignature()
-
-            # Raise an exception with detailed information about the failure
-            raise OrionisContainerException(
-                f"Failed to invoke function [{function_name}] with the provided arguments: {e}\n"
-                f"Expected function signature: [{signature}]"
-            ) from e
+        return self.__invokeCallableUniversal(fn, *args, **kwargs)
 
     def __instantiateConcreteReflective(
         self,
@@ -1359,13 +1460,13 @@ class Container(IContainer):
 
         # Try simple call first for functions without parameters
         try:
-
             # Use ReflectionCallable to get dependencies
             dependencies = ReflectionCallable(fn).getDependencies()
 
             # If there are no required parameters, call directly
             if not dependencies or (not dependencies.resolved and not dependencies.unresolved):
-                return fn()
+                result = fn()
+                return self.__handleSyncAsyncResult(result)
 
             # If there are unresolved dependencies, raise an exception
             if dependencies.unresolved:
@@ -1379,13 +1480,19 @@ class Container(IContainer):
                 getattr(fn, '__name__', str(fn)),
                 dependencies
             )
-            return fn(**resolved_params)
+
+            # Invoke the callable with resolved parameters
+            result = fn(**resolved_params)
+
+            # Handle the result, which may be a coroutine
+            return self.__handleSyncAsyncResult(result)
 
         except Exception as inspect_error:
 
             # If inspection fails, try direct call as last resort
             try:
-                return fn()
+                result = fn()
+                return self.__handleSyncAsyncResult(result)
 
             # If direct call fails, raise inspection error
             except TypeError:
@@ -1533,6 +1640,7 @@ class Container(IContainer):
             return params
 
         except Exception as e:
+
             # If the exception is already an OrionisContainerException, re-raise it
             if isinstance(e, OrionisContainerException):
                 raise e from None
@@ -1621,6 +1729,7 @@ class Container(IContainer):
     ) -> Any:
         """
         Helper method to instantiate a target with reflection-based dependency resolution.
+        Supports both synchronous and asynchronous callables automatically.
 
         Parameters
         ----------
@@ -1632,13 +1741,20 @@ class Container(IContainer):
         Returns
         -------
         Any
-            The instantiated object or callable result.
+            The instantiated object or callable result. If the callable is async,
+            the coroutine will be handled automatically.
         """
 
+        # Reflect the target to get its dependencies
         resolved_params = self.__resolveDependencies(
             *self.__reflectTarget(target, is_class=is_class)
         )
-        return target(**resolved_params)
+
+        # If the target is a class, instantiate it with resolved parameters
+        result = target(**resolved_params)
+
+        # Handle the result, which may be a coroutine
+        return self.__handleSyncAsyncResult(result)
 
     def resolveWithoutContainer(
         self,
@@ -2118,6 +2234,7 @@ class Container(IContainer):
     ) -> Any:
         """
         Call a method on an instance with automatic dependency injection.
+        Supports both synchronous and asynchronous methods automatically.
 
         Parameters
         ----------
@@ -2133,13 +2250,84 @@ class Container(IContainer):
         Returns
         -------
         Any
-            The result of the method call.
+            The result of the method call. If the method is async,
+            the coroutine will be handled automatically.
+        """
+
+        # Validate inputs
+        self.__validateCallInputs(instance, method_name)
+
+        # Get the method
+        method = getattr(instance, method_name)
+
+        # Execute the method with appropriate handling
+        return self.__executeMethod(method, *args, **kwargs)
+
+    async def callAsync(
+        self,
+        instance: Any,
+        method_name: str,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Async version of call for when you're in an async context and need to await the result.
+
+        Parameters
+        ----------
+        instance : Any
+            The instance on which to call the method.
+        method_name : str
+            The name of the method to call.
+        *args : tuple
+            Positional arguments to pass to the method.
+        **kwargs : dict
+            Keyword arguments to pass to the method.
+
+        Returns
+        -------
+        Any
+            The result of the method call, properly awaited if async.
+        """
+
+        # Validate inputs
+        self.__validateCallInputs(instance, method_name)
+
+        # Get the method
+        method = getattr(instance, method_name)
+
+        # Execute the method with async handling
+        result = self.__executeMethod(method, *args, **kwargs)
+
+        # If the result is a coroutine, await it
+        if asyncio.iscoroutine(result):
+            return await result
+
+        # Otherwise, return the result directly
+        return result
+
+    def __validateCallInputs(self, instance: Any, method_name: str) -> None:
+        """
+        Validates the inputs for the call methods.
+
+        Parameters
+        ----------
+        instance : Any
+            The instance to validate.
+        method_name : str
+            The method name to validate.
+
+        Raises
+        ------
+        OrionisContainerException
+            If validation fails.
         """
 
         # Ensure the instance is a valid object (allow __main__ for development)
         if instance is None:
             raise OrionisContainerException("Instance cannot be None")
 
+        # Ensure the instance is a valid object with a class
         if not hasattr(instance, '__class__'):
             raise OrionisContainerException("Instance must be a valid object with a class")
 
@@ -2161,12 +2349,35 @@ class Container(IContainer):
                 f"Method '{method_name}' not found or not callable on instance '{type(instance).__name__}'."
             )
 
+    def __executeMethod(
+        self,
+        method: Callable,
+        *args,
+        **kwargs
+    ) -> Any:
+        """
+        Executes a method with automatic dependency injection and sync/async handling.
+
+        Parameters
+        ----------
+        method : Callable
+            The method to execute.
+        *args : tuple
+            Positional arguments to pass to the method.
+        **kwargs : dict
+            Keyword arguments to pass to the method.
+
+        Returns
+        -------
+        Any
+            The result of the method execution.
+        """
+
         # If args or kwargs are provided, use them directly
         if args or kwargs:
-            return self.__instantiateCallableWithArgs(method, *args, **kwargs)
+            return self.__invokeCallableUniversal(method, *args, **kwargs)
 
         # For methods without provided arguments, try simple call first
-        # This avoids reflection issues for simple methods
         try:
 
             # Get method signature to check if it needs parameters
@@ -2178,19 +2389,22 @@ class Container(IContainer):
 
             # If no required parameters, call directly
             if not params:
-                return method()
+                result = method()
+                return self.__handleSyncAsyncResult(result)
 
             # If has required parameters, try dependency injection
-            return self.__instantiateWithReflection(method, is_class=False)
+            result = self.__instantiateWithReflection(method, is_class=False)
+            return result
 
         except Exception as reflection_error:
 
             # If reflection fails, try simple call as fallback
             try:
-                return method()
+                result = method()
+                return self.__handleSyncAsyncResult(result)
 
-            # If simple call also fails, raise the original reflection error
+            # If both reflection and simple call fail, raise an exception
             except TypeError:
                 raise OrionisContainerException(
-                    f"Failed to call method '{method_name}': {reflection_error}"
-                ) from reflection_error
+                    f"Failed to call method '{method.__name__}': {reflection_error}"
+                ) from reflection_error

orionis/metadata/framework.py

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

{orionis-0.471.0.dist-info → orionis-0.473.0.dist-info}/METADATA

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

{orionis-0.471.0.dist-info → orionis-0.473.0.dist-info}/RECORD

@@ -22,7 +22,7 @@ orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01
 orionis/console/contracts/reactor.py,sha256=GGhWSNYBE6E_W3HNEi4kjiDwqohsa-nnwJfoC1nJPM8,1998
 orionis/console/contracts/schedule.py,sha256=A7yYPjPmRizDHOR9k4qvY3NuRPrWBmNuQs6ENGXWtBs,70
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=R5mS6hdNivqBQEUQaBePcMi0HXtN_ifWbb-ZlPIlIKU,23572
+orionis/console/core/reactor.py,sha256=A0koFZaizrK9R1jlFbx9zdf9UZ4tBxSRJY04hcGzbsQ,23571
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/dump.py,sha256=CATERiQ6XuIrKQsDaWcVxzTtlAJI9qLJX44fQxEX8ws,22443
 orionis/console/dumper/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -47,7 +47,7 @@ orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/schedule.py,sha256=ANRuPRRd-znbMD5fcPNgKAv69XOECWod7mugF5_dt0U,26636
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/container.py,sha256=MmvFm0Y-x667mIYPunmBnHzQHBsWJObT5_zuWrgqaWU,80528
+orionis/container/container.py,sha256=p7kJ-hwnDattTWCArt0ypol4bW3M334hIZ2FAQhID-w,87570
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/context/manager.py,sha256=I08K_jKXSKmrq18Pv33qYyMKIlAovVOwIgmfiVm-J7c,2971
 orionis/container/context/scope.py,sha256=p_oCzR7dDz-5ZAd16ab4vfLc3gBf34CaN0f4iR9D0bQ,1155
@@ -190,7 +190,7 @@ orionis/foundation/providers/reactor_provider.py,sha256=P0KQcp4AFKTrD6BStGfCTqhG
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 orionis/foundation/providers/workers_provider.py,sha256=oa_2NIDH6UxZrtuGkkoo_zEoNIMGgJ46vg5CCgAm7wI,3926
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=Z11lk3yQI0ENTmiVxaQtKovPA5ViRPC2HZaMwQduE3w,4109
+orionis/metadata/framework.py,sha256=khas6LVa0a512rnxIkerr5kQToXUs9YMIA2u1NLPsYc,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
@@ -356,13 +356,15 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.471.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.473.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/test_manager.py,sha256=wOwXpl9rHNfTTexa9GBKYMwK0_-KSQPbI-AEyGNkmAE,1356
 tests/container/context/test_scope.py,sha256=1YGfOHwOjLiQ1GPewbJGrUaTyH0SjrQux7LBVn_l2q4,1223
 tests/container/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/container/core/test_advanced_async.py,sha256=kqNGCPwBlQBB3JBWHgyC7TVPfTEIf34Bz6C2ZBwLz68,10192
+tests/container/core/test_async_optimizations.py,sha256=jal7neUv_N8GoSOi0EvtDlWDcLw46Yc0uf2MTCHW3SY,12348
 tests/container/core/test_container.py,sha256=6F4y5t-dR2E6eVKRI_hvKty0LhvTkXqiLGjaGVwsSb4,15775
 tests/container/core/test_singleton.py,sha256=CfOB-YkIh16Pu5rNbOp5dD9cvMfWXHQESADDYSBcsQg,4801
 tests/container/core/test_thread_safety.py,sha256=-GiscMxZJXr8vRiir_i7_6YtYqG9zDGo52druYk6qKo,3785
@@ -373,6 +375,8 @@ tests/container/enums/test_lifetimes.py,sha256=JFb4q1rgo10C5ibQ6LS-776NevxCMNLSq
 tests/container/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/facades/test_facade.py,sha256=aCy0S6YaaiswGoodJEAhNkqJrMaEQL-CcWh2AgXMvvQ,2938
 tests/container/mocks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/container/mocks/mock_advanced_async.py,sha256=Kcbo0bdvv4alVgu66DuSkxHgAWXM_LZFvqBrNFsZGp8,11423
+tests/container/mocks/mock_async_optimizations.py,sha256=nLHglkDJNF3XJbIGkLo3KZWBR4yjKd55cVrQC1BrtRU,12432
 tests/container/mocks/mock_auto_resolution.py,sha256=PprLC_UbZb0hV69CTzZ3t-5FLLvE-WCTA-6W7wcOIZQ,7340
 tests/container/mocks/mock_complex_classes.py,sha256=YkC8tgDHU0YVEkIeUPd39gp3zkGLpFObQKzjuxatqro,20307
 tests/container/mocks/mock_simple_classes.py,sha256=bzKbmwOD-RBTT8GVN_W53ufGEWpjppe4g5mX6CI5Yk0,2317
@@ -499,8 +503,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.471.0.dist-info/METADATA,sha256=dGJTEj76Vp1GTGBs5XuKcu_A_bjONiaX2NIgwqXrDY4,4801
-orionis-0.471.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.471.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.471.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.471.0.dist-info/RECORD,,
+orionis-0.473.0.dist-info/METADATA,sha256=9Tq4vH590vaqS1n0K22s4CyuqlKdrf7c4m2nxJyn7cM,4801
+orionis-0.473.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.473.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.473.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.473.0.dist-info/RECORD,,