orionis 0.24.0__py3-none-any.whl → 0.26.0__py3-none-any.whl

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/bootstrap/config/bootstrapper_interface.py

@@ -12,35 +12,11 @@ class IBootstrapper(ABC):
 
     Methods
     -------
-    findClasses(file_path: str) -> List[str]
-        Parses a Python file to extract and return all defined class names.
-
     autoload(directory: str) -> None
         Scans a directory for Python files, imports them, finds configuration classes,
         and registers them using the `Register` instance.
     """
 
-    @abstractmethod
-    def _definitions(self, file_path: str):
-        """
-        Parses a Python file to extract and return all defined class names.
-
-        This method opens the file at the given path, parses it using the Abstract
-        Syntax Tree (AST) module to extract class definitions, and returns a
-        list of class names found within the file.
-
-        Parameters
-        ----------
-        file_path : str
-            The path to the Python file to parse.
-
-        Returns
-        -------
-        List[str]
-            A list of class names defined in the provided Python file.
-        """
-        pass
-
     @abstractmethod
     def _autoload(self, directory: str) -> None:
         """

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.24.0.dist-info → orionis-0.26.0.dist-info}/METADATA

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

{orionis-0.24.0.dist-info → orionis-0.26.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=2oCt-3JJLH7NfD3SqITrdBtqHRSv3S5o8aS-xRBNmw0,1386
+orionis/framework.py,sha256=C_6r_m1L-u726uOgo7uSaFeWWG4ncGyPicnqt-KhKYw,1386
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/app.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=R1ixec362o-Td-kNSvi-0ylVqspFWJq6L6IHYzWHPmg,4227
+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,58 @@ 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/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/config/bootstrapper_interface.py,sha256=De6nKQcZpN1dWsubXWUO229ZH4IbCoUaGtP5HOUw2Ps,2251
+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 +142,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.24.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.24.0.dist-info/METADATA,sha256=AjX6H0V8MIJ8fJO8B2enLUqHvyPadYnyNfUkqllA7VA,2978
-orionis-0.24.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.24.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.24.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.24.0.dist-info/RECORD,,
+orionis-0.26.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.26.0.dist-info/METADATA,sha256=obHD75IlsEwzGtfyvaJ5q2X6vsO3UkPk0OerwDtAwBQ,2978
+orionis-0.26.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.26.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.26.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.26.0.dist-info/RECORD,,

orionis/luminate/console/cache.py

@@ -1,132 +0,0 @@
-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):
-    """
-    Singleton 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.
-
-    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:
-        """
-        Initializes the CLICache instance by loading commands if not already initialized.
-
-        This method will load command modules only once, ensuring that the commands are available for execution
-        across the application. It should not be called directly multiple times.
-
-        Attributes
-        ----------
-        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):
-        """
-        Dynamically loads command modules from predefined directories.
-
-        This method traverses the specified directories, locates Python files, and imports them as modules. 
-        It ensures that only the main directories are iterated over, avoiding subdirectories.
-
-        Directories searched:
-        ---------------------
-        - app/console/commands (relative to the base path)
-        - Current directory of the module (this file's directory)
-        """
-        paths = []
-
-        # Define the base path of the application
-        base_path = os.getcwd()
-
-        # Define command directories to be searched
-        command_dirs = [
-            os.path.join(base_path, 'app', 'console', 'commands'),
-            os.path.join(os.path.dirname(__file__), 'commands')
-        ]
-
-        # Add valid directories to paths list
-        for command_dir in command_dirs:
-            if os.path.isdir(command_dir):
-                paths.append(command_dir)
-
-        # Iterate over each valid directory
-        for path in paths:
-            for current_directory, _, files in os.walk(path):
-                # Ensure to only iterate through the top-level directories
-                if current_directory == path:
-                    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)
-
-    def getCommands(self):
-        """
-        Returns the instance of the CacheCommands containing the command cache.
-
-        This method provides access to the CacheCommands instance, which holds the loaded commands cache
-        and makes it available for use.
-
-        Returns
-        -------
-        CacheCommands
-            The instance of CacheCommands that holds the cached commands.
-        """
-        return CacheCommands()

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