orionis 0.488.0__py3-none-any.whl → 0.489.0__py3-none-any.whl

orionis/console/base/contracts/scheduler.py

@@ -0,0 +1,38 @@
+from abc import ABC, abstractmethod
+from datetime import datetime
+from orionis.console.contracts.schedule import ISchedule
+
+class IBaseScheduler(ABC):
+
+    # Pause Global Scheduler at a specific time
+    PAUSE_AT: datetime = None
+
+    # Resume Global Scheduler at a specific time
+    RESUME_AT: datetime = None
+
+    # Finalize Global Scheduler at a specific time
+    FINALIZE_AT: datetime = None
+
+    @abstractmethod
+    def tasks(self, schedule: ISchedule):
+        """
+        Defines and registers scheduled tasks for the application.
+
+        Parameters
+        ----------
+        schedule : ISchedule
+            The schedule object used to define and register scheduled commands.
+
+        Returns
+        -------
+        None
+            This method does not return any value. It is intended to be overridden
+            by subclasses to specify scheduled tasks.
+
+        Notes
+        -----
+        This method should be implemented in subclasses to add specific tasks
+        to the scheduler using the provided `schedule` object.
+        """
+        # This method should be overridden in subclasses to define scheduled tasks.
+        pass

orionis/console/base/scheduler.py

@@ -1,7 +1,8 @@
 from datetime import datetime
+from orionis.console.base.contracts.scheduler import IBaseScheduler
 from orionis.console.contracts.schedule import ISchedule
 
-class BaseScheduler:
+class BaseScheduler(IBaseScheduler):
 
     # Pause Global Scheduler at a specific time
     PAUSE_AT: datetime = None
@@ -29,28 +30,97 @@ class BaseScheduler:
 
         Notes
         -----
-        This method should be implemented in subclasses to add specific tasks
-        to the scheduler using the provided `schedule` object.
+        Subclasses should implement this method to add specific tasks to the scheduler
+        using the provided `schedule` object. This method enforces that each subclass
+        defines its own scheduled tasks.
         """
-        # This method should be overridden in subclasses to define scheduled tasks.
-        pass
+        # Raise an error to enforce implementation in subclasses
+        raise NotImplementedError("The 'tasks' method must be implemented in the subclass.")
 
     def onStarted(self):
-        # Called when the scheduler is started.
+        """
+        Called when the scheduler is started.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Intended to be overridden by subclasses to implement custom behavior that should
+        occur when the scheduler starts running.
+        """
+        # Placeholder for logic to execute when the scheduler starts
         pass
 
     def onPaused(self):
-        # Called when the scheduler is paused.
+        """
+        Called when the scheduler is paused.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Should be overridden to define custom behavior that occurs when the scheduler
+        enters a paused state.
+        """
+        # Placeholder for logic to execute when the scheduler is paused
         pass
 
     def onResumed(self):
-        # Called when the scheduler is resumed.
+        """
+        Called when the scheduler is resumed from a paused state.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Should be overridden to implement any actions that need to occur when the
+        scheduler resumes operation.
+        """
+        # Placeholder for logic to execute when the scheduler is resumed
         pass
 
     def onFinalized(self):
-        # Called when the scheduler is finalized.
+        """
+        Called when the scheduler has completed its execution and is being finalized.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Can be overridden to perform any necessary cleanup or finalization tasks.
+        """
+        # Placeholder for logic to execute when the scheduler is finalized
         pass
 
     def onError(self, error: Exception):
-        # Called when an error occurs in the scheduler.
+        """
+        Handles errors that occur within the scheduler.
+
+        Parameters
+        ----------
+        error : Exception
+            The exception instance representing the error that occurred.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Notes
+        -----
+        Can be overridden to implement custom error handling logic for the scheduler.
+        """
+        # Placeholder for logic to handle errors in the scheduler
         pass

orionis/console/commands/help.py

@@ -40,7 +40,8 @@ class HelpCommand(BaseCommand):
         try:
 
             # Retrieve the list of available commands from the reactor
-            commands = reactor.info()  # List of dicts with 'signature' and 'description'
+            # List of dicts with 'signature' and 'description'
+            commands = reactor.info()
 
             # Initialize the rich console for formatted output
             console = Console()

orionis/console/commands/scheduler_list.py

@@ -1,6 +1,3 @@
-import importlib
-import os
-from pathlib import Path
 from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
@@ -88,7 +85,7 @@ class ScheduleListCommand(BaseCommand):
             table.add_column("Signature", style="cyan", no_wrap=True)
             table.add_column("Arguments", style="magenta")
             table.add_column("Purpose", style="green")
-            table.add_column("Random Delay", style="yellow")
+            table.add_column("Random Delay (calculated result)", style="yellow")
             table.add_column("Start Date", style="white")
             table.add_column("End Date", style="white")
             table.add_column("Details", style="dim")
@@ -112,6 +109,7 @@ class ScheduleListCommand(BaseCommand):
             return True
 
         except Exception as exc:
+
             # Catch any unexpected exceptions and raise as a CLIOrionisRuntimeError
             raise CLIOrionisRuntimeError(
                 f"An unexpected error occurred while listing the scheduled jobs: {exc}"

orionis/console/commands/scheduler_work.py

@@ -102,6 +102,7 @@ class ScheduleWorkCommand(BaseCommand):
             return True
 
         except Exception as exc:
+
             # Raise any unexpected exceptions as CLIOrionisRuntimeError
             raise CLIOrionisRuntimeError(
                 f"An unexpected error occurred while starting the scheduler worker: {exc}"

orionis/console/contracts/listener.py

@@ -0,0 +1,132 @@
+from abc import ABC, abstractmethod
+
+class IEventListener(ABC):
+    """
+    Interface for event listeners that handle various stages of event processing.
+    """
+
+    @abstractmethod
+    def before(self, event):
+        """
+        Hook method called before the main event handling logic.
+
+        Parameters
+        ----------
+        event : object
+            The event object that is about to be processed.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to implement logic that should run before the event is handled.
+        """
+        pass
+
+    @abstractmethod
+    def after(self, event):
+        """
+        Hook method called after an event is processed.
+
+        Parameters
+        ----------
+        event : object
+            The event object that was processed.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to implement logic that should run after the event is handled.
+        """
+        pass
+
+    @abstractmethod
+    def onSuccess(self, event):
+        """
+        Handle actions to be performed when an event is successfully processed.
+
+        Parameters
+        ----------
+        event : object
+            The event object that triggered the success callback.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to define actions on successful event processing.
+        """
+        pass
+
+    @abstractmethod
+    def onFailure(self, event):
+        """
+        Handle the event when a failure occurs during event processing.
+
+        Parameters
+        ----------
+        event : object
+            The event object containing information about the failure.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to define actions when event processing fails.
+        """
+        pass
+
+    @abstractmethod
+    def onMissed(self, event):
+        """
+        Handle the event when an expected event is missed.
+
+        Parameters
+        ----------
+        event : object
+            The event object that was missed.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to define actions when an event is missed.
+        """
+        pass
+
+    @abstractmethod
+    def onMaxInstances(self, event):
+        """
+        Handles the event triggered when the maximum number of instances is reached.
+
+        Parameters
+        ----------
+        event : object
+            The event object containing information about the max instances event.
+
+        Returns
+        -------
+        None
+            This method does not return anything.
+
+        Notes
+        -----
+        Override this method to define actions when the maximum number of instances is reached.
+        """
+        pass

orionis/console/core/reactor.py

@@ -1,7 +1,6 @@
 import argparse
 import os
 import re
-from pathlib import Path
 from typing import Any, List, Optional
 from orionis.console.args.argument import CLIArgument
 from orionis.console.base.command import BaseCommand
@@ -9,8 +8,10 @@ from orionis.console.base.contracts.command import IBaseCommand
 from orionis.console.contracts.reactor import IReactor
 from orionis.console.enums.command import Command
 from orionis.console.exceptions import CLIOrionisValueError
+from orionis.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
 from orionis.console.output.contracts.console import IConsole
 from orionis.console.output.contracts.executor import IExecutor
+from orionis.container.exceptions.exception import OrionisContainerException
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.introspection.modules.reflection import ReflectionModule
 from orionis.services.log.contracts.log_service import ILogger
@@ -58,13 +59,13 @@ class Reactor(IReactor):
         self.__app = app
 
         # Set the project root directory to current working directory for module path resolution
-        self.__root = self.__app.path('root') or Path().cwd()
+        self.__root = self.__app.path('root')
 
         # Initialize the internal command registry as an empty dictionary
         self.__commands: dict[str, Command] = {}
 
         # Automatically discover and load command classes from the console commands directory
-        self.__loadCommands(str(self.__app.path('commands')), self.__root)
+        self.__loadCommands(self.__app.path('commands'), self.__root)
 
         # Load core command classes provided by the Orionis framework
         self.__loadCoreCommands()
@@ -581,8 +582,12 @@ class Reactor(IReactor):
             return output
 
         except Exception as e:
+
             # Display the error message in the console (without timestamp)
-            self.__console.error(f"An error occurred while executing command '{signature}': {e}", timestamp=False)
+            if isinstance(e, OrionisContainerException):
+                pass
+            elif isinstance(e, CLIOrionisRuntimeError):
+                self.__console.error(f"An error occurred while executing command '{signature}': {e}", timestamp=False)
 
             # Log the error in the logger service
             self.__logger.error(f"Command '{signature}' execution failed: {e}")

orionis/console/entities/request.py

@@ -0,0 +1,35 @@
+from dataclasses import dataclass, field
+from orionis.support.entities.base import BaseEntity
+
+@dataclass(kw_only=True)
+class CLIRequest(BaseEntity):
+    """
+    Represents a command-line interface (CLI) request.
+
+    Parameters
+    ----------
+    command : str
+        The command to be executed by the CLI.
+    args : list of str, optional
+        A list of arguments passed to the command. Defaults to an empty list.
+
+    Returns
+    -------
+    CLIRequest
+        An instance of the CLIRequest class encapsulating the command and its arguments.
+
+    Attributes
+    ----------
+    command : str
+        The command to be executed.
+    args : list of str
+        The arguments associated with the command.
+    """
+
+    # The command to execute
+    command: str
+
+    # Arguments for the command; defaults to an empty list if not provided
+    args: list[str] = field(
+        default_factory=list
+    )

orionis/console/kernel.py

@@ -1,9 +1,11 @@
+import sys
+from typing import List
 from orionis.console.contracts.kernel import IKernelCLI
 from orionis.console.contracts.reactor import IReactor
-from orionis.console.output.contracts.console import IConsole
+from orionis.console.entities.request import CLIRequest
+from orionis.failure.contracts.catch import ICatch
 from orionis.foundation.contracts.application import IApplication
 from orionis.console.exceptions import CLIOrionisValueError
-from orionis.services.log.contracts.log_service import ILogger
 
 class KernelCLI(IKernelCLI):
 
@@ -40,13 +42,10 @@ class KernelCLI(IKernelCLI):
         # The reactor is responsible for dispatching CLI commands.
         self.__reactor: IReactor = app.make('x-orionis.console.core.reactor')
 
-        # Retrieve and initialize the console instance for command output and error handling.
-        self.__console: IConsole = app.make('x-orionis.console.output.console')
+        # Retrieve and initialize the catch instance from the application container.
+        self.__catch: ICatch = app.make('x-orionis.failure.catch')
 
-        # Initialize the logger service for logging command execution details
-        self.__logger: ILogger = app.make('x-orionis.services.log.log_service')
-
-    def handle(self, args: list) -> None:
+    def handle(self, args: List[str] = []) -> None:
         """
         Processes and dispatches command line arguments to the appropriate command handler.
 
@@ -89,21 +88,23 @@ class KernelCLI(IKernelCLI):
             if len(args) == 1:
                 return self.__reactor.call(args[0])
 
-            # If command and arguments are provided, call the command with its arguments
-            return self.__reactor.call(args[0], args[1:])
-
-        except SystemExit as e:
-
-            # Log the SystemExit exception for debugging purposes
-            self.__logger.error(f"SystemExit encountered: {str(e)}")
+            # Create a CLIRequest instance with the command and its arguments
+            command = CLIRequest(
+                command=args[0],
+                args=args[1:]
+            )
 
-            # Handle SystemExit exceptions gracefully, allowing for clean exits with error messages
-            self.__console.exitError(str(e))
+            # If command and arguments are provided, call the command with its arguments
+            return self.__reactor.call(
+                command.command,
+                command.args
+            )
 
-        except Exception as e:
+        except BaseException as e:
 
-            # Log any unexpected exceptions that occur during command processing
-            self.__logger.error(f"An unexpected error occurred while processing command: {str(e)}")
+            # Catch any exceptions that occur during command handling
+            self.__catch.report(e)
+            self.__catch.renderCLI(args, e)
 
-            # Handle any other exceptions that may occur during command processing
-            self.__console.exitError(f"An unexpected error occurred: {str(e)}")
+            # Exit the process with a non-zero status code to indicate an error
+            sys.exit(1)

orionis/console/output/console.py

@@ -4,7 +4,6 @@ import os
 import sys
 from orionis.console.output.enums import ANSIColors
 from orionis.console.output.contracts.console import IConsole
-from orionis.support.formatter.serializer import Parser
 
 class Console(IConsole):
     """
@@ -512,31 +511,12 @@ class Console(IConsole):
         -----
         This method prints the exception type, message, and a detailed stack trace.
         """
+        from rich.console import Console as RichConsole
+        from rich.traceback import Traceback
 
-        errors = Parser.exception(e).toDict()
-        error_type = str(errors.get("error_type")).split(".")[-1]
-        error_message = str(errors.get("error_message")).replace(error_type, "").replace("[]", "").strip()
-        stack_trace = errors.get("stack_trace")
-
-        # Format the output with a more eye-catching appearance
-        message = f"{ANSIColors.BG_ERROR.value}{ANSIColors.TEXT_WHITE.value}[{error_type}]{ANSIColors.TEXT_RESET.value}: {ANSIColors.TEXT_WARNING.value}{error_message}{ANSIColors.TEXT_RESET.value}"
-        print("▬" * len(f" [{error_type}] : {error_message}"))
-        print(message)
-
-        real_count = len(stack_trace)
-        count_error = real_count
-        for frame in stack_trace:
-            filename = frame["filename"]
-            lineno = frame["lineno"]
-            name = frame["name"]
-            line = frame["line"]
-
-            # Print the stack trace with enhanced styling
-            print(f"{ANSIColors.TEXT_MUTED.value}Trace Call ({count_error}/{real_count}){ANSIColors.TEXT_RESET.value} - {ANSIColors.TEXT_WHITE.value}{filename}:{lineno}{ANSIColors.TEXT_RESET.value}")
-            print(f"  {ANSIColors.DIM.value}{ANSIColors.ITALIC.value}{ANSIColors.TEXT_WARNING.value}{name}{ANSIColors.TEXT_RESET.value} : {ANSIColors.CYAN.value}{line}{ANSIColors.TEXT_RESET.value}")
-            count_error -= 1
-
-        print("▬" * len(f" [{error_type}] : {error_message}"))
+        rc = RichConsole()
+        rc.print("[bold red]❌ Exception caught in method[/]")
+        rc.print(Traceback.from_exception(type(e), e, e.__traceback__))
 
     def exitSuccess(self, message: str = None) -> None:
         """

orionis/console/tasks/event.py

@@ -5,7 +5,7 @@ from apscheduler.triggers.cron import CronTrigger
 from apscheduler.triggers.date import DateTrigger
 from apscheduler.triggers.interval import IntervalTrigger
 from orionis.console.contracts.event import IEvent
-from orionis.console.contracts.event_listener import IEventListener
+from orionis.console.contracts.listener import IEventListener
 from orionis.console.enums.event import Event as EventEntity
 from orionis.console.exceptions import CLIOrionisValueError
 

orionis/failure/catch.py

@@ -0,0 +1,148 @@
+from typing import Any, List
+from orionis.console.output.contracts.console import IConsole
+from orionis.failure.contracts.catch import ICatch
+from orionis.failure.entities.throwable import Throwable
+from orionis.foundation.contracts.application import IApplication
+from orionis.services.log.contracts.log_service import ILogger
+
+class Catch(ICatch):
+
+    def __init__(self, app: IApplication) -> None:
+        """
+        Initializes the Catch handler with application services for console output and logging.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application instance used to resolve required services.
+
+        Attributes
+        ----------
+        console : IConsole
+            Console output service obtained from the application for displaying messages and exceptions.
+        logger : ILogger
+            Logger service obtained from the application for logging errors and exceptions.
+
+        Returns
+        -------
+        None
+            This constructor does not return any value.
+
+        Notes
+        -----
+        The constructor retrieves the console and logger services from the application container
+        using their respective service keys. These services are used throughout the class for
+        error reporting and output.
+        """
+
+        # Retrieve the console output service from the application container
+        self.console: IConsole = app.make('x-orionis.console.output.console')
+
+        # Retrieve the logger service from the application container
+        self.logger: ILogger = app.make('x-orionis.services.log.log_service')
+
+    def destructureException(self, e: BaseException) -> Throwable:
+        """
+        Converts an exception into a structured `Throwable` object containing detailed information.
+
+        Parameters
+        ----------
+        e : BaseException
+            The exception instance to be destructured.
+
+        Returns
+        -------
+        Throwable
+            A `Throwable` object encapsulating the exception's class type, message, arguments, and traceback.
+
+        Notes
+        -----
+        This method extracts the type, message, arguments, and traceback from the provided exception
+        and wraps them in a `Throwable` object for consistent error handling and reporting.
+        """
+
+        # Create and return a Throwable object with detailed exception information
+        return Throwable(
+            classtype=type(e),                              # The class/type of the exception
+            message=str(e),                                 # The exception message as a string
+            args=e.args,                                    # The arguments passed to the exception
+            traceback=getattr(e, '__traceback__', None)     # The traceback object, if available
+        )
+
+    def report(self, exception: BaseException) -> Any:
+        """
+        Logs and returns a destructured representation of an exception.
+
+        Parameters
+        ----------
+        exception : BaseException
+            The exception instance to be reported.
+
+        Returns
+        -------
+        Throwable
+            A destructured representation of the exception, containing its type, message, arguments, and traceback.
+
+        Raises
+        ------
+        TypeError
+            If the provided exception is not an instance of BaseException.
+
+        Notes
+        -----
+        This method logs the exception details using the configured logger and returns a structured
+        representation of the exception for further processing.
+        """
+
+        # Ensure the provided object is an exception
+        if not isinstance(exception, BaseException):
+            raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
+
+        # Convert the exception into a structured Throwable object
+        throwable = self.destructureException(exception)
+
+        # Log the exception details
+        self.logger.error(f"[{throwable.classtype.__name__}] {throwable.message}")
+
+        # Return the structured exception
+        return throwable
+
+    def renderCLI(self, args: List[str], exception: BaseException) -> Any:
+        """
+        Renders a CLI-friendly error message for a given exception.
+
+        Parameters
+        ----------
+        args : list
+            The list of command-line arguments that were passed to the CLI.
+        exception : BaseException
+            The exception instance to be rendered.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Raises
+        ------
+        TypeError
+            If the provided exception is not an instance of BaseException.
+
+        Notes
+        -----
+        This method logs the error message using the configured logger and outputs
+        the exception traceback to the console for user visibility.
+        """
+
+        # Ensure the provided object is an exception
+        if not isinstance(exception, BaseException):
+            raise TypeError(f"Expected BaseException, got {type(exception).__name__}")
+
+        # Convert the exception into a structured Throwable object
+        throwable = self.destructureException(exception)
+
+        # Log the CLI error message with arguments
+        self.logger.error(f"CLI Error: {throwable.message} (Args: {args})")
+
+        # Output the exception traceback to the console
+        self.console.exception(exception)

orionis/failure/contracts/catch.py

@@ -0,0 +1,91 @@
+from abc import ABC, abstractmethod
+from typing import Any, List
+from orionis.foundation.contracts.application import IApplication
+
+class ICatch(ABC):
+
+    @abstractmethod
+    def __init__(self, app: IApplication) -> None:
+        """
+        Initializes the Catch handler with application services for console output and logging.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application instance used to resolve required services.
+
+        Attributes
+        ----------
+        console : IConsole
+            Console output service obtained from the application for displaying messages and exceptions.
+        logger : ILogger
+            Logger service obtained from the application for logging errors and exceptions.
+
+        Returns
+        -------
+        None
+            This constructor does not return any value.
+
+        Notes
+        -----
+        The constructor retrieves the console and logger services from the application container
+        using their respective service keys. These services are used throughout the class for
+        error reporting and output.
+        """
+        pass
+
+    @abstractmethod
+    def report(self, exception: BaseException) -> Any:
+        """
+        Logs and returns a destructured representation of an exception.
+
+        Parameters
+        ----------
+        exception : BaseException
+            The exception instance to be reported.
+
+        Returns
+        -------
+        Throwable
+            A destructured representation of the exception, containing its type, message, arguments, and traceback.
+
+        Raises
+        ------
+        TypeError
+            If the provided exception is not an instance of BaseException.
+
+        Notes
+        -----
+        This method logs the exception details using the configured logger and returns a structured
+        representation of the exception for further processing.
+        """
+        pass
+
+    @abstractmethod
+    def renderCLI(self, args: List[str], exception: BaseException) -> Any:
+        """
+        Renders a CLI-friendly error message for a given exception.
+
+        Parameters
+        ----------
+        args : list
+            The list of command-line arguments that were passed to the CLI.
+        exception : BaseException
+            The exception instance to be rendered.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+
+        Raises
+        ------
+        TypeError
+            If the provided exception is not an instance of BaseException.
+
+        Notes
+        -----
+        This method logs the error message using the configured logger and outputs
+        the exception traceback to the console for user visibility.
+        """
+        pass

orionis/failure/entities/throwable.py

@@ -0,0 +1,33 @@
+from dataclasses import dataclass
+
+@dataclass(kw_only=True)
+class Throwable:
+    """
+    Represents a throwable entity (such as an exception or error) within the framework.
+
+    Parameters
+    ----------
+    classtype : type
+        The class type of the throwable, typically an exception class.
+    message : str
+        The error message describing the throwable.
+    args : tuple
+        Arguments passed to the throwable, usually corresponding to the exception arguments.
+    traceback : str, optional
+        The traceback information as a string, if available. Defaults to None.
+
+    Returns
+    -------
+    Throwable
+        An instance of the Throwable dataclass encapsulating exception details.
+
+    Notes
+    -----
+    This class is used to standardize the representation of exceptions and errors
+    throughout the framework, making error handling and logging more consistent.
+    """
+
+    classtype: type          # The type of the throwable (e.g., Exception class)
+    message: str             # The error message associated with the throwable
+    args: tuple              # Arguments passed to the throwable
+    traceback: str = None    # Optional traceback information as a string

orionis/foundation/application.py

@@ -186,6 +186,7 @@ class Application(Container, IApplication):
         from orionis.foundation.providers.reactor_provider import ReactorProvider
         from orionis.foundation.providers.performance_counter_provider import PerformanceCounterProvider
         from orionis.foundation.providers.scheduler_provider import ScheduleProvider
+        from orionis.foundation.providers.catch_provider import CathcProvider
 
         # Core framework providers
         core_providers = [
@@ -199,7 +200,8 @@ class Application(Container, IApplication):
             ConsoleExecuteProvider,
             ReactorProvider,
             PerformanceCounterProvider,
-            ScheduleProvider
+            ScheduleProvider,
+            CathcProvider
         ]
 
         # Register each core provider

orionis/foundation/providers/catch_provider.py

@@ -0,0 +1,49 @@
+from orionis.container.providers.service_provider import ServiceProvider
+from orionis.failure.catch import Catch
+from orionis.failure.contracts.catch import ICatch
+
+class CathcProvider(ServiceProvider):
+    """
+    Provides and registers the Catch service within the application container.
+
+    This service provider is responsible for binding the ICatch interface to its concrete
+    implementation, Catch, as a singleton. By doing so, it ensures that a single shared
+    instance of Catch is available for dependency injection throughout the application.
+
+    Returns
+    -------
+    None
+        This class does not return a value; it is used for service registration.
+    """
+
+    def register(self) -> None:
+        """
+        Register the Catch service as a singleton in the application container.
+
+        This method binds the ICatch interface to the Catch implementation with an alias,
+        ensuring that only one instance of Catch is created and shared.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+
+        # Bind ICatch to Catch as a singleton with a specific alias
+        self.app.singleton(ICatch, Catch, alias="x-orionis.failure.catch")
+
+    def boot(self) -> None:
+        """
+        Perform any actions required after all providers have been registered.
+
+        This method is called after the register phase and can be used to perform
+        additional initialization if needed.
+
+        Returns
+        -------
+        None
+            This method does not return any value.
+        """
+
+        # No additional boot logic required for this provider
+        pass

orionis/metadata/framework.py

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

{orionis-0.488.0.dist-info → orionis-0.489.0.dist-info}/METADATA

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

{orionis-0.488.0.dist-info → orionis-0.489.0.dist-info}/RECORD

@@ -1,33 +1,34 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/app.py,sha256=b69fOzj2J8Aw5g0IldWZXixUDeeTO9vcHc_Njses9HU,603
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/kernel.py,sha256=9BmGVvqWMTjyINHl5Q-oBjYT6Kmiw_EKKUkEKh5Z9N4,4487
+orionis/console/kernel.py,sha256=xye5-uiz1Se_XOxleOv9gE-iQ0aqfEMoVKaoBiiStx0,4180
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/args/argument.py,sha256=Is8Z8_kW4DvcK1nK1UU-sa6Pk0BeOdcRczCayW0ZVHc,20360
 orionis/console/args/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/args/enums/actions.py,sha256=S3T-vWS6DJSGtANrq3od3-90iYAjPvJwaOZ2V02y34c,1222
 orionis/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/command.py,sha256=nasVPyKEvuv8sDFEWXhHyBCWAmSLfPPm2XlKaYYt_pM,6642
-orionis/console/base/scheduler.py,sha256=_wFjQ6xo2lBgIiydm-g2SXe0sBAuIRMu5ZvKmokunDU,1601
+orionis/console/base/scheduler.py,sha256=dy8qQrUbKB6Uko1gtr3JzZaSd1iaOm-A8hUhbmFHvD4,3724
 orionis/console/base/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/contracts/command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
+orionis/console/base/contracts/scheduler.py,sha256=y8q4qv6oxjnWSt9G0HP2IjogtWIASfJaMO5vkG22U1Q,1184
 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=ooPoenP08ArMAWiL89_oUGD9l1Faen2QjLTG90i4zCQ,3187
+orionis/console/commands/help.py,sha256=zfSw0pYaOnFN-_Ozdn4veBQDYMgSSDY10nPDCi-7tTY,3199
 orionis/console/commands/publisher.py,sha256=FUg-EUzK7LLXsla10ZUZro8V0Z5S-KjmsaSdRHSSGbA,21381
-orionis/console/commands/scheduler_list.py,sha256=-SSxLG7In0gfCpTjaFG1_j-GkcHChXlC6jFQyX2EKW4,4851
-orionis/console/commands/scheduler_work.py,sha256=BV9Fev13S479j6nz6XA3Uh2z3At-Y3277Pn4pSBC6Nc,4315
+orionis/console/commands/scheduler_list.py,sha256=p6bCqsrftDrHaYwDxtWDLpsf8LJ4kCVFMnCVkyP7hW0,4818
+orionis/console/commands/scheduler_work.py,sha256=LsFiZXIzAjJpBKAHuD2uC-FzT7Rmi_nkw7pC6p35478,4317
 orionis/console/commands/test.py,sha256=-EmQwFwMBuby3OI9HwqMIwuJzd2CGbWbOqmwrR25sOE,2402
 orionis/console/commands/version.py,sha256=SUuNDJ40f2uq69OQUmPQXJKaa9Bm_iVRDPmBd7zc1Yc,3658
 orionis/console/commands/workflow.py,sha256=NYOmjTSvm2o6AE4h9LSTZMFSYPQreNmEJtronyOxaYk,2451
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/event.py,sha256=pxoxNjk31bt6yGvUFRTo_TI_SaZZar6iSIJARWR6KbM,5170
-orionis/console/contracts/event_listener.py,sha256=88UKH20bcwHlJh61O_qXKqUD9qe0jMQVXXZdlwMkc2s,482
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
+orionis/console/contracts/listener.py,sha256=tXp2kTVEaqLRWZC6BY8xqj3JP0xpDDx4btPy3wnr8cM,3251
 orionis/console/contracts/reactor.py,sha256=Xeq7Zrw6WE5MV_XOQfiQEchAFbb6-0TjLpjWOxYW--g,4554
 orionis/console/contracts/schedule.py,sha256=eGjcOH7kgdf0fWDZRfOFUQsIx4E8G38ayX5JwpkpN8E,4977
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=wT0osBlPRMqseRG0UGqwt2t1nezPR8tnUhU4sXvYUzY,30342
+orionis/console/core/reactor.py,sha256=Lwk6u0lO1n-E74Kyiw0xYwFMbQoJn7uszGoN9RNHS-c,30597
 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
@@ -38,6 +39,7 @@ orionis/console/dynamic/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeR
 orionis/console/dynamic/contracts/progress_bar.py,sha256=NYebL2h-vg2t2H6IhJjuC37gglRkpT-MW71wbJtpLNg,1784
 orionis/console/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/entities/listeners.py,sha256=I5JbbnwKz-ZQhQgS2r1wqfUTwagg8Os6qzfEY8FzVzg,5345
+orionis/console/entities/request.py,sha256=5FikL80Ks99Ut4AlfKpyXIKVMZQUtYqvfCFn80lPZdc,936
 orionis/console/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/enums/command.py,sha256=lCfVp2vnDojJN2gjdVxE_XU3mRjZZgOIxPfBVQYo9w4,1278
 orionis/console/enums/event.py,sha256=XRV7N14N5HHt-c0HqYhrbKv4n2P7ZOCcBT_3OAQzenU,1929
@@ -47,7 +49,7 @@ orionis/console/exceptions/cli_orionis_value_error.py,sha256=RQP0HRwxDG8hxFOT1kU
 orionis/console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
 orionis/console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
 orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/output/console.py,sha256=AY2J2TT9Wp5JjuGikl8J2A0Zzbj3FF7JZREc9z9nC9c,19162
+orionis/console/output/console.py,sha256=AoVmoRDkfnE3_zyQi6TP43Q-Lfn_r1aNzr_llkCpfBs,17929
 orionis/console/output/executor.py,sha256=9A8lCSU9DEVKhMsQLwBhFKW44Mz7KP-ig-o-4Vm-EcU,7328
 orionis/console/output/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/output/contracts/console.py,sha256=phaQhCLWa81MLzB5ydOSaUfEIdDq7fOjvym8Rmi-arc,11908
@@ -55,7 +57,7 @@ orionis/console/output/contracts/executor.py,sha256=7l3kwnvv6GlH9EYk0v94YE1olex_
 orionis/console/output/enums/__init__.py,sha256=LAaAxg-DpArCjf_jqZ0_9s3p8899gntDYkSU_ppTdC8,66
 orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/event.py,sha256=6XHUKm5N-vXoj9m0zKl_PlpbA_6jkxq3ILJY4Ys8eUM,12210
+orionis/console/tasks/event.py,sha256=NcSmq3y4JWviXaSvRifmJs0nWqQQgHIDmzlWELrLeNU,12204
 orionis/console/tasks/exception_report.py,sha256=IN1PCQ08ZHs1sivUpzi2f9U9eW8ydZyb8GO6KiT56LY,3643
 orionis/console/tasks/listener.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/schedule.py,sha256=YsS4mdPToAsjQ90iGB1nCku0Et3AN_-eT1zXA482sBo,20356
@@ -90,8 +92,14 @@ orionis/container/validators/is_not_subclass.py,sha256=xq2NI-ZJjSAnq2C_tEOyncadY
 orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYqIVB8zXVN-bYnBI,1117
 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=ds6JVK4o1U_sqlCEEIyGX8-UG06_Wr7dqdDCdNavTTY,5560
+orionis/failure/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/failure/contracts/catch.py,sha256=sdtjhq6ToXrtdKR0Bw9YYUqofvm-FGULPnz4dZVddWQ,2844
+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=VhafZWfd1IHi7KpaCcG62lKAxJAYwUoKWwCZO_-doPY,78480
+orionis/foundation/application.py,sha256=kQxq9oadgqR1Fw5gTTfQIaclzsYT7a_cfv759z7Q8J8,78587
 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
@@ -193,6 +201,7 @@ orionis/foundation/exceptions/runtime.py,sha256=QS9Wjy79UFoM_lA-JR907p4l4Z8ae5E8
 orionis/foundation/exceptions/type.py,sha256=Ug51YdaUKUlbngR0KeWnJNqIwS9StP4ScVobFY1eI18,463
 orionis/foundation/exceptions/value.py,sha256=hQhXybXEnaa59ba7JxG65jceHt3mnql9MyekF-TChpM,465
 orionis/foundation/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/foundation/providers/catch_provider.py,sha256=jLEFyHeyqCWgIJfqSfXrbRm9h6M6M5IkW8M_9o_NvCQ,1701
 orionis/foundation/providers/console_provider.py,sha256=9oDHOGm79O8OtwTFPCYl4hNQgxAskqGdG1mIYyEg6qQ,2970
 orionis/foundation/providers/dumper_provider.py,sha256=nKHjLDClCo-KnPloh6EYVySjgzf6SYSvoxVD6IwJt8M,3355
 orionis/foundation/providers/executor_provider.py,sha256=kwkH8YWEXoEoP51akJXQJ0U25rhlOLxnfE0s9fALr0I,3478
@@ -205,7 +214,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=72SoixFog9IOE9Ve9Xcfw6
 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=yPjiA2v4xLZ_tPgY44CpGj_-mMyVD_VQpBBKp2FWEaQ,4109
+orionis/metadata/framework.py,sha256=PrRmtiQvoZA9WEDK1NMqb9rgSrh29IXDBZnQ0nT-Q74,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
@@ -237,7 +246,6 @@ orionis/services/environment/validators/key_name.py,sha256=TSwVhQCbBYPZ_4zZ-o16y
 orionis/services/environment/validators/types.py,sha256=hiTszo7hS_1zQLclUIDOFUTGy2Kg2n3dZe7jU8Pmf1I,2839
 orionis/services/file/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/file/directory.py,sha256=MdIc3hQXAcUaMFYujexScJ6-UIFgHCRN-TbGNr651Hg,7326
-orionis/services/file/storage.py,sha256=d3wdG3991fNbyGw9S9xAQ6PI28bA1wXHjzCtnLAK5Ls,202
 orionis/services/inspirational/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/inspirational/inspire.py,sha256=dUxwkNLjKC4jdi06cVB1gfyB2zHjfgdhYhwKtsOTf0Q,4090
 orionis/services/inspirational/quotes.py,sha256=9hCIEFE0DdfXLaGq_SzFpXlC2AbGSnuFLzyec4Rd1H0,53455
@@ -380,7 +388,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.488.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.489.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
@@ -527,8 +535,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.488.0.dist-info/METADATA,sha256=BU8vXsPnsy8hbMVw9OgKSsfoVKBmurqYRrsBok_RFW0,4801
-orionis-0.488.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.488.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.488.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.488.0.dist-info/RECORD,,
+orionis-0.489.0.dist-info/METADATA,sha256=An6hNJtORqXJnVHt_FXi66a9OHrQRb4Ayjvn0n4bbJk,4801
+orionis-0.489.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.489.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.489.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.489.0.dist-info/RECORD,,

orionis/console/contracts/event_listener.py

@@ -1,27 +0,0 @@
-from abc import ABC, abstractmethod
-
-class IEventListener(ABC):
-
-    @abstractmethod
-    def before(self, event):
-        pass
-
-    @abstractmethod
-    def after(self, event):
-        pass
-
-    @abstractmethod
-    def onSuccess(self, event):
-        pass
-
-    @abstractmethod
-    def onFailure(self, event):
-        pass
-
-    @abstractmethod
-    def onMissed(self, event):
-        pass
-
-    @abstractmethod
-    def onMaxInstances(self, event):
-        pass

orionis/services/file/storage.py

@@ -1,7 +0,0 @@
-from pathlib import Path
-from orionis.foundation.contracts.application import IApplication
-
-class Storage:
-
-    def __init__(self, app:IApplication) -> None:
-        self.__root = app.path('root')