orionis 0.531.0__py3-none-any.whl → 0.533.0__py3-none-any.whl

orionis/console/commands/make_listener.py

@@ -0,0 +1,57 @@
+from orionis.console.base.command import BaseCommand
+from orionis.console.contracts.reactor import IReactor
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from rich.console import Console
+from rich.panel import Panel
+
+class MakeListenerCommand(BaseCommand):
+    """
+    Este comando se encarga de crear los listener tando para CLI como para otro tipo de Eventos.
+    """
+
+    # Indicates whether timestamps will be shown in the command output
+    timestamps: bool = False
+
+    # Command signature and description
+    signature: str = "make:listener"
+
+    # Command description
+    description: str = "Displays usage information, examples, and a list of available commands in the Orionis CLI."
+
+    def handle(self) -> dict:
+        """
+        Displays usage information and a list of available commands for the Orionis CLI.
+
+        Parameters
+        ----------
+        reactor : IReactor
+            The reactor instance providing command metadata via the `info()` method.
+
+        Returns
+        -------
+        dict
+            A dictionary containing the list of available commands, each with its signature and description.
+
+        Raises
+        ------
+        CLIOrionisRuntimeError
+            If an unexpected error occurs during help information generation or display.
+        """
+        try:
+
+            # Solicitar el nombre del listener al usuario
+            ans = self.choice(
+                question="Tipo de Listener",
+                choices=[
+                    "Listener para eventos CLI",
+                    "Listener para eventos de Schedule",
+                ],
+                default_index=0
+            )
+
+            print(ans)
+
+        except Exception as e:
+
+            # Raise a custom runtime error if any exception occurs
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/console/core/reactor.py

@@ -114,6 +114,7 @@ class Reactor(IReactor):
         from orionis.console.commands.cache import CacheClearCommand
         from orionis.console.commands.scheduler_work import ScheduleWorkCommand
         from orionis.console.commands.scheduler_list import ScheduleListCommand
+        from orionis.console.commands.make_listener import MakeListenerCommand
 
         # List of core command classes to load (extend this list as more core commands are added)
         core_commands = [
@@ -124,7 +125,8 @@ class Reactor(IReactor):
             WorkFlowGithubCommand,
             CacheClearCommand,
             ScheduleWorkCommand,
-            ScheduleListCommand
+            ScheduleListCommand,
+            MakeListenerCommand
         ]
 
         # Iterate through the core command classes and register them

orionis/failure/base/handler.py

@@ -8,12 +8,12 @@ from orionis.services.log.contracts.log_service import ILogger
 class BaseExceptionHandler(IBaseExceptionHandler):
 
     # Exceptions that should not be caught by the handler
-    dont_cathc: List[type[BaseException]] = [
+    dont_catch: List[type[BaseException]] = [
         # Add specific exceptions that should not be caught
         # Example: OrionisContainerException
     ]
 
-    def destructureException(self, e: BaseException) -> Throwable:
+    async def destructureException(self, e: BaseException) -> Throwable:
         """
         Converts an exception into a structured `Throwable` object containing detailed information.
 
@@ -41,7 +41,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
             traceback=getattr(e, '__traceback__', None)     # The traceback object, if available
         )
 
-    def shouldIgnoreException(self, e: BaseException) -> bool:
+    async def shouldIgnoreException(self, e: BaseException) -> bool:
         """
         Determines if the exception should be ignored (not handled) by the handler.
 
@@ -61,12 +61,12 @@ class BaseExceptionHandler(IBaseExceptionHandler):
             raise TypeError(f"Expected BaseException, got {type(e).__name__}")
 
         # Convert the exception into a structured Throwable object
-        throwable = self.destructureException(e)
+        throwable = await self.destructureException(e)
 
         # Check if the exception type is in the list of exceptions to ignore
-        return hasattr(self, 'dont_cathc') and throwable.classtype in self.dont_cathc
+        return hasattr(self, 'dont_catch') and throwable.classtype in self.dont_catch
 
-    def report(self, exception: BaseException, log: ILogger) -> Any:
+    async def report(self, exception: BaseException, log: ILogger) -> Any:
         """
         Report or log an exception.
 
@@ -84,7 +84,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
             raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
 
         # Convert the exception into a structured Throwable object
-        throwable = self.destructureException(exception)
+        throwable = await self.destructureException(exception)
 
         # Log the exception details
         log.error(f"[{throwable.classtype.__name__}] {throwable.message}")
@@ -92,7 +92,7 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         # Return the structured exception
         return throwable
 
-    def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
+    async def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 
@@ -109,11 +109,15 @@ class BaseExceptionHandler(IBaseExceptionHandler):
         if not isinstance(exception, BaseException):
             raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
 
+        # Ensure the request is a CLIRequest
+        if not isinstance(request, CLIRequest):
+            raise TypeError(f"Expected CLIRequest, got {type(request).__name__}")
+
         # Convert the exception into a structured Throwable object
-        throwable = self.destructureException(exception)
+        throwable = await self.destructureException(exception)
 
-        args = request.args if isinstance(request, CLIRequest) and request.args else []
-        string_args = ' '.join(args)
+        # Convert the request arguments to a string for logging
+        string_args = ' '.join(request.args)
 
         # Log the CLI error message with arguments
         log.error(f"CLI Error: {throwable.message} (Args: {string_args})")

orionis/failure/catch.py

@@ -1,11 +1,11 @@
 from typing import Any
 from orionis.console.kernel import KernelCLI
 from orionis.console.output.contracts.console import IConsole
-from orionis.console.tasks.schedule import Schedule
 from orionis.failure.contracts.catch import ICatch
 from orionis.failure.contracts.handler import IBaseExceptionHandler
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.log.contracts.log_service import ILogger
+import asyncio
 
 class Catch(ICatch):
 
@@ -74,21 +74,89 @@ class Catch(ICatch):
         If a valid kernel is provided, the exception details are rendered to the CLI.
         """
 
-        # Check if the exception should be ignored by the handler
-        if self.__exception_handler.shouldIgnoreException(e):
-            return
-
-        # Report the exception using the application's exception handler and logger
-        self.__exception_handler.report(
-            exception=e,
-            log=self.__logger
-        )
-
-        # If a kernel is provided, render the exception details to the CLI
-        if isinstance(kernel, KernelCLI) or isinstance(kernel, Schedule):
-            return self.__exception_handler.renderCLI(
-                request=request,
-                exception=e,
-                log=self.__logger,
-                console=self.__console
-            )
+        async def handle():
+            """
+            Handles exceptions asynchronously using the provided exception handler.
+
+            This method performs the following steps:
+            1. Determines if the exception should be ignored by invoking the `shouldIgnoreException` method
+               of the exception handler. This method supports both coroutine and regular functions.
+            2. Reports the exception using the `report` method of the exception handler. This method
+               also supports both coroutine and regular functions.
+            3. If the kernel is of type `KernelCLI` or `Any`, it attempts to render the exception
+               for the CLI using the `renderCLI` method of the exception handler. This method supports
+               both coroutine and regular functions.
+
+            Parameters
+            ----------
+            None
+
+            Returns
+            -------
+            Any or None
+            The result of the `renderCLI` method if applicable, otherwise `None`.
+
+            Notes
+            -----
+            - The `self.__exception_handler` is expected to have the methods `shouldIgnoreException`,
+              `report`, and `renderCLI`.
+            - The `self.__logger` is passed to the `report` and `renderCLI` methods for logging purposes.
+            - The `self.__console` is passed to the `renderCLI` method for CLI rendering.
+            """
+
+            # Check if the `shouldIgnoreException` method is a coroutine function
+            if asyncio.iscoroutinefunction(self.__exception_handler.shouldIgnoreException):
+
+                # If it is, await its result to determine if the exception should be ignored
+                if await self.__exception_handler.shouldIgnoreException(e):
+                    return
+
+            else:
+
+                # If it is not a coroutine, call it directly
+                if self.__exception_handler.shouldIgnoreException(e):
+                    return
+
+            # Check if the `report` method is a coroutine function
+            if asyncio.iscoroutinefunction(self.__exception_handler.report):
+
+                # If it is, await its execution to report the exception
+                await self.__exception_handler.report(
+                    exception=e,
+                    log=self.__logger
+                )
+
+            else:
+
+                # If it is not a coroutine, call it directly
+                self.__exception_handler.report(
+                    exception=e,
+                    log=self.__logger
+                )
+
+            # Check if the kernel is of type `KernelCLI` or `Any`
+            if isinstance(kernel, KernelCLI) or isinstance(kernel, Any):
+
+                # Check if the `renderCLI` method is a coroutine function
+                if asyncio.iscoroutinefunction(self.__exception_handler.renderCLI):
+
+                    # If it is, await its execution to render the exception for the CLI
+                    return await self.__exception_handler.renderCLI(
+                        request=request,
+                        exception=e,
+                        log=self.__logger,
+                        console=self.__console
+                    )
+
+                else:
+
+                    # If it is not a coroutine, call it directly
+                    return self.__exception_handler.renderCLI(
+                        request=request,
+                        exception=e,
+                        log=self.__logger,
+                        console=self.__console
+                    )
+
+        # Run the handler
+        asyncio.run(handle())

orionis/failure/contracts/handler.py

@@ -7,7 +7,7 @@ from orionis.services.log.contracts.log_service import ILogger
 class IBaseExceptionHandler:
 
     @abstractmethod
-    def destructureException(self, e: BaseException):
+    async def destructureException(self, e: BaseException):
         """
         Converts an exception into a structured `Throwable` object containing detailed information.
 
@@ -29,7 +29,7 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    def shouldIgnoreException(self, e: BaseException) -> bool:
+    async def shouldIgnoreException(self, e: BaseException) -> bool:
         """
         Determines if the exception should be ignored (not handled) by the handler.
 
@@ -46,7 +46,7 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    def report (self, exception: BaseException, log: ILogger) -> Any:
+    async def report (self, exception: BaseException, log: ILogger) -> Any:
         """
         Report or log an exception.
 
@@ -62,7 +62,7 @@ class IBaseExceptionHandler:
         pass
 
     @abstractmethod
-    def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
+    async def renderCLI(self, request: CLIRequest, exception: BaseException, log: ILogger, console: IConsole) -> Any:
         """
         Render the exception message for CLI output.
 

orionis/metadata/framework.py

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

{orionis-0.531.0.dist-info → orionis-0.533.0.dist-info}/METADATA

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

{orionis-0.531.0.dist-info → orionis-0.533.0.dist-info}/RECORD

@@ -13,6 +13,7 @@ orionis/console/base/scheduler_event_listener.py,sha256=tmdAMPzTmT8z0BcpyoIZwyTR
 orionis/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/commands/cache.py,sha256=8DsYoRzSBLn0P9qkGVItRbo0R6snWBDBg0_Xa7tmVhs,2322
 orionis/console/commands/help.py,sha256=zfSw0pYaOnFN-_Ozdn4veBQDYMgSSDY10nPDCi-7tTY,3199
+orionis/console/commands/make_listener.py,sha256=iPOMCc41njwUKurxSwatZUTjpp-bBLdO9nN-w2FJ4mI,1921
 orionis/console/commands/publisher.py,sha256=FUg-EUzK7LLXsla10ZUZro8V0Z5S-KjmsaSdRHSSGbA,21381
 orionis/console/commands/scheduler_list.py,sha256=A2N_mEXEJDHO8DX2TDrL1ROeeRhFSkWD3rCw64Hrf0o,4763
 orionis/console/commands/scheduler_work.py,sha256=mzSFes8Wl1gCf253tNYClij0abT5HlpW1QZVFrU5EXo,6445
@@ -28,7 +29,7 @@ orionis/console/contracts/schedule.py,sha256=17cfPYtLo-jqF8FxYOhh4epJZnxw5mMPuLG
 orionis/console/contracts/schedule_event_listener.py,sha256=7fQdPh6X_npfGpQW_2x81D7-5Pe40jIog9uDeEU0kro,4390
 orionis/console/contracts/scheduler.py,sha256=OW-a_YDDNPrenYT9z8Tv71VjyZ1aSzqzqhTBhTCZhGM,7698
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=AG2i38YRTHSRG-eO2lNCy9P-Qfll297EvxYHCT_wvV0,30512
+orionis/console/core/reactor.py,sha256=cUYZwOyWjKai885peSaRRu3vM0IpWxskCNyl9IangHs,30626
 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
@@ -116,12 +117,12 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/failure/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/catch.py,sha256=Tk2IE6lpt2n3jHn4--3U-QLyDrBIwUnNnKi7ZRmGnOg,3715
+orionis/failure/catch.py,sha256=ZmSVcrCMccLwJXWTYOT6IX_Bx-1_qhy8Ekkf5rcMWb0,6648
 orionis/failure/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/failure/base/handler.py,sha256=L6jB2_2f8ZKBuys8o_iXTwMM_yjQHY7iXNF1Q3X8BGY,4661
+orionis/failure/base/handler.py,sha256=a7fQJMWVjALwFiITRsMYg3s7WSO6zcbmq171iQRWy48,4867
 orionis/failure/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/contracts/catch.py,sha256=e2wM1p6VxbvAjgWm-MwoM9p2ystSsyBu8Qnt6Ehr6Vc,1179
-orionis/failure/contracts/handler.py,sha256=4N9yMkMgdhtHbRGAyCtuTx3GmkPP74vhqdRLmwl-ckQ,2216
+orionis/failure/contracts/handler.py,sha256=drNE8iu8RUHi3TgKn-lUEIfVsZeGsMTUecTZOfay19E,2240
 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
@@ -241,7 +242,7 @@ 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=5Up2-YWMRMMui3nVYJBNvG81pm5vlb0awntbaIiHh8A,4109
+orionis/metadata/framework.py,sha256=MR1CweBMS0GVoynVQvHVgX_Q57Tui2yvVfL-crXSC8M,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
@@ -419,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.531.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.533.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
@@ -565,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.531.0.dist-info/METADATA,sha256=zfe49sBuT8RAIkEbWnNODcJ-k9987ERhWzcrBlJ0Vc4,4801
-orionis-0.531.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.531.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.531.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.531.0.dist-info/RECORD,,
+orionis-0.533.0.dist-info/METADATA,sha256=l1kdd7oMiNJrpGuVKP_I66xljMNosyOPn-mNVBFcHIg,4801
+orionis-0.533.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.533.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.533.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.533.0.dist-info/RECORD,,