orionis 0.488.0__tar.gz → 0.490.0__tar.gz

{orionis-0.488.0/orionis.egg-info → orionis-0.490.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.488.0
+Version: 0.490.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/orionis/console/base → orionis-0.490.0/orionis/console/base/contracts}/scheduler.py

@@ -1,7 +1,8 @@
+from abc import ABC, abstractmethod
 from datetime import datetime
 from orionis.console.contracts.schedule import ISchedule
 
-class BaseScheduler:
+class IBaseScheduler(ABC):
 
     # Pause Global Scheduler at a specific time
     PAUSE_AT: datetime = None
@@ -12,6 +13,7 @@ class BaseScheduler:
     # 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.
@@ -33,24 +35,4 @@ class BaseScheduler:
         to the scheduler using the provided `schedule` object.
         """
         # This method should be overridden in subclasses to define scheduled tasks.
-        pass
-
-    def onStarted(self):
-        # Called when the scheduler is started.
-        pass
-
-    def onPaused(self):
-        # Called when the scheduler is paused.
-        pass
-
-    def onResumed(self):
-        # Called when the scheduler is resumed.
-        pass
-
-    def onFinalized(self):
-        # Called when the scheduler is finalized.
-        pass
-
-    def onError(self, error: Exception):
-        # Called when an error occurs in the scheduler.
         pass

orionis-0.490.0/orionis/console/base/scheduler.py

@@ -0,0 +1,126 @@
+from datetime import datetime
+from orionis.console.base.contracts.scheduler import IBaseScheduler
+from orionis.console.contracts.schedule import ISchedule
+
+class BaseScheduler(IBaseScheduler):
+
+    # 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
+
+    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
+        -----
+        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.
+        """
+        # 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.
+
+        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.
+
+        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 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 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):
+        """
+        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-0.488.0 → orionis-0.490.0}/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-0.488.0 → orionis-0.490.0}/orionis/console/commands/scheduler_list.py

@@ -1,13 +1,12 @@
-import importlib
-import os
-from pathlib import Path
 from rich.console import Console
 from rich.panel import Panel
 from rich.table import Table
 from orionis.console.base.command import BaseCommand
 from orionis.console.contracts.schedule import ISchedule
 from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.container.exceptions.exception import OrionisContainerException
 from orionis.foundation.contracts.application import IApplication
+from orionis.foundation.exceptions.runtime import OrionisRuntimeError
 
 class ScheduleListCommand(BaseCommand):
     """
@@ -88,7 +87,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")
@@ -111,8 +110,13 @@ class ScheduleListCommand(BaseCommand):
             console.line()
             return True
 
-        except Exception as exc:
+        except Exception as e:
+
+            # If the exception is already a CLIOrionisRuntimeError or OrionisContainerException, re-raise it
+            if isinstance(e, (OrionisRuntimeError, OrionisContainerException)):
+                raise
+
             # Catch any unexpected exceptions and raise as a CLIOrionisRuntimeError
             raise CLIOrionisRuntimeError(
-                f"An unexpected error occurred while listing the scheduled jobs: {exc}"
+                f"An unexpected error occurred while listing the scheduled jobs: {e}"
             )

{orionis-0.488.0 → orionis-0.490.0}/orionis/console/commands/scheduler_work.py

@@ -5,7 +5,9 @@ from rich.text import Text
 from orionis.console.base.command import BaseCommand
 from orionis.console.contracts.schedule import ISchedule
 from orionis.console.exceptions import CLIOrionisRuntimeError
+from orionis.container.exceptions.exception import OrionisContainerException
 from orionis.foundation.contracts.application import IApplication
+from orionis.foundation.exceptions.runtime import OrionisRuntimeError
 
 class ScheduleWorkCommand(BaseCommand):
     """
@@ -101,8 +103,13 @@ class ScheduleWorkCommand(BaseCommand):
             await schedule_serice.start()
             return True
 
-        except Exception as exc:
+        except Exception as e:
+
+            # If the exception is already a CLIOrionisRuntimeError or OrionisContainerException, re-raise it
+            if isinstance(e, (OrionisRuntimeError, OrionisContainerException)):
+                raise
+
             # Raise any unexpected exceptions as CLIOrionisRuntimeError
             raise CLIOrionisRuntimeError(
-                f"An unexpected error occurred while starting the scheduler worker: {exc}"
+                f"An unexpected error occurred while starting the scheduler worker: {e}"
             )

orionis-0.490.0/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-0.488.0 → orionis-0.490.0}/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-0.490.0/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-0.488.0 → orionis-0.490.0}/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-0.488.0 → orionis-0.490.0}/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,13 @@ 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[/]")
+        tb = Traceback.from_exception(type(e), e, e.__traceback__, max_frames=1)
+        rc.print(tb)
 
     def exitSuccess(self, message: str = None) -> None:
         """

{orionis-0.488.0 → orionis-0.490.0}/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