orionis 0.25.0__py3-none-any.whl → 0.27.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/bootstrap/cli_exception.py

@@ -0,0 +1,54 @@
+class BootstrapRuntimeError(RuntimeError):
+    """
+    Exception raised for errors related to dumping Orionis data.
+
+    Parameters
+    ----------
+    message : str
+        The error message describing the issue.
+
+    Attributes
+    ----------
+    message : str
+        The stored error message.
+
+    Methods
+    -------
+    __str__()
+        Returns a user-friendly string representation of the exception.
+    __repr__()
+        Returns a detailed representation for debugging purposes.
+    """
+
+    def __init__(self, message: str):
+        """
+        Initialize the exception with a message.
+
+        Parameters
+        ----------
+        message : str
+            The error message describing the issue.
+        """
+        super().__init__(f"[BootstrapRuntimeError]: {message}")
+
+    def __str__(self) -> str:
+        """
+        Returns a user-friendly string representation.
+
+        Returns
+        -------
+        str
+            A formatted error message.
+        """
+        return self.args[0]
+
+    def __repr__(self) -> str:
+        """
+        Returns a detailed representation for debugging.
+
+        Returns
+        -------
+        str
+            A detailed string representation including the exception name.
+        """
+        return f"{self.__class__.__name__}({self.args[0]!r})"

orionis/luminate/bootstrap/commands/bootstrapper.py

@@ -0,0 +1,99 @@
+import pathlib
+import importlib
+import inspect
+from orionis.luminate.bootstrap.cli_exception import BootstrapRuntimeError
+from orionis.luminate.bootstrap.commands.register import Register
+from orionis.luminate.console.base.command import BaseCommand
+from orionis.luminate.contracts.bootstrap.commands.bootstrapper_interface import IBootstrapper
+
+class Bootstrapper(IBootstrapper):
+    """
+    Manages the automatic loading and registration of command classes
+    from Python files located in predefined directories.
+
+    The `Bootstrapper` class scans specific directories for Python files, dynamically
+    imports them, and registers classes that inherit from `BaseCommand`.
+
+    Attributes
+    ----------
+    register : Register
+        An instance of the `Register` class used to register command classes.
+
+    Methods
+    -------
+    __init__(register: Register) -> None
+        Initializes the `Bootstrapper` with a `Register` instance and triggers autoloading.
+    _autoload() -> None
+        Scans predefined directories for Python files, dynamically imports modules,
+        and registers classes that extend `BaseCommand`.
+    """
+
+    def __init__(self, register: Register) -> None:
+        """
+        Initializes the `Bootstrapper` with a `Register` instance and triggers autoloading.
+
+        Parameters
+        ----------
+        register : Register
+            An instance of the `Register` class used to register command classes.
+        """
+        self.register = register
+        self._autoload()
+
+    def _autoload(self) -> None:
+        """
+        Autoloads command modules from specified directories and registers command classes.
+
+        This method searches for Python files in the predefined command directories,
+        dynamically imports the modules, and registers classes that inherit from `BaseCommand`.
+
+        The command directories searched are:
+        - `app/console/commands` relative to the current working directory.
+        - `console/commands` relative to the parent directory of the current file.
+
+        It skips `__init__.py` files and ignores directories that do not exist.
+
+        Raises
+        ------
+        BootstrapRuntimeError
+            If an error occurs while loading a module.
+        """
+
+        # Define the base project path
+        base_path = pathlib.Path.cwd()
+
+        # Define the command directories to search
+        command_dirs = [
+            base_path / "app" / "console" / "commands",
+            pathlib.Path(__file__).resolve().parent.parent / "console" / "commands"
+        ]
+
+        # Iterate over each command directory
+        for cmd_dir in command_dirs:
+
+            # Skip if the directory does not exist
+            if not cmd_dir.is_dir():
+                continue
+
+            # Iterate over Python files in the directory (recursive search)
+            for file_path in cmd_dir.rglob("*.py"):
+
+                # Skip `__init__.py` files
+                if file_path.name == "__init__.py":
+                    continue
+
+                # Convert file path to a Python module import path
+                module_path = ".".join(file_path.relative_to(base_path).with_suffix("").parts)
+
+                try:
+                    # Dynamically import the module
+                    module = importlib.import_module(module_path)
+
+                    # Find classes that inherit from `BaseCommand`
+                    for name, obj in inspect.getmembers(module, inspect.isclass):
+                        if issubclass(obj, BaseCommand) and obj is not BaseCommand:
+                            # Register the class
+                            self.register.command(obj)
+
+                except Exception as e:
+                    raise BootstrapRuntimeError(f"Error loading {module_path}") from e

orionis/luminate/{console → bootstrap/commands}/register.py

@@ -1,6 +1,7 @@
+from typing import Any, Callable
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.cache.console.commands import CacheCommands
-from orionis.luminate.contracts.console.register_interface import IRegister
+from orionis.luminate.contracts.bootstrap.commands.register_interface import IRegister
 
 class Register(IRegister):
     """
@@ -12,13 +13,13 @@ class Register(IRegister):
         A dictionary storing registered command classes.
     """
 
-    def __init__(self, cache : CacheCommands = None):
+    def __init__(self, cache : CacheCommands):
         """
         Initializes the Register instance and prepares the cache commands system.
         """
-        self.cache_commands = cache or CacheCommands()
+        self.cache_commands = cache
 
-    def command(self, command_class):
+    def command(self, command_class: Callable[..., Any]) -> None:
         """
         Registers a command class after validating its structure.
 
@@ -84,15 +85,8 @@ class Register(IRegister):
 
         # Register the command
         self.cache_commands.register(
-            instance=command_class,
+            concrete=command_class,
             arguments=arguments,
             description=description,
             signature=signature
-        )
-
-        # Return Class
-        return command_class
-
-
-# Return Decorator.
-register = Register()
+        )

orionis/luminate/bootstrap/config/bootstrapper.py

@@ -1,5 +1,6 @@
 import importlib
 import pathlib
+from orionis.luminate.bootstrap.cli_exception import BootstrapRuntimeError
 from orionis.luminate.bootstrap.config.register import Register
 from orionis.luminate.contracts.bootstrap.config.bootstrapper_interface import IBootstrapper
 
@@ -74,5 +75,5 @@ class Bootstrapper(IBootstrapper):
                 if hasattr(module, "Config"):
                     self.register.config(getattr(module, "Config"))
             except Exception as e:
-                raise RuntimeError(f"Error loading module {module_path}") from e
+                raise BootstrapRuntimeError(f"Error loading module {module_path}") from e
 

orionis/luminate/cache/app/config.py

@@ -1,15 +1,22 @@
 from typing import Dict, Any
+from orionis.luminate.contracts.cache.app.config_interface import ICacheConfig
 
-class CacheConfig:
+class CacheConfig(ICacheConfig):
     """
-    This class ensures that configuration sections are registered only once
-    and provides methods to register, unregister, and retrieve configurations.
+    CacheConfig is a class that manages the registration, unregistration, and retrieval of configuration sections.
 
-    Attributes
-    ----------
-    config : dict
-        A dictionary storing registered configuration sections.
+    Methods
+    -------
+    __init__()
+        Initializes a new instance of the class with an empty configuration dictionary.
+    register(section: str, data: Dict[str, Any])
+        Registers a configuration section with its associated data.
+    unregister(section: str)
+        Unregisters a previously registered configuration section.
+    get(section: str)
+        Retrieves the configuration data for a specific section.
     """
+
     def __init__(self) -> None:
         """
         Initializes a new instance of the class with an empty configuration dictionary.

orionis/luminate/cache/console/commands.py

@@ -1,33 +1,32 @@
-from orionis.luminate.contracts.cache.cache_commands_interface import ICacheCommands
+from typing import Any, Callable
+from orionis.luminate.contracts.cache.console.commands_interface import ICacheCommands
 
 class CacheCommands(ICacheCommands):
     """
-    Singleton class for managing a cache of commands.
+    CacheCommands is a class that manages the registration, unregistration, and retrieval of command instances.
 
-    This class ensures that only one instance of the command cache exists
-    and provides methods for registering, unregistering, and retrieving commands.
+    Methods
+    -------
+    __init__()
+        Initializes the command cache with an empty dictionary.
+    register(signature: str, description: str, arguments: list, concrete: Callable[..., Any])
+        Register a new command with its signature, description, and class instance.
+    unregister(signature: str)
+        Unregister an existing command by its signature.
+    get(signature: str)
+        Retrieve the information of a registered command by its signature.
     """
 
-    _instance = None
+    def __init__(self):
 
-    def __new__(cls, *args, **kwargs):
         """
-        Create or return the singleton instance of the CacheCommands class.
+        Initializes the command cache.
 
-        Ensures that only one instance of the CacheCommands class exists
-        during the lifetime of the application.
-
-        Returns
-        -------
-        CacheCommands
-            The singleton instance of the class.
+        This constructor sets up an empty dictionary to store commands.
         """
-        if cls._instance is None:
-            cls._instance = super().__new__(cls, *args, **kwargs)
-            cls._instance.commands = {}
-        return cls._instance
+        self.commands = {}
 
-    def register(self, signature: str, description: str, arguments: list, instance):
+    def register(self, signature: str, description: str, arguments: list, concrete: Callable[..., Any]):
         """
         Register a new command with its signature, description, and class instance.
 
@@ -37,7 +36,7 @@ class CacheCommands(ICacheCommands):
             The unique identifier (signature) for the command.
         description : str
             A brief description of what the command does.
-        instance : class
+        concrete : class
             The class or callable instance that defines the command behavior.
 
         Raises
@@ -49,7 +48,7 @@ class CacheCommands(ICacheCommands):
             raise ValueError(f"Command '{signature}' is already registered. Please ensure signatures are unique.")
 
         self.commands[signature] = {
-            'instance':instance,
+            'concrete':concrete,
             'arguments':arguments,
             'description':description,
             'signature':signature

orionis/luminate/console/base/command.py

@@ -1,6 +1,6 @@
 from orionis.luminate.console.output.console import Console
 from orionis.luminate.console.output.progress_bar import ProgressBar
-from orionis.luminate.contracts.console.base_command_interface import IBaseCommand
+from orionis.luminate.contracts.console.base.base_command_interface import IBaseCommand
 
 class BaseCommand(IBaseCommand):
     """

orionis/luminate/console/cache.py

@@ -1,59 +1,25 @@
 import os
-from threading import Lock
 from orionis.luminate.tools.reflection import Reflection
-from orionis.luminate.cache.console.commands import CacheCommands
-from orionis.luminate.contracts.console.cli_cache_interface import ICLICache
 
-class CLICache(ICLICache):
+class CLICache:
     """
-    Singleton class responsible for managing the loading and execution of commands within the framework.
+    Class responsible for managing the loading and execution of commands within the framework.
 
-    This class ensures that commands are loaded only once and are accessible for execution. It is designed to follow
-    the Singleton pattern, meaning only one instance of this class will exist in the application lifecycle.
+    This class ensures that commands are loaded only once and are accessible for execution.
 
     Attributes
     ----------
-    _instance : CLICache
-        The singleton instance of the CLICache class.
-    _lock : threading.Lock
-        A lock used to ensure thread-safety during instance creation.
-    _initialized : bool
-        A flag indicating whether the class has been initialized.
     paths : list
         List of directories where commands are located.
 
     Methods
     -------
-    __new__ :
-        Creates and returns the singleton instance of the CLICache class.
     __init__ :
         Initializes the CLICache instance, loading commands if not already initialized.
     _load_commands :
         Loads command modules from predefined directories and imports them dynamically.
-    getCommands :
-        Returns the instance of CacheCommands containing the command cache.
     """
 
-    _instance = None
-    _lock = Lock()
-
-    def __new__(cls):
-        """
-        Ensures only one instance of the CLICache class exists (Singleton pattern).
-
-        This method is responsible for controlling the instance creation process, ensuring that no more than one
-        CLICache instance is created in the system, even in multi-threaded environments.
-
-        Returns
-        -------
-        CLICache
-            The singleton instance of the CLICache class.
-        """
-        with cls._lock:
-            if cls._instance is None:
-                cls._instance = super(CLICache, cls).__new__(cls)
-                cls._instance._initialized = False
-        return cls._instance
 
     def __init__(self) -> None:
         """
@@ -67,12 +33,8 @@ class CLICache(ICLICache):
         paths : list
             List of directories containing command files to be loaded.
         """
-        if self._initialized:
-            return
-
         self.paths = []
         self._load_commands()
-        self._initialized = True
 
     def _load_commands(self):
         """
@@ -110,23 +72,16 @@ class CLICache(ICLICache):
                     pre_module = current_directory.replace(base_path, '').replace(os.sep, '.').lstrip('.')
                     for file in files:
                         if file.endswith('.py'):
-                            # Construct the module name and path
-                            module_name = file[:-3]  # Remove the '.py' extension
-                            module_path = f"{pre_module}.{module_name}".replace('venv.Lib.site-packages.', '')
 
-                            # Use Reflection to load the module dynamically
-                            Reflection(module=module_path)
+                            # Remove the '.py' extension
+                            module_name = file[:-3]
 
-    def getCommands(self):
-        """
-        Returns the instance of the CacheCommands containing the command cache.
+                            # Construct the full module path
+                            module_path = f"{pre_module}.{module_name}"
 
-        This method provides access to the CacheCommands instance, which holds the loaded commands cache
-        and makes it available for use.
+                            # Remove the 'site-packages' prefix from the module path
+                            if 'site-packages.' in module_path:
+                                module_path = module_path.split('site-packages.')[1]
 
-        Returns
-        -------
-        CacheCommands
-            The instance of CacheCommands that holds the cached commands.
-        """
-        return CacheCommands()
+                            # Use Reflection to load the module dynamically
+                            Reflection(module=module_path)

orionis/luminate/console/commands/cache_clear.py

@@ -1,9 +1,8 @@
 import os
 import shutil
-from orionis.luminate.console.register import register
 from orionis.luminate.console.base.command import BaseCommand
+from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 
-@register.command
 class CacheClearCommand(BaseCommand):
     """
     Clears Python bytecode caches (__pycache__) within the project directory.
@@ -48,9 +47,9 @@ class CacheClearCommand(BaseCommand):
                         shutil.rmtree(pycache_path)
 
             # Log a success message once all caches are cleared
-            self.success(message='The application cache has been successfully cleared.', timestamp=True)
+            self.success(message='The application cache has been successfully cleared.')
 
         except Exception as e:
 
             # Handle any unexpected error and display the error message
-            raise RuntimeError(f"An unexpected error occurred while clearing the cache: {e}") from e
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred while clearing the cache: {e}") from e

orionis/luminate/console/commands/help.py

@@ -1,8 +1,7 @@
-from orionis.luminate.console.register import register
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.cache.console.commands import CacheCommands
+from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 
-@register.command
 class HelpCommand(BaseCommand):
     """
     Command class to display the list of available commands in the Orionis application.
@@ -55,5 +54,5 @@ class HelpCommand(BaseCommand):
 
         except Exception as e:
 
-            # Raise a ValueError if an unexpected error occurs.
-            raise ValueError(f"An unexpected error occurred: {e}") from e
+            # Handle any unexpected error and display the error message
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/luminate/console/commands/schedule_work.py

@@ -1,9 +1,8 @@
-from orionis.luminate.console.register import register
 from orionis.luminate.console.base.command import BaseCommand
+from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 from orionis.luminate.console.tasks.scheduler import Schedule
 from orionis.luminate.contracts.console.task_manager_interface import ITaskManager
 
-@register.command
 class ScheduleWorkCommand(BaseCommand):
     """
     Command class to handle scheduled tasks within the Orionis application.
@@ -46,5 +45,5 @@ class ScheduleWorkCommand(BaseCommand):
 
         except Exception as e:
 
-            # Raise a RuntimeError if an unexpected error occurs.
-            raise RuntimeError(f"An unexpected error occurred: {e}") from e
+            # Handle any unexpected error and display the error message
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/luminate/console/commands/tests.py

@@ -1,8 +1,7 @@
+from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 from orionis.luminate.facades.tests import UnitTests
-from orionis.luminate.console.register import register
 from orionis.luminate.console.base.command import BaseCommand
 
-@register.command
 class TestsCommand(BaseCommand):
     """
     Command class to display the list of available commands in the Orionis application.
@@ -36,5 +35,5 @@ class TestsCommand(BaseCommand):
 
         except Exception as e:
 
-            # Raise a ValueError if an unexpected error occurs.
-            raise ValueError(f"An unexpected error occurred: {e}") from e
+            # Handle any unexpected error and display the error message
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/luminate/console/commands/version.py

@@ -1,8 +1,7 @@
 from orionis.framework import VERSION
-from orionis.luminate.console.register import register
 from orionis.luminate.console.base.command import BaseCommand
+from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 
-@register.command
 class VersionCommand(BaseCommand):
     """
     Command class to display the current version of the Orionis framework.
@@ -35,5 +34,5 @@ class VersionCommand(BaseCommand):
 
         except Exception as e:
 
-            # Raise a ValueError if an unexpected error occurs.
-            raise ValueError(f"An unexpected error occurred: {e}") from e
+            # Handle any unexpected error and display the error message
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/luminate/console/exceptions/cli_exception.py

@@ -125,3 +125,46 @@ class CLIOrionisScheduleException(Exception):
             A string containing the exception name and the response message.
         """
         return f"[CLIOrionisScheduleException]: {self.args[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/luminate/console/kernel.py

@@ -1,4 +1,4 @@
-from typing import Any, Tuple
+from typing import Any
 from orionis.luminate.console.runner import CLIRunner
 from orionis.luminate.contracts.console.kernel_interface import ICLIKernel
 

orionis/luminate/console/output/console.py

@@ -3,7 +3,7 @@ import sys
 import getpass
 import datetime
 from orionis.luminate.console.output.styles import ANSIColors
-from orionis.luminate.contracts.console.console_interface import IConsole
+from orionis.luminate.contracts.console.output.console_interface import IConsole
 
 class Console(IConsole):
     """

orionis/luminate/console/output/executor.py

@@ -1,6 +1,6 @@
 from datetime import datetime
 from orionis.luminate.console.output.styles import ANSIColors
-from orionis.luminate.contracts.console.executor_interface import IExecutor
+from orionis.luminate.contracts.console.output.executor_interface import IExecutor
 
 class Executor(IExecutor):
     """

orionis/luminate/console/output/progress_bar.py

@@ -1,5 +1,5 @@
 import sys
-from orionis.luminate.contracts.console.progress_bar_interface import IProgressBar
+from orionis.luminate.contracts.console.output.progress_bar_interface import IProgressBar
 
 class ProgressBar(IProgressBar):
     """

orionis/luminate/console/scripts/management.py

@@ -1,7 +1,7 @@
 from orionis.luminate.installer.setup import Setup
 from orionis.luminate.installer.output import Output
 from orionis.luminate.installer.upgrade import Upgrade
-from orionis.luminate.contracts.console.management_interface import IManagement
+from orionis.luminate.contracts.console.scripts.management_interface import IManagement
 
 class Management(IManagement):
     """

orionis/luminate/console/tasks/scheduler.py

@@ -8,7 +8,7 @@ from apscheduler.triggers.cron import CronTrigger
 from orionis.luminate.console.command import Command
 from apscheduler.triggers.interval import IntervalTrigger
 from apscheduler.schedulers.background import BackgroundScheduler
-from orionis.luminate.contracts.console.schedule_interface import ISchedule
+from orionis.luminate.contracts.console.tasks.schedule_interface import ISchedule
 from orionis.luminate.console.exceptions.cli_exception import CLIOrionisScheduleException
 
 class Schedule(ISchedule):

orionis/luminate/container/container.py

@@ -64,10 +64,7 @@ class Container(IContainer):
             If the class is defined in the main module.
         """
         if concrete.__module__ == "__main__":
-            raise OrionisContainerValueError(
-                "Cannot register a class from the main module in the container."
-            )
-        return f"{concrete.__module__}.{concrete.__name__}"
+            raise OrionisContainerValueError("Cannot register a class from the main module in the container.")
 
     def _ensureUniqueService(self, obj: Any) -> None:
         """
@@ -101,9 +98,7 @@ class Container(IContainer):
             If the implementation is not callable.
         """
         if not callable(concrete):
-            raise OrionisContainerTypeError(
-                f"The implementation '{str(concrete)}' must be callable or an instantiable class."
-            )
+            raise OrionisContainerTypeError(f"The implementation '{str(concrete)}' must be callable or an instantiable class.")
 
     def _ensureIsInstance(self, instance: Any) -> None:
         """
@@ -120,9 +115,7 @@ class Container(IContainer):
             If the instance is not a valid object.
         """
         if not isinstance(instance, object) or instance.__class__.__module__ in ['builtins', 'abc']:
-            raise OrionisContainerValueError(
-                f"The instance '{str(instance)}' must be a valid object."
-            )
+            raise OrionisContainerValueError(f"The instance '{str(instance)}' must be a valid object.")
 
     def bind(self, concrete: Callable[..., Any]) -> str:
         """
@@ -142,7 +135,7 @@ class Container(IContainer):
 
         key = f"{concrete.__module__}.{concrete.__name__}"
         self._bindings[key] = {
-            'callback': concrete,
+            'concrete': concrete,
             'module': concrete.__module__,
             'name': concrete.__name__,
             'type': BINDING
@@ -165,7 +158,7 @@ class Container(IContainer):
 
         key = f"{concrete.__module__}.{concrete.__name__}"
         self._transients[key] = {
-            'callback': concrete,
+            'concrete': concrete,
             'module': concrete.__module__,
             'name': concrete.__name__,
             'type': TRANSIENT
@@ -190,7 +183,7 @@ class Container(IContainer):
 
         key = f"{concrete.__module__}.{concrete.__name__}"
         self._singletons[key] = {
-            'callback': concrete,
+            'concrete': concrete,
             'module': concrete.__module__,
             'name': concrete.__name__,
             'type': SINGLETON
@@ -215,7 +208,7 @@ class Container(IContainer):
 
         key = f"{concrete.__module__}.{concrete.__name__}"
         self._scoped_services[key] = {
-            'callback': concrete,
+            'concrete': concrete,
             'module': concrete.__module__,
             'name': concrete.__name__,
             'type': SCOPED
@@ -325,19 +318,19 @@ class Container(IContainer):
             return self._instances[key]['instance']
 
         if key in self._singletons:
-            self._instances[key] = {'instance': self._resolve(self._singletons[key]['callback'])}
+            self._instances[key] = {'instance': self._resolve(self._singletons[key]['concrete'])}
             return self._instances[key]['instance']
 
         if key in self._scoped_services:
             if key not in self._scoped_instances:
-                self._scoped_instances[key] = self._resolve(self._scoped_services[key]['callback'])
+                self._scoped_instances[key] = self._resolve(self._scoped_services[key]['concrete'])
             return self._scoped_instances[key]
 
         if key in self._transients:
-            return self._resolve(self._transients[key]['callback'])
+            return self._resolve(self._transients[key]['concrete'])
 
         if key in self._bindings:
-            return self._resolve(self._bindings[key]['callback'])
+            return self._resolve(self._bindings[key]['concrete'])
 
         raise OrionisContainerException(f"Service '{abstract}' is not registered in the container.")
 
@@ -362,8 +355,9 @@ class Container(IContainer):
 
         # Step 3: Iterate through the parameters of the constructor.
         for param_name, param in signature.parameters.items():
+
+            # Skip 'self' in methods
             if param_name == 'self':
-                # Skip 'self' in methods
                 continue
 
             # If parameter has no annotation and no default value, it's unresolved
@@ -374,15 +368,19 @@ class Container(IContainer):
             # Resolve dependencies based on annotations (excluding primitive types)
             if param.annotation is not param.empty:
                 param_type = param.annotation
+
                 # Check if it's a registered service, if so, resolve it through the container
                 if isinstance(param_type, type) and not isinstance(param_type, (int, str, bool, float)) and not issubclass(param_type, (int, str, bool, float)):
+
                     # Check if the service is registered in the container
                     if self.has(param_type):
                         resolved_dependencies[param_name] = self.make(f"{param_type.__module__}.{param_type.__name__}")
                     else:
                         resolved_dependencies[param_name] = self._resolve_dependency(param_type)
                 else:
-                    resolved_dependencies[param_name] = param_type  # It's a primitive, use as-is
+
+                    # It's a primitive, use as-is
+                    resolved_dependencies[param_name] = param_type
 
             # Resolve parameters with default values (without annotations)
             elif param.default is not param.empty:
@@ -407,8 +405,7 @@ class Container(IContainer):
         This method looks for the type in the container and returns the instance,
         respecting the lifecycle of the service (transient, singleton, etc.).
         """
-        # Check if the dependency exists in the container or create it if necessary
-        # If it's a class type
+        # Check if the dependency exists in the container or create it if necessary, If it's a class type
         if isinstance(dep_type, type):
             if self.has(dep_type):
                 # Resolves the service through the container

orionis/luminate/contracts/bootstrap/commands/bootstrapper_interface.py

@@ -0,0 +1,44 @@
+from abc import ABC, abstractmethod
+
+class IBootstrapper(ABC):
+    """
+    Manages the automatic loading and registration of command classes
+    from Python files located in predefined directories.
+
+    The `Bootstrapper` class scans specific directories for Python files, dynamically
+    imports them, and registers classes that inherit from `BaseCommand`.
+
+    Attributes
+    ----------
+    register : Register
+        An instance of the `Register` class used to register command classes.
+
+    Methods
+    -------
+    __init__(register: Register) -> None
+        Initializes the `Bootstrapper` with a `Register` instance and triggers autoloading.
+    _autoload() -> None
+        Scans predefined directories for Python files, dynamically imports modules,
+        and registers classes that extend `BaseCommand`.
+    """
+
+    @abstractmethod
+    def _autoload(self) -> None:
+        """
+        Autoloads command modules from specified directories and registers command classes.
+
+        This method searches for Python files in the predefined command directories,
+        dynamically imports the modules, and registers classes that inherit from `BaseCommand`.
+
+        The command directories searched are:
+        - `app/console/commands` relative to the current working directory.
+        - `console/commands` relative to the parent directory of the current file.
+
+        It skips `__init__.py` files and ignores directories that do not exist.
+
+        Raises
+        ------
+        BootstrapRuntimeError
+            If an error occurs while loading a module.
+        """
+        pass

orionis/luminate/contracts/{console → bootstrap/commands}/register_interface.py

@@ -1,4 +1,5 @@
 from abc import ABC, abstractmethod
+from typing import Any, Callable
 
 class IRegister(ABC):
     """
@@ -6,7 +7,7 @@ class IRegister(ABC):
     """
 
     @abstractmethod
-    def command(self, command_class):
+    def command(self, command_class: Callable[..., Any]) -> None:
         """
         Registers a command class after validating its structure.
 

orionis/luminate/contracts/cache/app/config_interface.py

@@ -0,0 +1,76 @@
+from abc import ABC, abstractmethod
+from typing import Dict, Any
+
+class ICacheConfig(ABC):
+    """
+    CacheConfig is a class that manages the registration, unregistration, and retrieval of configuration sections.
+
+    Methods
+    -------
+    __init__()
+        Initializes a new instance of the class with an empty configuration dictionary.
+    register(section: str, data: Dict[str, Any])
+        Registers a configuration section with its associated data.
+    unregister(section: str)
+        Unregisters a previously registered configuration section.
+    get(section: str)
+        Retrieves the configuration data for a specific section.
+    """
+
+    @abstractmethod
+    def register(self, section: str, data: Dict[str, Any]) -> None:
+        """
+        Registers a configuration section.
+
+        Parameters
+        ----------
+        section : str
+            The name of the configuration section to register.
+        data : dict
+            The configuration data associated with the section.
+
+        Raises
+        ------
+        ValueError
+            If the section is already registered.
+        """
+        pass
+
+    @abstractmethod
+    def unregister(self, section: str) -> None:
+        """
+        Unregisters a previously registered configuration section.
+
+        Parameters
+        ----------
+        section : str
+            The name of the configuration section to remove.
+
+        Raises
+        ------
+        KeyError
+            If the section is not found in the registered configurations.
+        """
+        pass
+
+    @abstractmethod
+    def get(self, section: str) -> Dict[str, Any]:
+        """
+        Retrieves the configuration for a specific section.
+
+        Parameters
+        ----------
+        section : str
+            The name of the configuration section to retrieve.
+
+        Returns
+        -------
+        dict
+            The configuration data for the specified section.
+
+        Raises
+        ------
+        KeyError
+            If the requested section is not found.
+        """
+        pass

orionis/luminate/contracts/cache/{cache_commands_interface.py → console/commands_interface.py}

@@ -1,15 +1,24 @@
 from abc import ABC, abstractmethod
+from typing import Any, Callable
 
 class ICacheCommands(ABC):
     """
-    Interface for managing a cache of commands.
+    CacheCommands is a class that manages the registration, unregistration, and retrieval of command instances.
 
-    This interface ensures that any class implementing it will provide methods
-    for registering, unregistering, and retrieving commands.
+    Methods
+    -------
+    __init__()
+        Initializes the command cache with an empty dictionary.
+    register(signature: str, description: str, arguments: list, concrete: Callable[..., Any])
+        Register a new command with its signature, description, and class instance.
+    unregister(signature: str)
+        Unregister an existing command by its signature.
+    get(signature: str)
+        Retrieve the information of a registered command by its signature.
     """
 
     @abstractmethod
-    def register(self, signature: str, description: str, instance):
+    def register(self, signature: str, description: str, arguments: list, concrete: Callable[..., Any]):
         """
         Register a new command with its signature, description, and class instance.
 
@@ -19,7 +28,7 @@ class ICacheCommands(ABC):
             The unique identifier (signature) for the command.
         description : str
             A brief description of what the command does.
-        instance : class
+        concrete : class
             The class or callable instance that defines the command behavior.
 
         Raises

{orionis-0.25.0.dist-info → orionis-0.27.0.dist-info}/METADATA

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

{orionis-0.25.0.dist-info → orionis-0.27.0.dist-info}/RECORD

@@ -1,18 +1,21 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=9wNVJxB0HyqUbNesUvkwlsqTyUbZwK6R46iVLE5WVBQ,1715
-orionis/framework.py,sha256=JL7FniIVyW5QSVrlB6akv6ab_R3Dg9VMrjitULOWw1U,1386
+orionis/framework.py,sha256=YAVaj0HKJgo1NVBMFlLifezZIIm_9SwPXeiVeTOL2Cg,1386
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/app.py,sha256=fh5p0w5VBb0zJ6qKNHOCs2vxIix6AborENZFW_GCvrw,152
 orionis/luminate/bootstrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/bootstrap/cli_exception.py,sha256=wDKfEW295c7-bavr7YUHK2CLYcTSZgjT9ZRSBne6GOE,1356
+orionis/luminate/bootstrap/commands/bootstrapper.py,sha256=0TtExkxyokfMSooR5-RieOQKiIt8dY_iodT_WA_Ncpc,3874
+orionis/luminate/bootstrap/commands/register.py,sha256=YonMvfe1TQBVPLxqM7o7_mYaXPKoXvZNRSsW365uVtM,3734
 orionis/luminate/bootstrap/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/bootstrap/config/bootstrapper.py,sha256=LKLBAKkawuJq7r0dGvhuox0PxicEuLVA0tvlDjf9lL8,2886
+orionis/luminate/bootstrap/config/bootstrapper.py,sha256=PtmZJIH8sHVOdGIogLlqTuPD0XZvR2DgOnPZDgSng9o,2971
 orionis/luminate/bootstrap/config/parser.py,sha256=Ay8dh3aax9xhVgeLSHT71ubtZJiKAJAP85dLFF7djyA,1950
 orionis/luminate/bootstrap/config/register.py,sha256=uX0XGEWdo3iJou5B96vxvhZEjliTGC1HBaT8w9enMmk,2760
 orionis/luminate/cache/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/cache/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/cache/app/config.py,sha256=NhZ_unGGDA7xpng317325uUVGTGL5ya_m7Mu6xZIPXg,2454
+orionis/luminate/cache/app/config.py,sha256=nhw9p7NUAC76Cl7secT5qWT5btRWSWBGHNctS4jxqok,2830
 orionis/luminate/cache/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/cache/console/commands.py,sha256=hDwGT4DhMnV4LM35CX7L-E5c_cCHn4TLVkgdXvJ3wFg,3181
+orionis/luminate/cache/console/commands.py,sha256=NG-QWcOEC0iWuxwifKt5AeONljQ0JShmQhJhtrWDl_8,3237
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/environment.py,sha256=QhiyZNnngh9Ol-SPIHIep4D3YCzVMxoMgCXeJjxV9FU,3301
 orionis/luminate/config/dataclass/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -27,59 +30,59 @@ orionis/luminate/config/dataclass/mail.py,sha256=3iYXG72bXiVns4sEPZ_A3-cGcFjGEGD
 orionis/luminate/config/dataclass/queue.py,sha256=DYjP5zD09ISsIX117wtOfjiG_iQrcrPoQVeeftmuO3c,1739
 orionis/luminate/config/dataclass/session.py,sha256=7mOC_DfGIBDqAClSiewHoTA9Kht_zdHApvALcZc7cfY,1861
 orionis/luminate/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/cache.py,sha256=GuiCYaiU8fHTcPZauSOJJeXbRM6aau2PmDuJ00uD8kA,5125
+orionis/luminate/console/cache.py,sha256=K6imeTG0sWjBHjIt3Zs1O6j9xEN2KUtcqymfUo7OuJA,3316
 orionis/luminate/console/command.py,sha256=bSFFniZds1L_GKPcotfQZlt8m-GKByvfZR1deTMLPb8,1381
 orionis/luminate/console/command_filter.py,sha256=kSyIn2WMKsHdXfOS4EfUVO_sn0LSSU75YXeoIGgI3uk,1352
-orionis/luminate/console/kernel.py,sha256=czK_4PuBfVjkpauKlJf6CiuoFixOlbFbp7vPG9hdZN4,1001
+orionis/luminate/console/kernel.py,sha256=6WeCLB42dN_vHmvJxX_XdUWPj2tD23oSXJh5DzdivDo,994
 orionis/luminate/console/parser.py,sha256=WXdmaNQElF5revyzPXaKYSQfF6coS7PJ9jE-3SXX7PQ,5596
-orionis/luminate/console/register.py,sha256=VXehiDD7nxvDl-XIYzquummeuhz0gQebKi1sGG-QiOU,3793
 orionis/luminate/console/runner.py,sha256=M3S1gtiOldR8TlUCP2ocgeixyahtAieaXegBezG2CF0,4626
 orionis/luminate/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/base/command.py,sha256=erOKO2HdsTNS8AbLIw7fc9UulB73hZL82p3QZp4RzD8,12721
+orionis/luminate/console/base/command.py,sha256=M8mMzH-7CZWOqcLehVVOxAyh6YN5cddc-QbIYjOFjcU,12726
 orionis/luminate/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/commands/cache_clear.py,sha256=AgtLFR1uegmTQz5s2Qcd3ZkIDYL5K0B-P_YuwJw9_Uc,2241
-orionis/luminate/console/commands/help.py,sha256=r0vmNVLycAk7s5Q3xAlIhhqrKzkwtGYTEqhTFZCHYfQ,2027
-orionis/luminate/console/commands/schedule_work.py,sha256=J-2SsG2wyN3_F_d5ZzK7Ysdz2UrGaOE_qkxhZ9OuaKU,1834
-orionis/luminate/console/commands/tests.py,sha256=eRP5fXIqvn2a7saZI_eHOJRbnG6dgDCJVdNz92Gmmxs,1393
-orionis/luminate/console/commands/version.py,sha256=Do9_eHxSlegkeUv-uquxd3JcGTTx3tAoNv1lTUZCmPw,1228
+orionis/luminate/console/commands/cache_clear.py,sha256=3Hapq-xY85uUkr5gVCmWvkVry5UFDBqIsuXTdG8ehw4,2246
+orionis/luminate/console/commands/help.py,sha256=MKPhaQMFSkcBvwtkRguQ9b2ieH02kvCrV0CcSqHLPSE,2058
+orionis/luminate/console/commands/schedule_work.py,sha256=OtU1FzvBxITGWr0PvSGrm4QSinnBNwkgRVnN_PpEBs8,1861
+orionis/luminate/console/commands/tests.py,sha256=PtXxMmk3380yFVnQqPL13Og_3L6PsEueW4vxqtzKSJA,1424
+orionis/luminate/console/commands/version.py,sha256=oM5Vr_2Xc7Eaq6VHbcMaTeteY0cDvdvC_hUoRyzEVMc,1259
 orionis/luminate/console/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/exceptions/cli_exception.py,sha256=I0brj4041CCgqtu4knH5NSHZVN3BPg0pxtbUx5cbTdA,3469
+orionis/luminate/console/exceptions/cli_exception.py,sha256=QM7tRdPBoo7WdmAb3Zasj8d3429zskftUGYHAvhcnSU,4631
 orionis/luminate/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/output/console.py,sha256=zPZJkRCv1cOn1OYNoGrEW6chMVUhkrZ_qTg2MkD2vTA,14474
-orionis/luminate/console/output/executor.py,sha256=YkgRNGVnSPI5oPrJ2WbFU_1433BMt0PrrjlbppsnqHg,3372
-orionis/luminate/console/output/progress_bar.py,sha256=E1ULCKB6GmnIuVN6atsrCwZ9ClRsG6-xFlp8yoczmaQ,3099
+orionis/luminate/console/output/console.py,sha256=KTQKMpVVOdCsGUxrKRSQzlqmz42wwWV-8b14q_mfrYI,14481
+orionis/luminate/console/output/executor.py,sha256=J4lmWMRCXW2b5L8PbX31q1fGnnjYZOO93O4rtPyA_0A,3379
+orionis/luminate/console/output/progress_bar.py,sha256=YT8Gl-_Zfc3E6foU-Dw7aAndZm4m-xY36G3MpPi3Aj4,3106
 orionis/luminate/console/output/styles.py,sha256=fF_B1kw95lkiLUzq4cjYPppF-sLsx9_qmyhKqoeZrJ0,3604
 orionis/luminate/console/scripts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/scripts/management.py,sha256=KT6Bg8kyuUw63SNAtZo6tLH6syOEkxM9J70tCpKgrUw,2860
+orionis/luminate/console/scripts/management.py,sha256=J5gLXtvX8I1zdNk6sa23njR18D5s4LJXZK7ElK0sFzI,2868
 orionis/luminate/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/console/tasks/scheduler.py,sha256=h3fRVTx6TuZVcY7zZ6oOzGDnlDAWaRwkj92pFTGUm6E,22686
-orionis/luminate/container/container.py,sha256=O4AKaRQK2XfN0es70lIxUGkP0mxxemSsHOOuvtJVcUU,16212
+orionis/luminate/console/tasks/scheduler.py,sha256=CUmv9ap7zq3IWVTPtpPBZ-x166jsj1e0lTvw3didUQM,22692
+orionis/luminate/container/container.py,sha256=GMUsyKmlqzmsjJeMTYlwOzleEBWzTqlEyX-jLtZu9M8,16069
 orionis/luminate/container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
 orionis/luminate/container/types.py,sha256=PbPNOJ8e4SGzCmu-zOmCQmDzt1b9I73v3fw_xzLq9RU,932
 orionis/luminate/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/contracts/bootstrap/commands/bootstrapper_interface.py,sha256=z9x6yW205hta-OT1u_CHF0VWHIe0T6M0EWZ5RHHpXLU,1632
+orionis/luminate/contracts/bootstrap/commands/register_interface.py,sha256=witwBVJtDPpNRxOWhz1OeDjOnDzp1D_EJSIXa_AcjTg,881
 orionis/luminate/contracts/bootstrap/config/bootstrapper_interface.py,sha256=NQgPgm_vlZna1nPvOaEWWeJC1uzUvoGM8fjVHVE8EtY,1480
 orionis/luminate/contracts/bootstrap/config/parser_interface.py,sha256=7DLnp7yB7edayVkSm-piTi8JSf0QKaYYI82qDZudgM0,1641
 orionis/luminate/contracts/bootstrap/config/register_interface.py,sha256=7kMW04ptvQ51PnprtCIR-iLHljVSGiH58GN493igeuw,1506
 orionis/luminate/contracts/cache/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/contracts/cache/cache_commands_interface.py,sha256=NhJAh2OZHXKMwbJ8nOU4IFJRZpuJNmfN9rtnpbCnuOo,1936
+orionis/luminate/contracts/cache/app/config_interface.py,sha256=jOD-h6b41GYmIAZ6DO-2MIG4BM8RVoK_kQRPCJPaFjg,2118
+orionis/luminate/contracts/cache/console/commands_interface.py,sha256=pmPe22OiWguu-b9s0VcS_e1ryr4I4Dz6H7-mdfnQN40,2407
 orionis/luminate/contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/config/config_interface.py,sha256=rbeojO2gm8XhSXIPY8EnUt4e0wO633OKF9Nx_tN5y60,785
 orionis/luminate/contracts/config/environment_interface.py,sha256=a59CXhwEzQDnyhmPhsnWGranqFYJV8c5JpA6o6FIya4,1672
 orionis/luminate/contracts/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/contracts/console/base_command_interface.py,sha256=Lz0ktEjeXcqU5803BVIDT8H3fhbvfkd3Ngsa561lrZY,12241
-orionis/luminate/contracts/console/cli_cache_interface.py,sha256=U39BOuEpneOnBGxrvCCyCy-lYGaCOMiMOTCYzh1xMhg,1160
 orionis/luminate/contracts/console/command_filter_interface.py,sha256=g66AlKNjTyQfdarO23r27nFqwiCnrP6kjaZ7tUGql-c,937
 orionis/luminate/contracts/console/command_interface.py,sha256=B5ete_yox0pcprdL0VmCPgOu3QW9y8vEd2UMOFy8_10,1208
-orionis/luminate/contracts/console/console_interface.py,sha256=NL6GsbJy286y0wcWhAhqavC6G2EW_WZJYQdH9wMO8Vc,8517
-orionis/luminate/contracts/console/executor_interface.py,sha256=MGMTTPSwF8dgCjHD3A4CKtYDaCcD-KU28dorC61Q04k,1411
 orionis/luminate/contracts/console/kernel_interface.py,sha256=GtiGlWe7EQ9aeChHpQ-GlIJlJ5tEqpZYYkjNcrwXI94,945
-orionis/luminate/contracts/console/management_interface.py,sha256=4Zc8da5iz3kHZju61A0krArKVZ5K39B0Imk1GmgTMks,1586
 orionis/luminate/contracts/console/parser_interface.py,sha256=vMmTK0wMfTjt7H-tRf-WRLI8R-ghUzJauctwtgj0jFU,2082
-orionis/luminate/contracts/console/progress_bar_interface.py,sha256=sOkQzQsliFemqZHMyzs4fWhNJfXDTk5KH3aExReetSE,1760
-orionis/luminate/contracts/console/register_interface.py,sha256=rhHI_as_3yNWtdgQvwJb0NyNUfzAZDCJrqgPgpzjoAQ,819
 orionis/luminate/contracts/console/runner_interface.py,sha256=vWLtMhl0m1T6rfCUHZbxGQJl9ZWTXlp3HjcTfCAztGk,1644
-orionis/luminate/contracts/console/schedule_interface.py,sha256=_dsR0gCvJ7_67lwPUAzBwQFHNvWM6jVjcg1EdPqDIIo,10117
 orionis/luminate/contracts/console/task_manager_interface.py,sha256=sOmeifoncpWCG2WYh4q3QZ7M7w7P9Onb3Jxw9X2lpXE,1197
+orionis/luminate/contracts/console/base/base_command_interface.py,sha256=Lz0ktEjeXcqU5803BVIDT8H3fhbvfkd3Ngsa561lrZY,12241
+orionis/luminate/contracts/console/output/console_interface.py,sha256=NL6GsbJy286y0wcWhAhqavC6G2EW_WZJYQdH9wMO8Vc,8517
+orionis/luminate/contracts/console/output/executor_interface.py,sha256=MGMTTPSwF8dgCjHD3A4CKtYDaCcD-KU28dorC61Q04k,1411
+orionis/luminate/contracts/console/output/progress_bar_interface.py,sha256=sOkQzQsliFemqZHMyzs4fWhNJfXDTk5KH3aExReetSE,1760
+orionis/luminate/contracts/console/scripts/management_interface.py,sha256=4Zc8da5iz3kHZju61A0krArKVZ5K39B0Imk1GmgTMks,1586
+orionis/luminate/contracts/console/tasks/schedule_interface.py,sha256=_dsR0gCvJ7_67lwPUAzBwQFHNvWM6jVjcg1EdPqDIIo,10117
 orionis/luminate/contracts/container/container_interface.py,sha256=c_QRQHXGIujiDnYXyt--3J2LKXngVtoB3O-qchPmFDQ,6899
 orionis/luminate/contracts/container/types_interface.py,sha256=GCH7x3PjpXKPET3l84GcXbcM8cpne8AGrmTw-uFaT24,526
 orionis/luminate/contracts/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -140,9 +143,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=dNN5p_xAosyEf0ddAElmmmTfhcTtBd4zBNl7qzgnsc0,5242
-orionis-0.25.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.25.0.dist-info/METADATA,sha256=s7HOpnk0ZRCx-o1hYhXR3FMsACDTJIWTev4Wm6A12cM,2978
-orionis-0.25.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.25.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.25.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.25.0.dist-info/RECORD,,
+orionis-0.27.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.27.0.dist-info/METADATA,sha256=DwS_1R60RwWhZk4NtiMg9I7rfxNxrAyuk7XhL-Dm0Qo,2978
+orionis-0.27.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.27.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.27.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.27.0.dist-info/RECORD,,

orionis/luminate/contracts/console/cli_cache_interface.py

@@ -1,34 +0,0 @@
-from abc import ABC, abstractmethod
-from orionis.luminate.cache.console.commands import CacheCommands
-
-class ICLICache(ABC):
-    """
-    Interface for CLICache, defining the required methods for managing command caching.
-
-    This interface enforces a contract for any class that implements caching functionality
-    for command execution within the framework.
-    """
-
-    @abstractmethod
-    def _load_commands(self) -> None:
-        """
-        Loads command modules from predefined directories.
-
-        This method should traverse specified directories, locate Python files, and import them dynamically.
-        Implementations should ensure that only relevant directories are processed.
-        """
-        pass
-
-    @abstractmethod
-    def getCommands(self) -> CacheCommands:
-        """
-        Returns the instance of CacheCommands containing the command cache.
-
-        This method provides access to the CacheCommands instance, which holds the cached commands.
-
-        Returns
-        -------
-        CacheCommands
-            The instance of CacheCommands that holds the cached commands.
-        """
-        pass