orionis 0.534.0__py3-none-any.whl → 0.535.0__py3-none-any.whl

orionis/foundation/application.py

@@ -24,6 +24,7 @@ from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.foundation.contracts.application import IApplication
 from orionis.foundation.exceptions import OrionisTypeError, OrionisRuntimeError, OrionisValueError
 from orionis.foundation.providers.logger_provider import LoggerProvider
+from orionis.services.asynchrony.coroutines import Coroutine
 from orionis.services.log.contracts.log_service import ILogger
 
 class Application(Container, IApplication):
@@ -342,7 +343,7 @@ class Application(Container, IApplication):
             # Register the provider in the container
             # Check if register is a coroutine function
             if asyncio.iscoroutinefunction(class_provider.register):
-                asyncio.run(class_provider.register())
+                Coroutine(class_provider.register).run()
             else:
                 class_provider.register()
 
@@ -379,7 +380,7 @@ class Application(Container, IApplication):
             if hasattr(provider, 'boot') and callable(getattr(provider, 'boot')):
                 # Check if boot is a coroutine function
                 if asyncio.iscoroutinefunction(provider.boot):
-                    asyncio.run(provider.boot())
+                    Coroutine(provider.boot).run()
                 else:
                     provider.boot()
 

orionis/metadata/framework.py

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

orionis/services/asynchrony/contracts/coroutines.py

@@ -6,23 +6,71 @@ T = TypeVar("T")
 
 class ICoroutine(ABC):
 
+    @abstractmethod
+    def invoke(self, *args, **kwargs) -> Union[T, asyncio.Task, None]:
+        """
+        Invoke the callable coroutine function with the provided arguments.
+
+        This method executes a callable coroutine function or regular function with the given
+        arguments and keyword arguments. It automatically detects the execution context and
+        handles both synchronous and asynchronous execution appropriately.
+
+        Parameters
+        ----------
+        *args : tuple
+            Positional arguments to pass to the callable function.
+        **kwargs : dict
+            Keyword arguments to pass to the callable function.
+
+        Returns
+        -------
+        Union[T, asyncio.Task, None]
+            - T: The result of the coroutine if executed synchronously
+            - asyncio.Task: A task object if scheduled for asynchronous execution
+            - None: If the callable is not a coroutine function
+
+        Raises
+        ------
+        OrionisCoroutineException
+            If an error occurs during coroutine execution.
+        RuntimeError
+            If an error occurs during callable execution that is not coroutine-related.
+
+        Notes
+        -----
+        - Only callable objects can be invoked with this method
+        - For coroutine functions, execution context is automatically detected
+        - Non-coroutine callables are executed directly and return None
+        - Exceptions are wrapped with appropriate context information
+
+        Examples
+        --------
+        >>> async def my_coro(x, y):
+        ...     return x + y
+        >>> coro = Coroutine(my_coro)
+        >>> result = coro.invoke(1, 2)  # Returns Task or result depending on context
+        """
+        pass
+
     @abstractmethod
     def run(self) -> Union[T, asyncio.Future]:
         """
-        Execute the wrapped coroutine either synchronously or asynchronously, depending on the execution context.
+        Executes the wrapped coroutine, adapting to the current event loop context.
 
         Returns
         -------
         T or asyncio.Future
-            If called outside of an event loop, returns the result of the coroutine execution (type T).
-            If called within an event loop, returns an asyncio.Future representing the scheduled coroutine.
+            The result of the coroutine if executed synchronously, or an asyncio.Future if scheduled asynchronously.
+
+        Raises
+        ------
+        RuntimeError
+            If the coroutine cannot be executed due to event loop issues.
 
         Notes
         -----
-        - Executes the coroutine synchronously and returns its result when called outside an event loop.
-        - Schedules the coroutine for asynchronous execution and returns a Future when called inside an event loop.
-        - The caller is responsible for awaiting the Future if asynchronous execution is used.
+        - If called outside an active event loop, the coroutine is executed synchronously and its result is returned.
+        - If called within an active event loop, the coroutine is scheduled for asynchronous execution and a Future is returned.
+        - The method automatically detects the execution context and chooses the appropriate execution strategy.
         """
-
-        # This method should be implemented by subclasses to handle coroutine execution.
-        pass
+        pass

{orionis-0.534.0.dist-info → orionis-0.535.0.dist-info}/METADATA

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

{orionis-0.534.0.dist-info → orionis-0.535.0.dist-info}/RECORD

@@ -126,7 +126,7 @@ orionis/failure/contracts/handler.py,sha256=drNE8iu8RUHi3TgKn-lUEIfVsZeGsMTUecTZ
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=ogys062uhim5QMYU62ezlnumRAnYQlUf_vZvQY47S3U,1227
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=JtTFU__67Vrg4vDA5ieNu1WgqiBjulaJJRjAgYIVRgE,86422
+orionis/foundation/application.py,sha256=RwMRjRp9kkKRbDsz_lAN4NYadCuaDbmDnccWKl8aKng,86488
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=vbzduprRCNyYeR2nnMaqc1uKXw6PTzAY2jVfXNQKN8I,9691
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -242,13 +242,13 @@ orionis/foundation/providers/scheduler_provider.py,sha256=1do4B09bU_6xbFHHVYYTGM
 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=nuA2nefeGQ2B3VGS-om5qZigBmEBbAZwhTnm54CFJn0,4109
+orionis/metadata/framework.py,sha256=uWTlWqt2g9tvRAk56GneEvJAcpVopbXX5L67RJzuXX8,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
 orionis/services/asynchrony/coroutines.py,sha256=M1o4Al5dk8BR85CWHHUgymVQaD_6PgirenQMeITUoZQ,6863
 orionis/services/asynchrony/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/asynchrony/contracts/coroutines.py,sha256=rVy1HO58RFKliGeaf6GUC7mGtPZXimIhzkFHR1EWRoc,1082
+orionis/services/asynchrony/contracts/coroutines.py,sha256=Hjm-JOK-CjCDWa8sSaJZ7ccM_LxsVsYWFcYSSVciQ3U,2825
 orionis/services/asynchrony/exceptions/__init__.py,sha256=COm6RhSiuwWqy3YcJ_0gVu6XHjn5P3zVaiUp5Pw_h48,99
 orionis/services/asynchrony/exceptions/exception.py,sha256=Npze-29hlzjXxOZt3RF1R9yp0O1tMSRt7sCWXKjy3Pc,772
 orionis/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -420,7 +420,7 @@ 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.534.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.535.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 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
@@ -566,8 +566,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.534.0.dist-info/METADATA,sha256=R7FBw3jg3tfT8gujp8PmJLFqoTJK6oXImdwynE9zV9c,4801
-orionis-0.534.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.534.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.534.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.534.0.dist-info/RECORD,,
+orionis-0.535.0.dist-info/METADATA,sha256=fgBBQFe8aw1uvm0D0Wr1yobSyOoPlEzaiEaylQpTSd0,4801
+orionis-0.535.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.535.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.535.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.535.0.dist-info/RECORD,,