orionis 0.566.0__tar.gz → 0.568.0__tar.gz

{orionis-0.566.0/orionis.egg-info → orionis-0.568.0}/PKG-INFO

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

{orionis-0.566.0 → orionis-0.568.0}/orionis/console/base/scheduler.py

@@ -1,7 +1,7 @@
 from datetime import datetime
 from orionis.console.contracts.base_scheduler import IBaseScheduler
 from orionis.console.contracts.schedule import ISchedule
-from orionis.console.entities.job_error import JobError
+from orionis.console.entities.scheduler_error import SchedulerError
 from orionis.console.entities.scheduler_paused import SchedulerPaused
 from orionis.console.entities.scheduler_resumed import SchedulerResumed
 from orionis.console.entities.scheduler_shutdown import SchedulerShutdown
@@ -163,17 +163,17 @@ class BaseScheduler(IBaseScheduler):
         """
         pass
 
-    async def onError(self, event: JobError, schedule: ISchedule):
+    async def onError(self, event: SchedulerError, schedule: ISchedule):
         """
         Handles the event triggered when a job encounters an error during execution.
 
-        This method is invoked when a job fails due to an exception. It processes the `JobError`
+        This method is invoked when a job fails due to an exception. It processes the `SchedulerError`
         event and performs any necessary actions, such as logging the error details or notifying
         relevant systems about the failure.
 
         Parameters
         ----------
-        event : JobError
+        event : SchedulerError
             The event object containing details about the job error, including the job ID,
             the exception that occurred, and any relevant metadata.
         schedule : ISchedule

{orionis-0.566.0 → orionis-0.568.0}/orionis/console/contracts/base_scheduler.py

@@ -1,6 +1,6 @@
 from abc import ABC, abstractmethod
 from orionis.console.contracts.schedule import ISchedule
-from orionis.console.entities.job_error import JobError
+from orionis.console.entities.scheduler_error import SchedulerError
 from orionis.console.entities.scheduler_paused import SchedulerPaused
 from orionis.console.entities.scheduler_resumed import SchedulerResumed
 from orionis.console.entities.scheduler_shutdown import SchedulerShutdown
@@ -157,17 +157,17 @@ class IBaseScheduler(ABC):
         pass
 
     @abstractmethod
-    async def onError(self, event: JobError, schedule: ISchedule):
+    async def onError(self, event: SchedulerError, schedule: ISchedule):
         """
         Handles the event triggered when a job encounters an error during execution.
 
-        This method is invoked when a job fails due to an exception. It processes the `JobError`
+        This method is invoked when a job fails due to an exception. It processes the `SchedulerError`
         event and performs any necessary actions, such as logging the error details or notifying
         relevant systems about the failure.
 
         Parameters
         ----------
-        event : JobError
+        event : SchedulerError
             The event object containing details about the job error, including the job ID,
             the exception that occurred, and any relevant metadata.
         schedule : ISchedule

{orionis-0.566.0 → orionis-0.568.0}/orionis/console/entities/command.py

@@ -12,14 +12,16 @@ class Command(BaseEntity):
     ----------
     obj : Type
         The type or class associated with the command.
-    timestamps : bool
-        Whether timestamps are enabled for this command.
+    method : str, optional
+        The method name to be invoked on the object. Defaults to 'hanldle'.
+    timestamps : bool, optional
+        Whether timestamps are enabled for this command. Defaults to True.
     signature : str
         The signature string representing the command usage.
     description : str
         A brief description of what the command does.
     args : Optional[argparse.ArgumentParser], optional
-        Optional argument parser for command-line arguments.
+        Optional argument parser for command-line arguments. Defaults to None.
 
     Returns
     -------
@@ -30,11 +32,11 @@ class Command(BaseEntity):
     # The type or class associated with the command
     obj: Type
 
-    # The method name to be invoked on the object
+    # The method name to be invoked on the object (default: 'hanldle')
     method: str = 'hanldle'
 
-    # Indicates if timestamps are enabled for this command
-    timestamps: bool
+    # Indicates if timestamps are enabled for this command (default: True)
+    timestamps: bool = True
 
     # The command usage signature
     signature: str
@@ -42,5 +44,5 @@ class Command(BaseEntity):
     # Description of the command's purpose
     description: str
 
-    # Optional argument parser for command-line arguments
+    # Optional argument parser for command-line arguments (default: None)
     args: Optional[argparse.ArgumentParser] = None

{orionis-0.566.0 → orionis-0.568.0}/orionis/console/entities/event.py

@@ -9,30 +9,37 @@ from orionis.console.contracts.schedule_event_listener import IScheduleEventList
 @dataclass(kw_only=True)
 class Event:
     """
-    Represents an event with scheduling and execution details.
+    Represents a scheduled event with configuration for execution, timing, and event handling.
 
-    Attributes
+    Parameters
     ----------
     signature : str
-        The unique identifier or signature of the event, used to distinguish it from other events.
-    args : Optional[List[str]]
-        A list of arguments associated with the event. Defaults to an empty list if not provided.
-    purpose : Optional[str]
-        A brief description of the event's purpose or intent. Can be None if not specified.
-    random_delay : Optional[int]
-        An optional random delay (in seconds) to be applied before the event is triggered. Can be None.
-    start_date : Optional[datetime]
-        The start date and time for the event. If None, the event starts immediately or based on the trigger.
-    end_date : Optional[datetime]
-        The end date and time for the event. If None, the event does not have a defined end time.
-    trigger : Optional[Union[CronTrigger, DateTrigger, IntervalTrigger]]
-        The trigger mechanism for the event, which determines when and how the event is executed.
-        Can be a CronTrigger, DateTrigger, or IntervalTrigger. Defaults to None.
-    details : Optional[str]
-        Additional details or metadata about the event. Can be None if not specified.
-    listener : Optional[IScheduleEventListener]
-        An optional listener object that implements the IScheduleEventListener interface.
-        This listener can handle event-specific logic. Defaults to None.
+        Unique identifier or signature for the event.
+    args : Optional[List[str]], default: []
+        List of arguments to be passed to the event.
+    purpose : Optional[str], default: None
+        Short description of the event's purpose.
+    random_delay : Optional[int], default: None
+        Random delay in seconds before the event is triggered.
+    start_date : Optional[datetime], default: None
+        The date and time when the event becomes active.
+    end_date : Optional[datetime], default: None
+        The date and time when the event is no longer active.
+    trigger : Optional[Union[CronTrigger, DateTrigger, IntervalTrigger]], default: None
+        Trigger mechanism that determines when the event is executed.
+    details : Optional[str], default: None
+        Additional metadata or information about the event.
+    listener : Optional[IScheduleEventListener], default: None
+        Listener object implementing IScheduleEventListener for event-specific logic.
+    max_instances : int, default: 1
+        Maximum number of concurrent instances allowed for the event.
+    misfire_grace_time : Optional[int], default: None
+        Grace period in seconds for handling misfired events.
+
+    Returns
+    -------
+    Event
+        An instance of the Event class with the specified configuration.
     """
 
     # Unique identifier for the event
@@ -66,4 +73,4 @@ class Event:
     max_instances: int = 1
 
     # Grace time in seconds for misfired events
-    misfire_grace_time : Optional[int] = None
+    misfire_grace_time: Optional[int] = None

orionis-0.568.0/orionis/console/entities/event_job.py

@@ -0,0 +1,74 @@
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any, Callable, Optional, Tuple
+
+@dataclass(kw_only=True)
+class EventJob:
+    """
+    Represents the main properties and configuration of a scheduled job in APScheduler.
+
+    Parameters
+    ----------
+    id : str
+        Unique identifier for the job.
+    code : int, optional
+        Numeric code representing the job status or type. Defaults to 0.
+    name : Optional[str], optional
+        Human-readable name for the job. Defaults to None.
+    func : Callable[..., Any], optional
+        The function or coroutine to be executed by the job. Defaults to None.
+    args : Tuple[Any, ...], optional
+        Positional arguments to be passed to the function. Defaults to empty tuple.
+    trigger : Any, optional
+        The trigger that determines the job's execution schedule (e.g., IntervalTrigger, CronTrigger). Defaults to None.
+    executor : str, optional
+        Alias of the executor that will run the job. Defaults to 'default'.
+    jobstore : str, optional
+        Alias of the job store where the job is stored. Defaults to 'default'.
+    misfire_grace_time : Optional[int], optional
+        Grace period in seconds for handling missed executions. If None, no grace period is applied. Defaults to None.
+    max_instances : int, optional
+        Maximum number of concurrent instances of the job allowed. Defaults to 1.
+    coalesce : bool, optional
+        Whether to merge pending executions into a single execution. Defaults to False.
+    next_run_time : Optional[datetime], optional
+        The next scheduled execution time of the job. Can be None if the job is paused or unscheduled. Defaults to None.
+    exception : Optional[BaseException], optional
+        Exception raised during the last job execution, if any. Defaults to None.
+    traceback : Optional[str], optional
+        String representation of the traceback if an exception occurred. Defaults to None.
+    retval : Optional[Any], optional
+        Return value from the last job execution. Defaults to None.
+    purpose : Optional[str], optional
+        Description of the job's purpose. Defaults to None.
+    start_date : Optional[datetime], optional
+        The earliest possible run time for the job. Defaults to None.
+    end_date : Optional[datetime], optional
+        The latest possible run time for the job. Defaults to None.
+    details : Optional[str], optional
+        Additional details or metadata about the job. Defaults to None.
+
+    Returns
+    -------
+    None
+        This class is a data container and does not return any value upon instantiation.
+    """
+    id: str                                         # Unique identifier for the job
+    code: int = 0                                   # Numeric code for job status/type
+    name: Optional[str] = None                      # Human-readable job name
+    func: Callable[..., Any] = None                 # Function or coroutine to execute
+    args: Tuple[Any, ...] = ()                      # Positional arguments for the function
+    trigger: Any = None                             # Scheduling trigger (e.g., interval, cron)
+    executor: str = 'default'                       # Executor alias
+    jobstore: str = 'default'                       # Job store alias
+    misfire_grace_time: Optional[int] = None        # Grace period for missed executions
+    max_instances: int = 1                          # Max concurrent job instances
+    coalesce: bool = False                          # Merge pending executions if True
+    next_run_time: Optional[datetime] = None        # Next scheduled execution time
+    exception: Optional[BaseException] = None       # Exception from last execution
+    traceback: Optional[str] = None                 # Traceback string if exception occurred
+    retval: Optional[Any] = None                    # Return value from last execution
+    purpose: Optional[str] = None                   # Description of job's purpose
+    start_date: Optional[datetime] = None           # Earliest run time
+    end_date: Optional[datetime] = None             # Latest run time
+    details: Optional[str] = None                   # Additional job details or metadata

orionis-0.568.0/orionis/console/entities/scheduler_error.py

@@ -0,0 +1,32 @@
+from dataclasses import dataclass
+from typing import Optional
+from orionis.console.entities.scheduler_event_data import SchedulerEventData
+
+@dataclass(kw_only=True)
+class SchedulerError(SchedulerEventData):
+    """
+    Represents an error event triggered by the scheduler.
+
+    This data class extends `SchedulerEventData` and is used to encapsulate
+    information related to errors that occur during scheduler operations.
+    It stores the exception that caused the error and the associated traceback
+    for debugging and logging purposes.
+
+    Attributes
+    ----------
+    exception : Optional[BaseException]
+        The exception instance that caused the scheduler error, if any.
+    traceback : Optional[str]
+        The traceback string providing details about where the error occurred.
+
+    Returns
+    -------
+    SchedulerError
+        An instance containing details about the scheduler error event.
+    """
+
+    # Exception that caused the scheduler error, if present
+    exception: Optional[BaseException] = None
+
+    # Traceback information related to the scheduler error, if available
+    traceback: Optional[str] = None

orionis-0.568.0/orionis/console/entities/scheduler_event_data.py

@@ -0,0 +1,24 @@
+from dataclasses import dataclass
+
+@dataclass(kw_only=True)
+class SchedulerEventData:
+    """
+    Base data structure for scheduler-related events.
+
+    This class encapsulates information about events that occur within the scheduler system.
+    It provides a numeric event code to identify the event type and can be extended for
+    additional context as needed.
+
+    Parameters
+    ----------
+    code : int
+        Numeric code that uniquely identifies the type of event within the scheduler system.
+
+    Returns
+    -------
+    SchedulerEventData
+        An instance of SchedulerEventData containing the event code.
+    """
+
+    # Numeric code representing the type of event
+    code: int

orionis-0.568.0/orionis/console/entities/scheduler_paused.py

@@ -0,0 +1,25 @@
+from dataclasses import dataclass
+from orionis.console.entities.scheduler_event_data import SchedulerEventData
+
+@dataclass(kw_only=True)
+class SchedulerPaused(SchedulerEventData):
+    """
+    Represents an event triggered when the scheduler is paused.
+
+    This data class extends `SchedulerEventData` and encapsulates information
+    related to the scheduler pause event, such as the time at which the pause occurred.
+
+    Attributes
+    ----------
+    time : str
+        The time when the scheduler was paused, formatted as a string.
+    (Other attributes are inherited from SchedulerEventData.)
+
+    Returns
+    -------
+    SchedulerPaused
+        An instance of SchedulerPaused containing information about the pause event.
+    """
+
+    # The time when the scheduler was paused
+    time: str

orionis-0.568.0/orionis/console/entities/scheduler_resumed.py

@@ -0,0 +1,24 @@
+from dataclasses import dataclass
+from orionis.console.entities.scheduler_event_data import SchedulerEventData
+
+@dataclass(kw_only=True)
+class SchedulerResumed(SchedulerEventData):
+    """
+    Represents an event triggered when the scheduler is resumed.
+
+    This data class extends `SchedulerEventData` and is used to encapsulate
+    information about the scheduler's resumption event.
+
+    Attributes
+    ----------
+    time : str
+        The time when the scheduler was resumed.
+
+    Returns
+    -------
+    SchedulerResumed
+        An instance containing information about the resumed scheduler event.
+    """
+
+    # The time when the scheduler was resumed
+    time: str

orionis-0.568.0/orionis/console/entities/scheduler_shutdown.py

@@ -0,0 +1,31 @@
+from dataclasses import dataclass, field
+from orionis.console.entities.scheduler_event_data import SchedulerEventData
+
+@dataclass(kw_only=True)
+class SchedulerShutdown(SchedulerEventData):
+    """
+    Represents an event triggered when the scheduler shuts down.
+
+    This class extends `SchedulerEventData` and is used to encapsulate
+    information related to the shutdown of the scheduler, such as the
+    shutdown time and the list of tasks present at shutdown.
+
+    Attributes
+    ----------
+    time : str
+        The time when the scheduler was shut down.
+    tasks : list
+        The list of tasks that were scheduled at the time of shutdown.
+
+    Returns
+    -------
+    SchedulerShutdown
+        An instance representing the scheduler shutdown event, containing
+        the shutdown time and the list of scheduled tasks.
+    """
+
+    # The time when the scheduler was shut down
+    time: str = ""
+
+    # List of tasks scheduled at the time of shutdown
+    tasks: list = field(default_factory=list)

orionis-0.568.0/orionis/console/entities/scheduler_started.py

@@ -0,0 +1,30 @@
+from dataclasses import dataclass, field
+from orionis.console.entities.scheduler_event_data import SchedulerEventData
+
+@dataclass(kw_only=True)
+class SchedulerStarted(SchedulerEventData):
+    """
+    Represents the event data generated when the scheduler starts.
+
+    This data class extends `SchedulerEventData` and encapsulates information
+    about the scheduler's start event, such as the start time and the list of
+    tasks scheduled at that moment.
+
+    Attributes
+    ----------
+    time : str
+        The time when the scheduler started.
+    tasks : list
+        The list of tasks that were scheduled at the time the scheduler started.
+
+    Returns
+    -------
+    SchedulerStarted
+        An instance containing the scheduler start event data.
+    """
+
+    # The time when the scheduler started
+    time: str = ""
+
+    # List of tasks scheduled at the time of start
+    tasks: list = field(default_factory=list)

orionis-0.568.0/orionis/console/enums/actions.py

@@ -0,0 +1,62 @@
+from enum import Enum
+
+class ArgumentAction(Enum):
+    """
+    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 corresponding argparse action type.
+    """
+
+    # Stores the argument value directly
+    STORE = "store"
+
+    # Stores a constant value when the argument is specified
+    STORE_CONST = "store_const"
+
+    # Stores True when the argument is specified
+    STORE_TRUE = "store_true"
+
+    # Stores False when the argument is specified
+    STORE_FALSE = "store_false"
+
+    # Appends each argument value to a list
+    APPEND = "append"
+
+    # Appends a constant value to a list when the argument is specified
+    APPEND_CONST = "append_const"
+
+    # Counts the number of times the argument is specified
+    COUNT = "count"
+
+    # Displays the help message and exits the program
+    HELP = "help"
+
+    # Displays version information and exits the program
+    VERSION = "version"

orionis-0.568.0/orionis/console/enums/listener.py

@@ -0,0 +1,61 @@
+from enum import Enum
+
+class ListeningEvent(Enum):
+    """
+    Enumeration of scheduler and job-related events.
+
+    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
+        Triggered when the scheduler starts.
+    SCHEDULER_SHUTDOWN : str
+        Triggered when the scheduler shuts down.
+    SCHEDULER_PAUSED : str
+        Triggered when the scheduler is paused.
+    SCHEDULER_RESUMED : str
+        Triggered when the scheduler is resumed.
+    SCHEDULER_ERROR : str
+        Triggered when the scheduler encounters an error.
+    JOB_BEFORE : str
+        Triggered before a job is executed.
+    JOB_AFTER : str
+        Triggered after a job is executed.
+    JOB_ON_FAILURE : str
+        Triggered when a job fails.
+    JOB_ON_MISSED : str
+        Triggered when a job is missed.
+    JOB_ON_MAXINSTANCES : str
+        Triggered when a job exceeds its maximum allowed instances.
+    JOB_ON_PAUSED : str
+        Triggered when a job is paused.
+    JOB_ON_RESUMED : str
+        Triggered when a paused job is resumed.
+    JOB_ON_REMOVED : str
+        Triggered when a job is removed.
+
+    Returns
+    -------
+    str
+        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
+
+    # 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

orionis-0.568.0/orionis/console/enums/styles.py

@@ -0,0 +1,104 @@
+from enum import Enum
+
+class ANSIColors(Enum):
+    """
+    ANSI escape codes for styling text and backgrounds in terminal applications.
+
+    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
+        ANSI code to reset all colors and styles to the terminal's default.
+    BG_INFO : str
+        ANSI code for a blue background, typically used for informational messages.
+    BG_ERROR : str
+        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
+        ANSI code for a yellow background, typically used for warnings.
+    BG_SUCCESS : str
+        ANSI code for a green background, typically used for success messages.
+    TEXT_INFO : str
+        ANSI code for blue foreground text, used for informational messages.
+    TEXT_ERROR : str
+        ANSI code for bright red foreground text, used for errors.
+    TEXT_WARNING : str
+        ANSI code for yellow foreground text, used for warnings.
+    TEXT_SUCCESS : str
+        ANSI code for green foreground text, used for success messages.
+    TEXT_WHITE : str
+        ANSI code for white foreground text, useful for contrast.
+    TEXT_MUTED : str
+        ANSI code for gray (muted) foreground text, used for secondary information.
+    TEXT_BOLD_INFO : str
+        ANSI code for bold blue foreground text, emphasizing informational messages.
+    TEXT_BOLD_ERROR : str
+        ANSI code for bold red foreground text, emphasizing errors.
+    TEXT_BOLD_WARNING : str
+        ANSI code for bold yellow foreground text, emphasizing warnings.
+    TEXT_BOLD_SUCCESS : str
+        ANSI code for bold green foreground text, emphasizing success messages.
+    TEXT_BOLD_WHITE : str
+        ANSI code for bold white foreground text, for strong contrast.
+    TEXT_BOLD_MUTED : str
+        ANSI code for bold gray (muted) foreground text, for emphasized secondary information.
+    TEXT_BOLD : str
+        ANSI code for bold text style.
+    TEXT_STYLE_UNDERLINE : str
+        ANSI code for underlined text style.
+    TEXT_RESET : str
+        ANSI code to reset text styles to default settings.
+    CYAN : str
+        ANSI code for cyan foreground text, for special emphasis.
+    DIM : str
+        ANSI code for dimmed foreground text, for subtle emphasis.
+    MAGENTA : str
+        ANSI code for magenta foreground text, for special emphasis.
+    ITALIC : str
+        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 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 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 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 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