orionis 0.567.0__py3-none-any.whl → 0.569.0__py3-none-any.whl

orionis/console/args/argument.py

@@ -2,7 +2,7 @@ import argparse
 from dataclasses import dataclass, field
 from typing import Any, Optional, List, Type, Union, Dict
 from orionis.console.enums.actions import ArgumentAction
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 
 @dataclass(kw_only=True, frozen=True, slots=True)
 class CLIArgument:

orionis/console/core/reactor.py

@@ -10,9 +10,9 @@ from orionis.console.contracts.cli_request import ICLIRequest
 from orionis.console.contracts.command import ICommand
 from orionis.console.contracts.reactor import IReactor
 from orionis.console.entities.command import Command
-from orionis.console.exceptions import CLIOrionisValueError
-from orionis.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
+from orionis.console.exceptions import CLIOrionisValueError, CLIOrionisRuntimeError
 from orionis.console.contracts.executor import IExecutor
+from orionis.console.exceptions import CLIOrionisTypeError
 from orionis.console.request.cli_request import CLIRequest
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.introspection.modules.reflection import ReflectionModule
@@ -107,6 +107,7 @@ class Reactor(IReactor):
         - The internal `__load_commands` flag tracks whether commands have been loaded
         - Both loading methods handle their own error handling and validation
         """
+
         # Check if commands have already been loaded to prevent duplicate loading
         if not self.__load_commands:
 
@@ -210,39 +211,47 @@ class Reactor(IReactor):
                             f"Failed to read file '{file_path}' for fluent command loading: {e}"
                         ) from e
 
+        # Import Command entity here to avoid circular imports
+        from orionis.console.entities.command import Command as CommandEntity
+
         # Iterate through all fluent command definitions
         for f_command in self.__fluent_commands:
 
-            # Validate and extract required command attributes
-            signature, command_entity = f_command.get()
-
-            # Build the arguments dictionary from the CLIArgument instances
-            required_args: List[CLIArgument] = command_entity.args
-
-            # Create an ArgumentParser instance to handle the command arguments
-            arg_parser = argparse.ArgumentParser(
-                usage=f"python -B reactor {signature} [options]",
-                description=f"Command [{signature}] : {command_entity.description}",
-                formatter_class=argparse.RawTextHelpFormatter,
-                add_help=True,
-                allow_abbrev=False,
-                exit_on_error=True,
-                prog=signature
-            )
-
-            # Iterate through each CLIArgument and add it to the ArgumentParser
-            for arg in required_args:
-                arg.addToParser(arg_parser)
+            # If the fluent command has a get method, retrieve its signature and command entity
+            if hasattr(f_command, 'get') and callable(getattr(f_command, 'get')):
+
+                # Get the signature and command entity from the fluent command
+                values = f_command.get()
+                signature: str = values[0]
+                command_entity: CommandEntity = values[1]
+
+                # Build the arguments dictionary from the CLIArgument instances
+                required_args: List[CLIArgument] = command_entity.args
+
+                # Create an ArgumentParser instance to handle the command arguments
+                arg_parser = argparse.ArgumentParser(
+                    usage=f"python -B reactor {signature} [options]",
+                    description=f"Command [{signature}] : {command_entity.description}",
+                    formatter_class=argparse.RawTextHelpFormatter,
+                    add_help=True,
+                    allow_abbrev=False,
+                    exit_on_error=True,
+                    prog=signature
+                )
 
-            # Register the command in the internal registry with all its metadata
-            self.__commands[signature] = Command(
-                obj=command_entity.obj,
-                method=command_entity.method,
-                timestamps=command_entity.timestamps,
-                signature=signature,
-                description=command_entity.description,
-                args=arg_parser
-            )
+                # Iterate through each CLIArgument and add it to the ArgumentParser
+                for arg in required_args:
+                    arg.addToParser(arg_parser)
+
+                # Register the command in the internal registry with all its metadata
+                self.__commands[signature] = Command(
+                    obj=command_entity.obj,
+                    method=command_entity.method,
+                    timestamps=command_entity.timestamps,
+                    signature=signature,
+                    description=command_entity.description,
+                    args=arg_parser
+                )
 
     def __loadCoreCommands(self) -> None:
         """
@@ -293,9 +302,15 @@ class Reactor(IReactor):
         # Iterate through the core command classes and register them
         for obj in core_commands:
 
+            # Get the signature attribute from the command class
+            signature = getattr(obj, 'signature', None)
+
+            # Skip if signature is not defined
+            if signature is None:
+                continue
+
             # Validate and extract required command attributes
             timestamp = self.__ensureTimestamps(obj)
-            signature = getattr(obj, 'signature', None)
             description = self.__ensureDescription(obj)
             args = self.__ensureArguments(obj)
 
@@ -338,6 +353,8 @@ class Reactor(IReactor):
 
         # Iterate through the command path and load command modules
         for current_directory, _, files in os.walk(commands_path):
+
+            # Iterate through each file in the current directory
             for file in files:
 
                 # Only process Python files
@@ -418,7 +435,7 @@ class Reactor(IReactor):
 
         # Ensure the timestamps attribute is a boolean type
         if not isinstance(obj.timestamps, bool):
-            raise TypeError(f"Command class {obj.__name__} 'timestamps' must be a boolean.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'timestamps' must be a boolean.")
 
         # Return timestamps value
         return obj.timestamps
@@ -444,24 +461,24 @@ class Reactor(IReactor):
 
         Raises
         ------
-        ValueError
+        CLIOrionisValueError
             If the command class lacks a 'signature' attribute, if the signature
             is an empty string, or if the signature doesn't match the required pattern.
-        TypeError
+        CLIOrionisTypeError
             If the 'signature' attribute is not a string.
         """
 
         # Check if the command class has a signature attribute
         if not hasattr(obj, 'signature'):
-            raise ValueError(f"Command class {obj.__name__} must have a 'signature' attribute.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} must have a 'signature' attribute.")
 
         # Ensure the signature attribute is a string type
         if not isinstance(obj.signature, str):
-            raise TypeError(f"Command class {obj.__name__} 'signature' must be a string.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'signature' must be a string.")
 
         # Validate that the signature is not empty after stripping whitespace
         if obj.signature.strip() == '':
-            raise ValueError(f"Command class {obj.__name__} 'signature' cannot be an empty string.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'signature' cannot be an empty string.")
 
         # Define the regex pattern for valid signature format
         # Pattern allows: alphanumeric chars, underscores, colons
@@ -470,7 +487,7 @@ class Reactor(IReactor):
 
         # Validate the signature against the required pattern
         if not re.match(pattern, obj.signature):
-            raise ValueError(f"Command class {obj.__name__} 'signature' must contain only alphanumeric characters, underscores (_) and colons (:), cannot start or end with underscore or colon, and cannot start with a number.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'signature' must contain only alphanumeric characters, underscores (_) and colons (:), cannot start or end with underscore or colon, and cannot start with a number.")
 
         # Return signature
         return obj.signature.strip()
@@ -496,24 +513,24 @@ class Reactor(IReactor):
 
         Raises
         ------
-        ValueError
+        CLIOrionisValueError
             If the command class lacks a 'description' attribute or if the description
             is an empty string after stripping whitespace.
-        TypeError
+        CLIOrionisTypeError
             If the 'description' attribute is not a string type.
         """
 
         # Check if the command class has a description attribute
         if not hasattr(obj, 'description'):
-            raise ValueError(f"Command class {obj.__name__} must have a 'description' attribute.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} must have a 'description' attribute.")
 
         # Ensure the description attribute is a string type
         if not isinstance(obj.description, str):
-            raise TypeError(f"Command class {obj.__name__} 'description' must be a string.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'description' must be a string.")
 
         # Validate that the description is not empty after stripping whitespace
         if obj.description.strip() == '':
-            raise ValueError(f"Command class {obj.__name__} 'description' cannot be an empty string.")
+            raise CLIOrionisValueError(f"Command class {obj.__name__} 'description' cannot be an empty string.")
 
         # Return description
         return obj.description.strip()
@@ -538,7 +555,7 @@ class Reactor(IReactor):
 
         Raises
         ------
-        TypeError
+        CLIOrionisTypeError
             If the 'arguments' attribute is not a list or contains non-CLIArgument instances.
         """
 
@@ -548,7 +565,7 @@ class Reactor(IReactor):
 
         # Ensure the arguments attribute is a list type
         if not isinstance(obj.arguments, list):
-            raise TypeError(f"Command class {obj.__name__} 'arguments' must be a list.")
+            raise CLIOrionisTypeError(f"Command class {obj.__name__} 'arguments' must be a list.")
 
         # If arguments is empty, return None
         if len(obj.arguments) == 0:
@@ -557,7 +574,7 @@ class Reactor(IReactor):
         # Validate that all items in the arguments list are CLIArgument instances
         for index, value in enumerate(obj.arguments):
             if not isinstance(value, CLIArgument):
-                raise TypeError(f"Command class {obj.__name__} 'arguments' must contain only CLIArgument instances, found '{type(value).__name__}' at index {index}.")
+                raise CLIOrionisTypeError(f"Command class {obj.__name__} 'arguments' must contain only CLIArgument instances, found '{type(value).__name__}' at index {index}.")
 
         # Build the arguments dictionary from the CLIArgument instances
         required_args: List[CLIArgument] = obj.arguments
@@ -669,7 +686,7 @@ class Reactor(IReactor):
 
         Raises
         ------
-        TypeError
+        CLIOrionisTypeError
             If the signature is not a string or if the handler is not a valid list.
         ValueError
             If the signature does not meet the required naming conventions.
@@ -680,11 +697,11 @@ class Reactor(IReactor):
 
         # Validate the handler parameter
         if len(handler) < 1 or not isinstance(handler, list):
-            raise TypeError("Handler must be a list with at least one element (the callable).")
+            raise CLIOrionisValueError("Handler must be a list with at least one element (the callable).")
 
         # Ensure the first element is a class
         if not hasattr(handler[0], '__call__') or not hasattr(handler[0], '__name__'):
-            raise TypeError("The first element of handler must be a class.")
+            raise CLIOrionisTypeError("The first element of handler must be a class.")
 
         # Create a new FluentCommand instance with the provided signature and handler
         f_command = FluentCommand(

orionis/console/enums/actions.py

@@ -2,42 +2,61 @@ from enum import Enum
 
 class ArgumentAction(Enum):
     """
-    Enumeration for valid argparse action types.
-
-    This enum provides a comprehensive list of all standard action types
-    that can be used with Python's argparse module when defining command
-    line arguments. Each enum member corresponds to a specific behavior
-    for how argument values should be processed and stored.
+    Enumeration of valid action types for use with Python's argparse module.
+
+    This enum defines all standard action types that can be assigned to command-line arguments
+    using argparse. Each member represents a specific way argparse processes and stores argument values.
+
+    Attributes
+    ----------
+    STORE : str
+        Stores the argument value directly.
+    STORE_CONST : str
+        Stores a constant value when the argument is specified.
+    STORE_TRUE : str
+        Stores True when the argument is specified.
+    STORE_FALSE : str
+        Stores False when the argument is specified.
+    APPEND : str
+        Appends each argument value to a list.
+    APPEND_CONST : str
+        Appends a constant value to a list when the argument is specified.
+    COUNT : str
+        Counts the number of times the argument is specified.
+    HELP : str
+        Displays the help message and exits.
+    VERSION : str
+        Displays version information and exits.
 
     Returns
     -------
     str
-        The string value representing the argparse action type.
+        The string value representing the corresponding argparse action type.
     """
 
-    # Store the argument value directly
+    # Stores the argument value directly
     STORE = "store"
 
-    # Store a constant value when the argument is specified
+    # Stores a constant value when the argument is specified
     STORE_CONST = "store_const"
 
-    # Store True when the argument is specified
+    # Stores True when the argument is specified
     STORE_TRUE = "store_true"
 
-    # Store False when the argument is specified
+    # Stores False when the argument is specified
     STORE_FALSE = "store_false"
 
-    # Append each argument value to a list
+    # Appends each argument value to a list
     APPEND = "append"
 
-    # Append a constant value to a list when the argument is specified
+    # Appends a constant value to a list when the argument is specified
     APPEND_CONST = "append_const"
 
-    # Count the number of times the argument is specified
+    # Counts the number of times the argument is specified
     COUNT = "count"
 
-    # Display help message and exit
+    # Displays the help message and exits the program
     HELP = "help"
 
-    # Display version information and exit
+    # Displays version information and exits the program
     VERSION = "version"

orionis/console/enums/listener.py

@@ -2,62 +2,60 @@ from enum import Enum
 
 class ListeningEvent(Enum):
     """
-    Enumeration of events related to a scheduler and its jobs.
+    Enumeration of scheduler and job-related events.
 
-    This class defines various events that can occur during the lifecycle of a scheduler
-    and its associated jobs. These events can be used to monitor and respond to changes
-    in the scheduler's state or the execution of jobs.
+    This enumeration defines the various events that can occur during the lifecycle of a scheduler
+    and its associated jobs. These events are intended to be used for monitoring, logging, or
+    triggering actions in response to changes in the scheduler's state or job execution.
 
     Attributes
     ----------
     SCHEDULER_STARTED : str
-        Event triggered when the scheduler starts.
+        Triggered when the scheduler starts.
     SCHEDULER_SHUTDOWN : str
-        Event triggered when the scheduler shuts down.
+        Triggered when the scheduler shuts down.
     SCHEDULER_PAUSED : str
-        Event triggered when the scheduler is paused.
+        Triggered when the scheduler is paused.
     SCHEDULER_RESUMED : str
-        Event triggered when the scheduler is resumed.
+        Triggered when the scheduler is resumed.
     SCHEDULER_ERROR : str
-        Event triggered when the scheduler encounters an error.
+        Triggered when the scheduler encounters an error.
     JOB_BEFORE : str
-        Event triggered before a job is executed.
+        Triggered before a job is executed.
     JOB_AFTER : str
-        Event triggered after a job is executed.
-    JOB_ON_SUCCESS : str
-        Event triggered when a job completes successfully.
+        Triggered after a job is executed.
     JOB_ON_FAILURE : str
-        Event triggered when a job fails.
+        Triggered when a job fails.
     JOB_ON_MISSED : str
-        Event triggered when a job is missed.
+        Triggered when a job is missed.
     JOB_ON_MAXINSTANCES : str
-        Event triggered when a job exceeds its maximum allowed instances.
+        Triggered when a job exceeds its maximum allowed instances.
     JOB_ON_PAUSED : str
-        Event triggered when a job is paused.
+        Triggered when a job is paused.
     JOB_ON_RESUMED : str
-        Event triggered when a paused job is resumed.
+        Triggered when a paused job is resumed.
     JOB_ON_REMOVED : str
-        Event triggered when a job is removed.
+        Triggered when a job is removed.
 
     Returns
     -------
     str
-        The string representation of the event name.
+        The string value representing the event name.
     """
 
     # Scheduler-related events
-    SCHEDULER_STARTED = "schedulerStarted"                  # Triggered when the scheduler starts
-    SCHEDULER_SHUTDOWN = "schedulerShutdown"                # Triggered when the scheduler shuts down
-    SCHEDULER_PAUSED = "schedulerPaused"                    # Triggered when the scheduler is paused
-    SCHEDULER_RESUMED = "schedulerResumed"                  # Triggered when the scheduler is resumed
-    SCHEDULER_ERROR = "schedulerError"                      # Triggered when the scheduler encounters an error
+    SCHEDULER_STARTED = "schedulerStarted"      # Triggered when the scheduler starts
+    SCHEDULER_SHUTDOWN = "schedulerShutdown"    # Triggered when the scheduler shuts down
+    SCHEDULER_PAUSED = "schedulerPaused"        # Triggered when the scheduler is paused
+    SCHEDULER_RESUMED = "schedulerResumed"      # Triggered when the scheduler is resumed
+    SCHEDULER_ERROR = "schedulerError"          # Triggered when the scheduler encounters an error
 
     # Job-related events
-    JOB_BEFORE = "before"                                   # Triggered before a job is executed
-    JOB_AFTER = "after"                                     # Triggered after a job is executed
-    JOB_ON_FAILURE = "onFailure"                            # Triggered when a job fails
-    JOB_ON_MISSED = "onMissed"                              # Triggered when a job is missed
-    JOB_ON_MAXINSTANCES = "onMaxInstances"                  # Triggered when a job exceeds its max instances
-    JOB_ON_PAUSED = "onPaused"                              # Triggered when a job is paused
-    JOB_ON_RESUMED = "onResumed"                            # Triggered when a paused job is resumed
-    JOB_ON_REMOVED = "onRemoved"                            # Triggered when a job is removed
+    JOB_BEFORE = "before"                       # Triggered before a job is executed
+    JOB_AFTER = "after"                         # Triggered after a job is executed
+    JOB_ON_FAILURE = "onFailure"                # Triggered when a job fails
+    JOB_ON_MISSED = "onMissed"                  # Triggered when a job is missed
+    JOB_ON_MAXINSTANCES = "onMaxInstances"      # Triggered when a job exceeds its max instances
+    JOB_ON_PAUSED = "onPaused"                  # Triggered when a job is paused
+    JOB_ON_RESUMED = "onResumed"                # Triggered when a paused job is resumed
+    JOB_ON_REMOVED = "onRemoved"                # Triggered when a job is removed

orionis/console/enums/styles.py

@@ -2,106 +2,103 @@ from enum import Enum
 
 class ANSIColors(Enum):
     """
-    ANSI escape codes for text and background styling in the terminal.
+    ANSI escape codes for styling text and backgrounds in terminal applications.
 
-    This Enum provides color codes for text styling in console applications,
-    including foreground (TEXT), background (BG), bold (TEXT_BOLD), and
-    additional text styles like underlining.
+    This Enum provides a comprehensive set of ANSI escape codes for coloring and styling
+    text output in console applications. It includes codes for foreground (text) colors,
+    background colors, bold and underlined styles, as well as additional effects such as
+    dim, italic, and magenta. These codes can be used to enhance the readability and
+    emphasis of console messages, such as errors, warnings, informational, and success messages.
 
     Attributes
     ----------
     DEFAULT : str
-        Resets all colors and styles to default terminal settings.
-
-    Background Colors
-    -----------------
+        ANSI code to reset all colors and styles to the terminal's default.
     BG_INFO : str
-        Blue background, typically used for informational messages.
+        ANSI code for a blue background, typically used for informational messages.
     BG_ERROR : str
-        Red background, typically used for error messages.
+        ANSI code for a red background, typically used for error messages.
+    BG_FAIL : str
+        ANSI code for a specific red background, often used for failure messages.
     BG_WARNING : str
-        Yellow background, typically used for warnings.
+        ANSI code for a yellow background, typically used for warnings.
     BG_SUCCESS : str
-        Green background, typically used for success messages.
-
-    Foreground Colors
-    -----------------
+        ANSI code for a green background, typically used for success messages.
     TEXT_INFO : str
-        Blue text, typically used for informational messages.
+        ANSI code for blue foreground text, used for informational messages.
     TEXT_ERROR : str
-        Bright red text, typically used for errors.
+        ANSI code for bright red foreground text, used for errors.
     TEXT_WARNING : str
-        Yellow text, typically used for warnings.
+        ANSI code for yellow foreground text, used for warnings.
     TEXT_SUCCESS : str
-        Green text, typically used for success messages.
+        ANSI code for green foreground text, used for success messages.
     TEXT_WHITE : str
-        White text, useful for contrast.
+        ANSI code for white foreground text, useful for contrast.
     TEXT_MUTED : str
-        Gray text, typically used for secondary/muted information.
-
-    Bold Foreground Colors
-    ----------------------
+        ANSI code for gray (muted) foreground text, used for secondary information.
     TEXT_BOLD_INFO : str
-        Bold blue text for informational emphasis.
+        ANSI code for bold blue foreground text, emphasizing informational messages.
     TEXT_BOLD_ERROR : str
-        Bold red text for error emphasis.
+        ANSI code for bold red foreground text, emphasizing errors.
     TEXT_BOLD_WARNING : str
-        Bold yellow text for warning emphasis.
+        ANSI code for bold yellow foreground text, emphasizing warnings.
     TEXT_BOLD_SUCCESS : str
-        Bold green text for success emphasis.
+        ANSI code for bold green foreground text, emphasizing success messages.
     TEXT_BOLD_WHITE : str
-        Bold white text for strong contrast.
+        ANSI code for bold white foreground text, for strong contrast.
     TEXT_BOLD_MUTED : str
-        Bold gray text for muted yet emphasized information.
-
-    Additional Text Styles
-    ----------------------
+        ANSI code for bold gray (muted) foreground text, for emphasized secondary information.
     TEXT_BOLD : str
-        Bold text style.
+        ANSI code for bold text style.
     TEXT_STYLE_UNDERLINE : str
-        Underlined text for emphasis.
+        ANSI code for underlined text style.
     TEXT_RESET : str
-        Resets text styles to default settings.
+        ANSI code to reset text styles to default settings.
     CYAN : str
-        Cyan text for special emphasis.
+        ANSI code for cyan foreground text, for special emphasis.
     DIM : str
-        Dim text for subtle emphasis.
+        ANSI code for dimmed foreground text, for subtle emphasis.
     MAGENTA : str
-        Magenta text for special emphasis.
+        ANSI code for magenta foreground text, for special emphasis.
     ITALIC : str
-        Italic text for special emphasis.
+        ANSI code for italicized foreground text, for special emphasis.
+
+    Returns
+    -------
+    str
+        The ANSI escape code string corresponding to the selected color or style.
     """
 
     DEFAULT = '\033[0m'                 # Reset all colors and styles
 
     # Background Colors
-    BG_INFO = '\033[44m'                # Blue background for INFO
-    BG_ERROR = '\033[41m'               # Red background for ERROR
-    BG_FAIL = '\033[48;5;166m'          # Red background for FAIL
-    BG_WARNING = '\033[43m'             # Yellow background for WARNING
-    BG_SUCCESS = '\033[42m'             # Green background for SUCCESS
+    BG_INFO = '\033[44m'                # Blue background for informational messages
+    BG_ERROR = '\033[41m'               # Red background for error messages
+    BG_FAIL = '\033[48;5;166m'          # Specific red background for failure messages
+    BG_WARNING = '\033[43m'             # Yellow background for warning messages
+    BG_SUCCESS = '\033[42m'             # Green background for success messages
 
     # Foreground Text Colors
-    TEXT_INFO = '\033[34m'              # Blue for informational messages
-    TEXT_ERROR = '\033[91m'             # Bright red for errors
-    TEXT_WARNING = '\033[33m'           # Yellow for warnings
-    TEXT_SUCCESS = '\033[32m'           # Green for success
-    TEXT_WHITE = '\033[97m'             # White text
-    TEXT_MUTED = '\033[90m'             # Gray (muted) text
+    TEXT_INFO = '\033[34m'              # Blue text for informational messages
+    TEXT_ERROR = '\033[91m'             # Bright red text for errors
+    TEXT_WARNING = '\033[33m'           # Yellow text for warnings
+    TEXT_SUCCESS = '\033[32m'           # Green text for success messages
+    TEXT_WHITE = '\033[97m'             # White text for high contrast
+    TEXT_MUTED = '\033[90m'             # Gray (muted) text for secondary information
 
     # Bold Foreground Text Colors
-    TEXT_BOLD_INFO = '\033[1;34m'       # Bold blue for INFO
-    TEXT_BOLD_ERROR = '\033[1;91m'      # Bold red for ERROR
-    TEXT_BOLD_WARNING = '\033[1;33m'    # Bold yellow for WARNING
-    TEXT_BOLD_SUCCESS = '\033[1;32m'    # Bold green for SUCCESS
-    TEXT_BOLD_WHITE = '\033[1;97m'      # Bold white text
-    TEXT_BOLD_MUTED = '\033[1;90m'      # Bold gray (muted) text
+    TEXT_BOLD_INFO = '\033[1;34m'       # Bold blue text for informational emphasis
+    TEXT_BOLD_ERROR = '\033[1;91m'      # Bold red text for error emphasis
+    TEXT_BOLD_WARNING = '\033[1;33m'    # Bold yellow text for warning emphasis
+    TEXT_BOLD_SUCCESS = '\033[1;32m'    # Bold green text for success emphasis
+    TEXT_BOLD_WHITE = '\033[1;97m'      # Bold white text for strong contrast
+    TEXT_BOLD_MUTED = '\033[1;90m'      # Bold gray (muted) text for emphasized secondary info
 
     # Additional Text Styles
-    TEXT_BOLD = "\033[1m"               # Bold text
-    TEXT_STYLE_UNDERLINE = '\033[4m'    # Underline text
-    TEXT_RESET = "\033[0m"              # Reset styles
-    CYAN = "\033[36m"                   # Cyan text
-    DIM = "\033[2m"                     # Dim text
-    MAGENTA = "\033[35m"                # Magenta text
-    ITALIC = "\033[3m"                  # Italic text
+    TEXT_BOLD = "\033[1m"               # Bold text style
+    TEXT_STYLE_UNDERLINE = '\033[4m'    # Underlined text style
+    TEXT_RESET = "\033[0m"              # Reset all text styles to default
+    CYAN = "\033[36m"                   # Cyan text for special emphasis
+    DIM = "\033[2m"                     # Dim text for subtle emphasis
+    MAGENTA = "\033[35m"                # Magenta text for special emphasis
+    ITALIC = "\033[3m"                  # Italic text for special emphasis

orionis/console/exceptions/__init__.py

@@ -1,11 +1,15 @@
-from .cli_exception import CLIOrionisException
-from .cli_runtime_error import CLIOrionisRuntimeError
-from .cli_schedule_exception import CLIOrionisScheduleException
-from .cli_orionis_value_error import CLIOrionisValueError
+from .cli_exception import (
+    CLIOrionisException,
+    CLIOrionisRuntimeError,
+    CLIOrionisScheduleException,
+    CLIOrionisValueError,
+    CLIOrionisTypeError
+)
 
 __all__ = [
     'CLIOrionisException',
     'CLIOrionisRuntimeError',
     'CLIOrionisScheduleException',
-    'CLIOrionisValueError'
+    'CLIOrionisValueError',
+    'CLIOrionisTypeError',
 ]

orionis/console/exceptions/cli_exception.py

@@ -1,41 +1,118 @@
 class CLIOrionisException(Exception):
     """
-    Custom exception raised when there is an issue with dumping the Orionis data.
+    Base exception for Orionis CLI errors.
+
+    This exception is raised for errors that are specific to the Orionis command-line interface (CLI)
+    operations. It serves as the base class for all CLI-related exceptions within the Orionis framework,
+    allowing for consistent error handling and identification of CLI-specific issues.
 
     Parameters
     ----------
-    message : str
-        The response message associated with the exception.
+    message : str, optional
+        An optional error message describing the exception.
+
+    Returns
+    -------
+    CLIOrionisException
+        An instance of the CLIOrionisException class.
+
+    Notes
+    -----
+    Subclass this exception to create more specific CLI-related exceptions as needed.
+    """
+    pass  # No additional implementation; serves as a base exception class.
+
 
-    Attributes
+class CLIOrionisValueError(ValueError):
+    """
+    Exception for invalid CLI input values in Orionis.
+
+    Raised when a function receives an argument of the correct type but an inappropriate value
+    during CLI operations within the Orionis framework.
+
+    Parameters
     ----------
-    message : str
-        Stores the response message passed during initialization.
+    message : str, optional
+        An optional error message describing the value error.
 
-    Methods
+    Returns
     -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisException with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisException: {self.args[0]}"
+    CLIOrionisValueError
+        An instance of the CLIOrionisValueError class.
+
+    Notes
+    -----
+    Use this exception to signal invalid or inappropriate values encountered during CLI operations.
+    """
+    pass  # Inherits from ValueError to indicate value-related errors.
+
+
+class CLIOrionisRuntimeError(RuntimeError):
+    """
+    Exception for runtime errors in Orionis CLI.
+
+    Raised when a runtime error occurs during the execution of CLI commands within the Orionis framework,
+    distinguishing these errors from other runtime errors.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the runtime error.
+
+    Returns
+    -------
+    CLIOrionisRuntimeError
+        An instance of the CLIOrionisRuntimeError class.
+
+    Notes
+    -----
+    Use this exception to handle runtime errors specific to CLI contexts.
+    """
+    pass  # Inherits from RuntimeError for CLI-specific runtime issues.
+
+
+class CLIOrionisScheduleException(Exception):
+    """
+    Exception for scheduling errors in Orionis CLI.
+
+    Raised when issues are encountered during scheduling tasks within the Orionis command-line interface.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the scheduling exception.
+
+    Returns
+    -------
+    CLIOrionisScheduleException
+        An instance of the CLIOrionisScheduleException class.
+
+    Notes
+    -----
+    Use this exception to signal errors related to scheduling operations in the CLI.
+    """
+    pass  # Used for errors related to scheduling operations.
+
+
+class CLIOrionisTypeError(TypeError):
+    """
+    Exception for invalid types in Orionis CLI.
+
+    Raised when an invalid type is encountered during command-line interface operations in the Orionis framework,
+    providing clearer context than the built-in TypeError.
+
+    Parameters
+    ----------
+    message : str, optional
+        An optional error message describing the type error.
+
+    Returns
+    -------
+    CLIOrionisTypeError
+        An instance of the CLIOrionisTypeError class.
+
+    Notes
+    -----
+    Use this exception to handle type-related errors specific to CLI operations.
+    """
+    pass  # Inherits from TypeError for CLI-specific type errors.

orionis/console/request/cli_request.py

@@ -1,6 +1,6 @@
 from typing import Any, List
 from orionis.console.contracts.cli_request import ICLIRequest
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 
 class CLIRequest(ICLIRequest):
 

orionis/console/stub/command.stub

@@ -1,6 +1,6 @@
 from orionis.console.base.command import BaseCommand
 from orionis.console.args.argument import CLIArgument
-from orionis.console.exceptions.cli_runtime_error import CLIOrionisRuntimeError
+from orionis.console.exceptions import CLIOrionisRuntimeError
 
 class {{class_name}}(BaseCommand):
     """

orionis/console/tasks/schedule.py

@@ -33,7 +33,7 @@ from orionis.console.entities.scheduler_started import SchedulerStarted
 from orionis.console.entities.event import Event as EventEntity
 from orionis.console.enums.listener import ListeningEvent
 from orionis.console.exceptions import CLIOrionisRuntimeError
-from orionis.console.exceptions.cli_orionis_value_error import CLIOrionisValueError
+from orionis.console.exceptions import CLIOrionisValueError
 from orionis.console.request.cli_request import CLIRequest
 from orionis.failure.contracts.catch import ICatch
 from orionis.foundation.contracts.application import IApplication

orionis/metadata/framework.py

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

{orionis-0.567.0.dist-info → orionis-0.569.0.dist-info}/METADATA

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

{orionis-0.567.0.dist-info → orionis-0.569.0.dist-info}/RECORD

@@ -3,7 +3,7 @@ orionis/app.py,sha256=foCcJAfebeZD69wsAiNvPUx_7UMK6w8ow5WpVjzwDDk,1131
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/kernel.py,sha256=-TRE9caKJ76fUfK7OxA4JgBBLw9wxlmRBC020_EeD84,3795
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/args/argument.py,sha256=3Q_4p56qF0VPxK34xX3W4Ln2-Sua9rCHClGOeO96YcY,20355
+orionis/console/args/argument.py,sha256=QkdTrIYfG6CqDEMVBlQvNzRVHlBAcJOinVjq5Lz-wl8,20331
 orionis/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/command.py,sha256=jdUPc7MoJs9QWo_WEPV0Mb_7f6G563OWFTh7DJeUfM8,6642
 orionis/console/base/scheduler.py,sha256=IKNhpI_lPbI8H3YruD9z7eNdjuqNYceaclx_Hr5BHfY,8065
@@ -33,7 +33,7 @@ orionis/console/contracts/reactor.py,sha256=iT6ShoCutAWEeJzOf_PK7CGXi9TgrOD5tewH
 orionis/console/contracts/schedule.py,sha256=N-AYUa1CJY7a4CV9L1EX_EUDtGlDJMg4y0aV9EDby1Q,16090
 orionis/console/contracts/schedule_event_listener.py,sha256=h06qsBxuEMD3KLSyu0JXdUDHlQW19BX9lA09Qrh2QXg,3818
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=57EFQAA4lFY2yrYAzQIiQSRBTV2rLYXLEFsB0C8dxj4,41798
+orionis/console/core/reactor.py,sha256=40-gWJmSfJJXdIrQpbUaO9LdFHpjqQvz9UnL9DJXQDU,42758
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/debug.py,sha256=p8uflSXeDJDrVM9mZY4JMYEus73Z6TsLnQQtgP0QUak,22427
 orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -49,14 +49,11 @@ orionis/console/entities/scheduler_resumed.py,sha256=A5eIuhqmQIUYEnfpCF8HHaoBOAG
 orionis/console/entities/scheduler_shutdown.py,sha256=aXOhNgXFQT7vdUk05Ib7mjfd0-Y_A7jq66uok9v-nsM,1036
 orionis/console/entities/scheduler_started.py,sha256=-ONkJSX3XhhT7JgqTb727St-tcowknI-GHocNrxf2AE,950
 orionis/console/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/enums/actions.py,sha256=S3T-vWS6DJSGtANrq3od3-90iYAjPvJwaOZ2V02y34c,1222
-orionis/console/enums/listener.py,sha256=bDHDOkKQFEfEmZyiisZj37ozr8Hs7_lKvm_3uYjvEpw,2988
-orionis/console/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
-orionis/console/exceptions/__init__.py,sha256=0qlHNuHMVZO87M-rP8lThUUyljRM1jSFNikaxSCjSbw,366
-orionis/console/exceptions/cli_exception.py,sha256=HsZ_vSeNiJWQ0gznVFNcIdhM0Bj_vkSRVBJs0wMjEKY,1141
-orionis/console/exceptions/cli_orionis_value_error.py,sha256=RQP0HRwxDG8hxFOT1kUoZ1Ab1CZ1KLoSIl5yqlmgG4M,1147
-orionis/console/exceptions/cli_runtime_error.py,sha256=DaCDGu6mXBk1LIzc7cwRROw1mePAigPNASjNZHhUSBE,1154
-orionis/console/exceptions/cli_schedule_exception.py,sha256=IBbXb_5zi02pyo1laHdjGn6FYZK7WWRp4j2fkZOCT6I,1161
+orionis/console/enums/actions.py,sha256=1peNzH9R9RBf_uEXB1Q2__J5r-Rb7qm3pcRjbBkDc7g,1935
+orionis/console/enums/listener.py,sha256=eIBWeWtg-FdTFbbPU43ChymAV3mXYZPj2H2FCyE10w8,2711
+orionis/console/enums/styles.py,sha256=IItXN6uJ2tGmJZFZekn6ZrMHLDUVierU0koO625OD3c,5199
+orionis/console/exceptions/__init__.py,sha256=IwFMI6PKPPam8pNLGgt638LhopoQlWx-bM1hpO5HEvg,342
+orionis/console/exceptions/cli_exception.py,sha256=nk3EGkRheDbw8vrxKgUxkAAPA6gPpO2dE5nDeVHJHA0,3580
 orionis/console/fluent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/fluent/command.py,sha256=ayEh2fH83pCITyYUXHvt2jEgjMU63zdgRRYVdvUgFvk,8195
 orionis/console/fluent/event.py,sha256=kEynb0mQDyEiTiEnctoJoPizFfe0TkySOsMaECob3UY,166495
@@ -64,11 +61,11 @@ orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 orionis/console/output/console.py,sha256=EtSDWRBW8wk0iJdPfB1mzU49krLJBaSAUdVdVOzzhQ4,17888
 orionis/console/output/executor.py,sha256=uQjFPOlyZLFj9pcyYPugCqxwJog0AJgK1OcmQH2ELbw,7314
 orionis/console/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/request/cli_request.py,sha256=zFuoFzLVDCcSNcJZAuLAlsc9jfhck5o23qaKc2C0QAg,13231
-orionis/console/stub/command.stub,sha256=ATmJunhcRMGWkEKcwhJlnuAAzyGDMo9XGiPPp6xxwTQ,1258
+orionis/console/request/cli_request.py,sha256=lO7088xlVK1VP-NhCIgAo7qXGzCW3nXVOJag43fUv20,13207
+orionis/console/stub/command.stub,sha256=IfQ0bTrpataVFcT1ZdHyyiYNZ67D5Aox_QvgVJLeJnI,1240
 orionis/console/stub/listener.stub,sha256=DbX-ghx2-vb73kzQ6L20lyg5vSKn58jSLTwFuwNQU9k,4331
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/tasks/schedule.py,sha256=qFnzoLyK69iaKEWMfEVxLs3S9aWVRzD4G6emTFhJMaY,83386
+orionis/console/tasks/schedule.py,sha256=r0m_AESx18ahcQyuJvdhKkjmXOMIpkRYWC8eFNWNDoU,83362
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/container.py,sha256=9beW1IQzgZkgVIMo0ePBAkTz7bnNz3GNZZDRogMp8AI,96902
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -227,7 +224,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=H1bCNz2LPAeb0lblP84YyMuz5oV3s6sZg6tNOJXdgt0,4109
+orionis/metadata/framework.py,sha256=UoERiZgmjUgxCtMs2ffkbkUzrOF5Qd5wi9VDFJfN3ZA,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
@@ -420,8 +417,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.567.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.567.0.dist-info/METADATA,sha256=w5agxagM2wQhVG0aRNo2DiVlYPE3JY9y3Ih9SR_Rmx4,4801
-orionis-0.567.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.567.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.567.0.dist-info/RECORD,,
+orionis-0.569.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.569.0.dist-info/METADATA,sha256=b3DPny_vyZAPD-JGiVYDcxLyyTDKDAiM3SQa0Xn60Ug,4801
+orionis-0.569.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.569.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.569.0.dist-info/RECORD,,

orionis/console/exceptions/cli_orionis_value_error.py

@@ -1,41 +0,0 @@
-class CLIOrionisValueError(ValueError):
-    """
-    Custom exception raised when there is a value error in Orionis data processing.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisValueError with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisValueError: {self.args[0]}"

orionis/console/exceptions/cli_runtime_error.py

@@ -1,41 +0,0 @@
-class CLIOrionisRuntimeError(RuntimeError):
-    """
-    Custom exception raised when there is a runtime issue with Orionis processing.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisRuntimeError with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisRuntimeError: {self.args[0]}"

orionis/console/exceptions/cli_schedule_exception.py

@@ -1,41 +0,0 @@
-class CLIOrionisScheduleException(Exception):
-    """
-    Custom exception raised when there is an issue with the Orionis schedule.
-
-    Parameters
-    ----------
-    message : str
-        The response message associated with the exception.
-
-    Attributes
-    ----------
-    message : str
-        Stores the response message passed during initialization.
-
-    Methods
-    -------
-    __str__()
-        Returns a string representation of the exception, including the response message.
-    """
-
-    def __init__(self, message: str):
-        """
-        Initializes the CLIOrionisScheduleException with the given response message.
-
-        Parameters
-        ----------
-        message : str
-            The response message associated with the exception.
-        """
-        super().__init__(message)
-
-    def __str__(self):
-        """
-        Returns a string representation of the exception, including the response message.
-
-        Returns
-        -------
-        str
-            A string containing the exception name and the response message.
-        """
-        return f"CLIOrionisScheduleException: {self.args[0]}"