orionis 0.66.0__py3-none-any.whl → 0.70.0__py3-none-any.whl

orionis/contracts/services/environment/i_environment_service.py

@@ -0,0 +1,74 @@
+from abc import ABC, abstractmethod
+
+class IEnvironmentService(ABC):
+
+    @abstractmethod
+    def _initialize(self, path: str = None):
+        """
+        Initializes the instance by setting the path to the .env file.
+        If no path is provided, defaults to a `.env` file in the current directory.
+
+        Parameters
+        ----------
+        path : str, optional
+            Path to the .env file. Defaults to None.
+        """
+        pass
+
+    @abstractmethod
+    def get(self, key: str, default=None) -> str:
+        """
+        Retrieves the value of an environment variable from the .env file
+        or from system environment variables if not found.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable.
+        default : optional
+            Default value if the key does not exist. Defaults to None.
+
+        Returns
+        -------
+        str
+            The value of the environment variable or the default value.
+        """
+        pass
+
+    @abstractmethod
+    def set(self, key: str, value: str) -> None:
+        """
+        Sets the value of an environment variable in the .env file.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable.
+        value : str
+            The value to set.
+        """
+        pass
+
+    @abstractmethod
+    def unset(self, key: str) -> None:
+        """
+        Removes an environment variable from the .env file.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable to remove.
+        """
+        pass
+
+    @abstractmethod
+    def all(self) -> dict:
+        """
+        Retrieves all environment variable values from the .env file.
+
+        Returns
+        -------
+        dict
+            A dictionary of all environment variables and their values.
+        """
+        pass

orionis/contracts/services/files/{i_path_service.py → i_path_resolver_service.py}

@@ -1,8 +1,6 @@
-import os
-from pathlib import Path
 from abc import ABC, abstractmethod
 
-class IPathService(ABC):
+class IPathResolverService(ABC):
 
     @abstractmethod
     def resolve(self, route: str) -> str:

orionis/framework.py

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

orionis/luminate/app.py

@@ -1,33 +1,51 @@
-import json
 from orionis.luminate.container.container import Container
 from orionis.luminate.bootstrap.config_bootstrapper import ConfigBootstrapper
 from orionis.luminate.bootstrap.command_bootstrapper import CommandsBootstrapper
 from orionis.luminate.bootstrap.environment_bootstrapper import EnvironmentBootstrapper
 from orionis.luminate.patterns.singleton import SingletonMeta
+from orionis.luminate.providers.environment.environment_provider import EnvironmentProvider
 
 class Application(metaclass=SingletonMeta):
 
     def __init__(self):
 
+        # Atributos de la clase
         self._config = {}
         self._commands = {}
+        self._environment = {}
 
+        # Inicializar el contenedor de la aplicacion
         self.container = Container()
         self.container.instance(self.container)
+
+        # Cargar el servidor de entorno
+        self._loadServiceProviderEnvironment()
+
+        # Cargar dinamicamente la configurcion de la aplicacion.
         self._bootstraping()
 
+    def _loadServiceProviderEnvironment(self):
+
+        # Cargar el proveedor de entorno
+        _environment_provider = EnvironmentProvider(app=self.container)
+        _environment_provider.register()
+        _environment_provider.boot()
+
     def _bootstraping(self):
+
+        # Cargar la configuracion de la aplicacion
         config_bootstrapper_key = self.container.singleton(ConfigBootstrapper)
         config_bootstrapper: ConfigBootstrapper = self.container.make(config_bootstrapper_key)
         self._config = config_bootstrapper.get()
 
+        # Cargar los comandos propios y definidos por el desarrollador
         commands_bootstrapper_key = self.container.singleton(CommandsBootstrapper)
         commands_bootstrapper: CommandsBootstrapper = self.container.make(commands_bootstrapper_key)
         self._commands = commands_bootstrapper.get()
 
+        # Cargar las variables de entorno solo desde el archivo .env (No se carga desde el sistema operativo, por seguridad)
         environment_bootstrapper_key = self.container.singleton(EnvironmentBootstrapper)
         environment_bootstrapper: EnvironmentBootstrapper = self.container.make(environment_bootstrapper_key)
         self._environment = environment_bootstrapper.get()
 
-    def isBooted(self):
-        return True
+        print(self._config)

orionis/luminate/bootstrap/environment_bootstrapper.py

@@ -1,10 +1,7 @@
-import ast
-import os
-from pathlib import Path
 from typing import Dict
-from dotenv import dotenv_values
 from orionis.contracts.bootstrap.i_environment_bootstrapper import IEnvironmentBootstrapper
-from orionis.luminate.bootstrap.exception_bootstrapper import BootstrapRuntimeError
+from orionis.luminate.facades.app import app
+from orionis.luminate.services.environment.environment_service import EnvironmentService
 
 class EnvironmentBootstrapper(IEnvironmentBootstrapper):
     """
@@ -46,68 +43,9 @@ class EnvironmentBootstrapper(IEnvironmentBootstrapper):
         This method checks if the `.env` file exists in the current working directory.
         If the file does not exist, it creates an empty `.env` file. If the file exists,
         it loads the environment variables into the `_environment_vars` dictionary.
-
-        Raises
-        ------
-        PermissionError
-            If the `.env` file cannot be created or read due to insufficient permissions.
         """
-        # Set the path to the `.env` file
-        path: Path = Path(os.getcwd()) / ".env"
-
-        # Create the `.env` file if it does not exist
-        if not path.exists():
-            try:
-                path.touch()  # Create an empty `.env` file if it does not exist
-            except PermissionError as e:
-                raise PermissionError(f"Cannot create `.env` file at {path}: {str(e)}")
-
-        try:
-            all_vars = dotenv_values(path)
-            for key, value in all_vars.items():
-                self._environment_vars[key] = self._parse_value(value)
-        except Exception as e:
-            raise BootstrapRuntimeError(f"Error loading environment variables from {path}: {str(e)}")
-
-    def _parse_value(self, value):
-        """
-        Parse and convert a string value into its appropriate Python data type.
-
-        This function handles conversion for common types such as `None`, booleans (`True`/`False`),
-        integers, and Python literals (e.g., lists, dictionaries). If the value cannot be parsed
-        into a specific type, it is returned as-is.
-
-        Parameters
-        ----------
-        value : str or None
-            The value to be parsed. If `None`, it is returned as `None`.
-
-        Returns
-        -------
-        any
-            The parsed value. Possible return types include:
-            - `None` if the value is empty, `None`, `'None'`, or `'null'`.
-            - `bool` if the value is `'True'`, `'true'`, `'False'`, or `'false'`.
-            - `int` if the value is a digit string (e.g., `'123'`).
-            - Python literals (e.g., lists, dictionaries) if the value can be evaluated as such.
-            - The original value if no conversion is applicable.
-        """
-        # Strip leading and trailing whitespace from the value
-        value = str(value).strip() if value is not None else None
-
-        # Parse common types and Python literals
-        if not value or value.lower() in {'none', 'null'}:
-            return None
-        if value.lower() in {'true', 'false'}:
-            return value.lower() == 'true'
-        if value.isdigit():
-            return int(value)
-
-        # Attempt to parse Python literals (e.g., lists, dictionaries)
-        try:
-            return ast.literal_eval(value)
-        except (ValueError, SyntaxError):
-            return value
+        environment_service : EnvironmentService = app(EnvironmentService)
+        self._environment_vars = environment_service.all()
 
     def get(self, key: str = None) -> str:
         """

orionis/luminate/bootstrap/service_providers_bootstrapper.py

@@ -0,0 +1,10 @@
+from orionis.luminate.container.container import Container
+
+class ServiceProvidersBootstrapper:
+
+    def __init__(self, container : Container) -> None:
+        self._container = container
+        self._autoload()
+
+    def _autoload(self) -> None:
+        pass

orionis/luminate/facades/app.py

@@ -0,0 +1,41 @@
+from typing import Any
+from orionis.luminate.container.container import Container
+from orionis.luminate.container.exception import OrionisContainerException, OrionisContainerTypeError
+
+def app(concrete: Any = None):
+    """
+    Retrieves the container instance or resolves a service from the container.
+
+    If a `concrete` class or service is passed, it will check if it is bound
+    to the container and return an instance of the service. If not bound,
+    an exception will be raised.
+
+    Parameters
+    ----------
+    concrete : Any, optional
+        The concrete service or class to resolve from the container.
+        If None, returns the container instance itself.
+
+    Returns
+    -------
+    Container or Any
+        If `concrete` is provided and bound, returns the resolved service.
+        If `concrete` is None, returns the container instance.
+
+    Raises
+    ------
+    OrionisContainerException
+        If `concrete` is not bound to the container.
+    """
+
+    # Create a new container instance
+    container : Container = Container()
+
+    # If concrete is provided (not None), attempt to resolve it from the container
+    if concrete is not None:
+        if not isinstance(concrete, type):
+            raise OrionisContainerTypeError(f"The provided concrete must be a class or service, got {type(concrete)}.")
+        return container.make(concrete)
+
+    # If concrete is None, return the container instance
+    return container

orionis/luminate/facades/config/config_facade.py

@@ -1,6 +1,6 @@
 from typing import Any, Optional
 from orionis.contracts.facades.config.i_config_facade import IConfig
-from orionis.luminate.app_context import AppContext
+from orionis.luminate.facades.app import app
 from orionis.luminate.services.config.config_service import ConfigService
 
 class Config(IConfig):
@@ -17,9 +17,8 @@ class Config(IConfig):
         value : Any
             The value to set.
         """
-        with AppContext() as app:
-            config_service : ConfigService = app.container.make(ConfigService)
-            config_service.set(key, value)
+        _config_service_provider : ConfigService = app(ConfigService)
+        return _config_service_provider.set(key, value)
 
     @staticmethod
     def get(key: str, default: Optional[Any] = None) -> Any:
@@ -38,6 +37,5 @@ class Config(IConfig):
         Any
             The configuration value or the default value if the key is not found.
         """
-        with AppContext() as app:
-            config_service : ConfigService = app.container.make(ConfigService)
-            return config_service.get(key, default)
+        _config_service_provider : ConfigService = app(ConfigService)
+        return _config_service_provider.get(key, default)

orionis/luminate/facades/environment/environment_facade.py

@@ -1,8 +1,6 @@
-import os
-import threading
-from pathlib import Path
-from dotenv import set_key, unset_key, dotenv_values
 from orionis.contracts.facades.environment.i_environment_facade import IEnv
+from orionis.luminate.facades.app import app
+from orionis.luminate.services.environment.environment_service import EnvironmentService
 
 def env(key: str, default=None) -> str:
     """
@@ -26,55 +24,13 @@ def env(key: str, default=None) -> str:
         The value of the environment variable, or the default value if the variable
         does not exist.
     """
-    return Env().get(key, default)
+    return Env.get(key, default)
 
 class Env(IEnv):
-    """
-    A thread-safe singleton class that manages environment variables from a .env file.
-    """
-
-    _instance = None
-    _lock = threading.Lock()
-
-    def __new__(cls, path: str = None):
-        """
-        Override the __new__ method to ensure only one instance of the class is created.
-
-        Parameters
-        ----------
-        path : str, optional
-            The path to the .env file. Defaults to None.
-
-        Returns
-        -------
-        Environment
-            The singleton instance of the Environment class.
-        """
-        # Use the lock to ensure thread-safe instantiation
-        with cls._lock:
-            if cls._instance is None:
-                cls._instance = super().__new__(cls)
-                cls._instance._initialize(path)
-        return cls._instance
-
-    def _initialize(self, path: str = None):
-        """
-        Initializes the instance by setting the path to the .env file.
-        If no path is provided, defaults to a `.env` file in the current directory.
-
-        Parameters
-        ----------
-        path : str, optional
-            Path to the .env file. Defaults to None.
-        """
-        # Set the path to the .env file
-        self.path = Path(path) if path else Path(os.getcwd()) / ".env"
 
-        # Create the .env file if it does not exist
-        if not self.path.exists():
-            self.path.touch()
 
-    def get(self, key: str, default=None) -> str:
+    @staticmethod
+    def get(key: str, default=None) -> str:
         """
         Retrieves the value of an environment variable from the .env file
         or from system environment variables if not found.
@@ -91,13 +47,12 @@ class Env(IEnv):
         str
             The value of the environment variable or the default value.
         """
-        # Get the value from the .env file
-        value = dotenv_values(self.path).get(key)
 
-        # Return the value or the default value
-        return value if value is not None else os.getenv(key, default)
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.get(key, default)
 
-    def set(self, key: str, value: str) -> None:
+    @staticmethod
+    def set(key: str, value: str) -> None:
         """
         Sets the value of an environment variable in the .env file.
 
@@ -108,10 +63,11 @@ class Env(IEnv):
         value : str
             The value to set.
         """
-        # Set the value in the .env file
-        set_key(str(self.path), key, value)
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.set(key, value)
 
-    def unset(self, key: str) -> None:
+    @staticmethod
+    def unset(key: str) -> None:
         """
         Removes an environment variable from the .env file.
 
@@ -120,10 +76,11 @@ class Env(IEnv):
         key : str
             The key of the environment variable to remove.
         """
-        # Remove the key from the .env file
-        unset_key(str(self.path), key)
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.unset(key)
 
-    def all(self) -> dict:
+    @staticmethod
+    def all() -> dict:
         """
         Retrieves all environment variable values from the .env file.
 
@@ -132,5 +89,5 @@ class Env(IEnv):
         dict
             A dictionary of all environment variables and their values.
         """
-        # Return all environment variables
-        return dotenv_values(self.path)
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.all()

orionis/luminate/facades/files/path_facade.py

@@ -1,6 +1,6 @@
 import os
 from orionis.contracts.facades.files.i_path_facade import IPath
-from orionis.luminate.services.files.path_service import PathService
+from orionis.luminate.services.files.path_resolver_service import PathResolverService
 
 class Path(IPath):
     """
@@ -64,8 +64,9 @@ class Path(IPath):
         # Normalize path (removes redundant slashes)
         route = os.path.normpath(route)
 
-        # Obtain the path service from the container
-        PathService().resolve(route)
+        # Resolve path (Note: The service container is not used here)
+        path_resolver_service = PathResolverService()
+        return path_resolver_service.resolve(route)
 
     @staticmethod
     def app(file: str = None):

orionis/luminate/facades/log/log_facade.py

@@ -1,5 +1,5 @@
 from orionis.contracts.facades.log.i_log_facade import ILog
-from orionis.luminate.container.container import Container
+from orionis.luminate.facades.app import app
 from orionis.luminate.services.log.log_service import LogguerService
 
 class Log(ILog):
@@ -34,7 +34,8 @@ class Log(ILog):
         message : str
             The message to log.
         """
-        Container().make(LogguerService).info(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.info(message)
 
     @staticmethod
     def error(message: str) -> None:
@@ -46,7 +47,8 @@ class Log(ILog):
         message : str
             The message to log.
         """
-        Container().make(LogguerService).error(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.error(message)
 
     @staticmethod
     def success(message: str) -> None:
@@ -58,7 +60,8 @@ class Log(ILog):
         message : str
             The message to log.
         """
-        Container().make(LogguerService).success(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.success(message)
 
     @staticmethod
     def warning(message: str) -> None:
@@ -70,7 +73,8 @@ class Log(ILog):
         message : str
             The message to log.
         """
-        Container().make(LogguerService).warning(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.warning(message)
 
     @staticmethod
     def debug(message: str) -> None:
@@ -82,4 +86,5 @@ class Log(ILog):
         message : str
             The message to log.
         """
-        Container().make(LogguerService).debug(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.debug(message)

orionis/luminate/providers/config/config_service_provider.py

@@ -1,26 +1,19 @@
-from orionis.contracts.providers.i_service_provider import IServiceProvider
-from orionis.luminate.container.container import Container
+from orionis.luminate.providers.service_provider import ServiceProvider
 from orionis.luminate.services.config.config_service import ConfigService
 
-class ConfigServiceProvider(IServiceProvider):
+class ConfigServiceProvider(ServiceProvider):
 
-    def register(self, container: Container) -> None:
+    def register(self,) -> None:
         """
         Registers services or bindings into the given container.
-
-        Args:
-            container (Container): The container to register services or bindings into.
         """
-        self.key_sp = container.scoped(ConfigService)
+        self._container_id = self.app.scoped(ConfigService)
 
-    def boot(self, container: Container) -> None:
+    def boot(self,) -> None:
         """
         Boot the service provider.
 
         This method is intended to be overridden by subclasses to perform
         any necessary bootstrapping or initialization tasks.
-
-        Args:
-            container (Container): The service container instance.
         """
-        container.make(self.key_sp)
+        self.app.make(self._container_id)

orionis/luminate/providers/environment/environment_provider.py

@@ -0,0 +1,19 @@
+from orionis.luminate.providers.service_provider import ServiceProvider
+from orionis.luminate.services.environment.environment_service import EnvironmentService
+
+class EnvironmentProvider(ServiceProvider):
+
+    def register(self) -> None:
+        """
+        Registers services or bindings into the given container.
+        """
+        self._container_id = self.app.singleton(EnvironmentService)
+
+    def boot(self) -> None:
+        """
+        Boot the service provider.
+
+        This method is intended to be overridden by subclasses to perform
+        any necessary bootstrapping or initialization tasks.
+        """
+        self.app.make(self._container_id)

orionis/luminate/providers/log/log_service_provider.py

@@ -1,26 +1,19 @@
-from orionis.contracts.providers.i_service_provider import IServiceProvider
-from orionis.luminate.container.container import Container
+from orionis.luminate.providers.service_provider import ServiceProvider
 from orionis.luminate.services.log.log_service import LogguerService
 
-class LogServiceProvider(IServiceProvider):
+class LogServiceProvider(ServiceProvider):
 
-    def register(self, container: Container) -> None:
+    def register(self) -> None:
         """
         Registers services or bindings into the given container.
-
-        Args:
-            container (Container): The container to register services or bindings into.
         """
-        self.key_sp = container.singleton(LogguerService)
+        self._container_id = self.app.singleton(LogguerService)
 
-    def boot(self, container: Container) -> None:
+    def boot(self) -> None:
         """
         Boot the service provider.
 
         This method is intended to be overridden by subclasses to perform
         any necessary bootstrapping or initialization tasks.
-
-        Args:
-            container (Container): The service container instance.
         """
-        container.make(self.key_sp)
+        self.app.make(self._container_id)

orionis/luminate/providers/service_provider.py

@@ -0,0 +1,51 @@
+from orionis.contracts.providers.i_service_provider import IServiceProvider
+from orionis.luminate.container.container import Container
+
+class ServiceProvider(IServiceProvider):
+    """
+    Base class for service providers.
+
+    Parameters
+    ----------
+    container : Container
+        The container instance to be used by the service provider.
+    """
+
+    def __init__(self, app : Container) -> None:
+        """
+        Initialize the service provider with the given container.
+
+        Parameters
+        ----------
+        container : Container
+            The container instance to be used by the service provider.
+        """
+        self.app = app
+
+    def register(self) -> None:
+        """
+        Register services in the container.
+
+        This method should be overridden in the subclass to register
+        specific services.
+
+        Parameters
+        ----------
+        container : Container
+            The container instance where services will be registered.
+        """
+        raise NotImplementedError("This method should be overridden in the subclass")
+
+    def boot(self) -> None:
+        """
+        Boot services in the container.
+
+        This method should be overridden in the subclass to boot
+        specific services.
+
+        Parameters
+        ----------
+        container : Container
+            The container instance where services will be booted.
+        """
+        raise NotImplementedError("This method should be overridden in the subclass")

orionis/luminate/services/environment/environment_service.py

@@ -0,0 +1,131 @@
+import ast
+import os
+from pathlib import Path
+from typing import Any
+from dotenv import set_key, unset_key, dotenv_values
+from orionis.contracts.services.environment.i_environment_service import IEnvironmentService
+
+class EnvironmentService(IEnvironmentService):
+
+    def __init__(self, path: str = None):
+
+        """
+        Initializes the EnvironmentService instance.
+
+        Parameters
+        ----------
+        path : str, optional
+            The path to the .env file. Defaults to None.
+        """
+        self._initialize(path)
+
+    def _initialize(self, path: str = None):
+        """
+        Initializes the instance by setting the path to the .env file.
+        If no path is provided, defaults to a `.env` file in the current directory.
+
+        Parameters
+        ----------
+        path : str, optional
+            Path to the .env file. Defaults to None.
+        """
+        # Set the path to the .env file
+        self.path = Path(path) if path else Path(os.getcwd()) / ".env"
+
+        # Create the .env file if it does not exist
+        if not self.path.exists():
+            self.path.touch()
+
+    def get(self, key: str, default=None) -> str:
+        """
+        Retrieves the value of an environment variable from the .env file
+        or from system environment variables if not found.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable.
+        default : optional
+            Default value if the key does not exist. Defaults to None.
+
+        Returns
+        -------
+        str
+            The value of the environment variable or the default value.
+        """
+
+        # Get the value from the .env file
+        value = dotenv_values(self.path).get(key)
+
+        # Get the value from the system environment variables if not found
+        if value is None:
+            value = os.getenv(key)
+
+        # Parse the value and return it
+        return self._parse_value(value) if value is not None else default
+
+    def set(self, key: str, value: str) -> None:
+        """
+        Sets the value of an environment variable in the .env file.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable.
+        value : str
+            The value to set.
+        """
+        # Set the value in the .env file
+        set_key(str(self.path), key, value)
+
+    def unset(self, key: str) -> None:
+        """
+        Removes an environment variable from the .env file.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable to remove.
+        """
+        # Remove the key from the .env file
+        unset_key(str(self.path), key)
+
+    def all(self) -> dict:
+        """
+        Retrieves all environment variable values from the .env file.
+
+        Returns
+        -------
+        dict
+            A dictionary of all environment variables and their values.
+        """
+        # Return all environment variables
+        env_vars = {}
+
+        # Get all environment variables from the .env file
+        data =  dotenv_values(self.path)
+        for key, value in data.items():
+            # Parse the value and add it to the dictionary
+            env_vars[key] = self._parse_value(value)
+
+        # Get all environment variables from the system environment variables
+        return env_vars
+
+    def _parse_value(self, value : Any):
+
+        # Strip leading and trailing whitespace from the value
+        value = str(value).strip() if value is not None else None
+
+        # Parse common types and Python literals
+        if not value or value.lower() in {'none', 'null'}:
+            return None
+        if value.lower() in {'true', 'false'}:
+            return value.lower() == 'true'
+        if value.isdigit():
+            return int(value)
+
+        # Attempt to parse Python literals (e.g., lists, dictionaries)
+        try:
+            return ast.literal_eval(value)
+        except (ValueError, SyntaxError):
+            return value

orionis/luminate/services/files/path_resolver_service.py

@@ -0,0 +1,59 @@
+import os
+import threading
+from pathlib import Path
+from orionis.contracts.services.files.i_path_resolver_service import IPathResolverService
+
+class PathResolverService(IPathResolverService):
+
+    _lock = threading.Lock()
+    _instance = None
+
+    def __new__(cls):
+        """
+        Override the __new__ method to ensure only one instance of the class is created.
+
+        Returns
+        -------
+        PathResolverService
+            The singleton instance of the PathResolverService class.
+        """
+        # Use the lock to ensure thread-safe instantiation
+        with cls._lock:
+            if cls._instance is None:
+                cls._instance = super().__new__(cls)
+                cls._instance.base_path = Path(os.getcwd())
+        return cls._instance
+
+    def resolve(self, route: str) -> str:
+        """
+        Resolves and returns the absolute path as a string.
+
+        This method combines the base path (current working directory) with the provided
+        relative path, resolves it to an absolute path, and validates that it exists
+        and is either a directory or a file.
+
+        Parameters
+        ----------
+        route : str
+            The relative directory or file path to be resolved.
+
+        Returns
+        -------
+        str
+            The absolute path to the directory or file.
+
+        Raises
+        ------
+        PathNotFoundError
+            If the resolved path does not exist or is neither a directory nor a file.
+        """
+        # Combine base path with the relative route
+        real_path = (self.base_path / route).resolve()
+
+        # Validate that the path exists and is either a directory or a file
+        if not real_path.exists():
+            raise Exception(f"The requested path does not exist or is invalid: {real_path}")
+        if not (real_path.is_dir() or real_path.is_file()):
+            raise Exception(f"The requested path does not exist or is invalid: {real_path}")
+
+        return str(real_path)

{orionis-0.66.0.dist-info → orionis-0.70.0.dist-info}/METADATA

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

{orionis-0.66.0.dist-info → orionis-0.70.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=0bM-hABXJSoPGuvEgnqeaj9qcLP8VjTQ3z9Mb0TSEUI,1381
-orionis/framework.py,sha256=SFegmp7F_hzTIxb36GqTwVkDaEe2fhqWP2M77zf-QEg,1386
+orionis/framework.py,sha256=X0Emcz86KeiYNUZkHybLDkL0DA4OOjMEpgp6KquLfrw,1386
 orionis/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/bootstrap/i_command_bootstrapper.py,sha256=cfpYWSlNhOY1q_C9o0H7F381OoM0Oh0qaeqP-c85nzk,2457
 orionis/contracts/bootstrap/i_config_bootstrapper.py,sha256=d2TXT74H2fCBbzWgrt9-ZG11S_H_YPQOEcJoIOrsgb0,4462
@@ -42,8 +42,10 @@ orionis/contracts/providers/i_service_provider.py,sha256=zoBAsGE-KrNfCsF3u876oxo
 orionis/contracts/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/services/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/services/config/i_config_service.py,sha256=TdlEEsd8jvzBGozwaZtQ9KYHisY4ACL-VUOtydidHeE,989
+orionis/contracts/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/contracts/services/environment/i_environment_service.py,sha256=e-bod0MTq21WVvchlE7kyMQoFL_yhhN4ddRfzctDrz0,1959
 orionis/contracts/services/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/contracts/services/files/i_path_service.py,sha256=Le5sax8c_PjUyb5Hg7AVQALGjxlym5cc6OSPvGCKBKk,866
+orionis/contracts/services/files/i_path_resolver_service.py,sha256=B53Qzei4o_jzehIF0zJVHXzI4S-h0XeQ5vMslxT8okM,837
 orionis/contracts/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/services/log/i_log_service.py,sha256=1RD3u-a5ZDMbg7AYE8y2SW8QNRybAU3De0mEA0dAeNo,2167
 orionis/contracts/support/i_exception_to_dict.py,sha256=LZpbCNDYQJs3j2mIM-NRFl0IfA8I0GFHExgRSO6K2FQ,780
@@ -54,13 +56,14 @@ orionis/installer/installer_manager.py,sha256=Hb6T0bmSl39T30maY-nUWkrLhG77JdrKe4
 orionis/installer/installer_output.py,sha256=LeKxzuXpnHOKbKpUtx3tMGkCi2bGcPV1VNnfBxwfxUU,7161
 orionis/installer/installer_setup.py,sha256=c2HtVklSa-2_-YVonc7fwtoK-RTDqBS2Ybvbekgfqtc,6970
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/app.py,sha256=RqhaFbBQH78t3IgSQc0FHrsSW414UDgee5e6Oy8JHEY,1446
+orionis/luminate/app.py,sha256=KHmx5YBiBX2LD-4k8YwUbwOEDv4Ke19rD-5aMLxvIx0,2286
 orionis/luminate/app_context.py,sha256=XREVkOHU6aP8UB2daA2QbFcOCB8HRmcGXjVbrlW1AHQ,1827
 orionis/luminate/bootstrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/bootstrap/command_bootstrapper.py,sha256=OU0hDMtG1xqVbvCneq4C5mlOUu9OmfkxqbvGH59QsUw,6919
 orionis/luminate/bootstrap/config_bootstrapper.py,sha256=Gw83UtPAOggwzqmz062JfJcpIfmZvmIQyZJfgVFiIcQ,7474
-orionis/luminate/bootstrap/environment_bootstrapper.py,sha256=z8pbnT2oc_NDzqMtgsF6r_JWt5bvGFNenNb30HeRl2A,5219
+orionis/luminate/bootstrap/environment_bootstrapper.py,sha256=GTZ-mBumoNlxYcqsQksw4XyH3TRfPkWAU62mB3wFKLk,2777
 orionis/luminate/bootstrap/exception_bootstrapper.py,sha256=wDKfEW295c7-bavr7YUHK2CLYcTSZgjT9ZRSBne6GOE,1356
+orionis/luminate/bootstrap/service_providers_bootstrapper.py,sha256=bQK1yDLP9dqks3TQhTaJDnrnla_79Tw8wTOY2AsLuDQ,268
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/app.py,sha256=7teuVPuaV2ao0M5Bv-jhSgjEwb9DtVwde2saTRmYru4,1737
 orionis/luminate/config/auth.py,sha256=CG8F0pfVjKz4DY3d1Wi7gscdhnp4TT-Q8SJ2sdsHh18,523
@@ -98,14 +101,15 @@ orionis/luminate/container/container.py,sha256=SKC7IyiAaeySiSvlRbTZRTTe4i_Jvm2N8
 orionis/luminate/container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
 orionis/luminate/container/types.py,sha256=BDcXN0__voRNHZ5Gr5dF0sWIYAQyNk4TxAwILBWyDAA,1735
 orionis/luminate/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/facades/app.py,sha256=20ai-4ggQSBLNz2zpaESKsJ7NhnTQ-XvnRoT_WGNcxk,1486
 orionis/luminate/facades/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/config/config_facade.py,sha256=GLQ6JiD2dB7WLyhUZ4SGBSNo7VuwHpX_QrrQcvjoAi8,1429
+orionis/luminate/facades/config/config_facade.py,sha256=xpyVdH_-CeOvtMuf-Pjl9SFZWOflXzx9lyDy_fYOmxU,1353
 orionis/luminate/facades/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/environment/environment_facade.py,sha256=AzaaQaOz8scgSCVi3liyLaBI_nXhZR2deLFhOQ2nmhU,4191
+orionis/luminate/facades/environment/environment_facade.py,sha256=URYc1fhE95U6SXTVFqNGS2zAYAylRw8Mqf6cEht9LBg,2825
 orionis/luminate/facades/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/files/path_facade.py,sha256=uWU8_-iaMGBWuVxbk_MoTm0FVFq25F_ub-ObvrtceHg,8987
+orionis/luminate/facades/files/path_facade.py,sha256=xajnRjA5FZy9wSCs7NhZyWGapFqQ8hak779_-6G_QXk,9091
 orionis/luminate/facades/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/log/log_facade.py,sha256=YiPCbrRjxN-xYSJMfK_ii3NbsfMM1kYGBOeUCG6PNz4,2256
+orionis/luminate/facades/log/log_facade.py,sha256=_F5-Vnon6hZKefrTwurvraW8lfoG99VmLql_prMdKm8,2482
 orionis/luminate/facades/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/facades/tests/tests_facade.py,sha256=eH_fyXjzEVw8aqEwxAgSujFUItz2woau6hc2Mf4VlkE,1660
 orionis/luminate/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -113,15 +117,20 @@ orionis/luminate/patterns/singleton.py,sha256=b3U0nubKSQWyal5wTXADVPtOztkaTk-M8Z
 orionis/luminate/pipelines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/pipelines/cli_pipeline.py,sha256=xpdwxArZrYqaeo4h375RQwY329V14S8DJC9z1w_Ar1s,4218
 orionis/luminate/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/providers/service_provider.py,sha256=Ave9V10KPVCI6bt3HwJ51322P-_RnQuHXkC-ltlAOOA,1537
 orionis/luminate/providers/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/providers/config/config_service_provider.py,sha256=B72XEIzbiFFojB3c361QFTVz3kuM9HEUHaW-whMgytw,946
+orionis/luminate/providers/config/config_service_provider.py,sha256=MDUdswBE3llDyTkpWnBnLACXs5lgEBHyVHENnwBtobE,660
+orionis/luminate/providers/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/providers/environment/environment_provider.py,sha256=k5Cgk59UNKliFN1zS7ghUyva03jg00QhJxWYhg-6JUQ,679
 orionis/luminate/providers/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/providers/log/log_service_provider.py,sha256=ROvuiEaUAWN-KMZnW3CKoJMgPR8kP37kLB5y1ug03Jg,942
+orionis/luminate/providers/log/log_service_provider.py,sha256=tcWDEI-fubi1mWSS-IKiRReuc0pRMHpxvbvuDgs2Uy0,654
 orionis/luminate/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/config/config_service.py,sha256=TZa3WZtDKEW6p0bMktzMXn85cOQy-q21myiYu3rZA34,2147
+orionis/luminate/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/services/environment/environment_service.py,sha256=IgrfzLELNhnEuz9rn2lYBvv3JQrgiNCGLA34pQ__nxY,4136
 orionis/luminate/services/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/services/files/path_service.py,sha256=opLl1k0QLPv9u9GCKENyRsLKhupM_0BDjXE_elk47EU,3039
+orionis/luminate/services/files/path_resolver_service.py,sha256=E-G_E2H5QAZyxeMssARp7l1OBSxQurxkUPoKdSOCKEE,2041
 orionis/luminate/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/log/log_service.py,sha256=aiENimOQHqaEAsBJz2_698bt1IeJjddHnledLKfg25o,5262
 orionis/luminate/support/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
@@ -144,9 +153,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=bhLQ7VGVod4B8sv-rW9AjnOumvaBVsoxieA3sdoM2yM,5244
-orionis-0.66.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.66.0.dist-info/METADATA,sha256=YfYKGVnCJTBnTK9N8bche5sGZkDfX5cDrOzxdiGHcV8,2978
-orionis-0.66.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.66.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.66.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.66.0.dist-info/RECORD,,
+orionis-0.70.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.70.0.dist-info/METADATA,sha256=YvDFh8uQw1pFuqduGSMEkhUCX1lh2mfDboTFjZ--KbU,2978
+orionis-0.70.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.70.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.70.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.70.0.dist-info/RECORD,,

orionis/luminate/services/files/path_service.py

@@ -1,91 +0,0 @@
-import os
-import threading
-from pathlib import Path
-from orionis.contracts.services.files.i_path_service import IPathService
-
-class PathService(IPathService):
-    """
-    A thread-safe singleton class for resolving and validating absolute paths.
-
-    This class resolves the absolute path for a given relative directory or file path
-    based on the script's execution directory. It ensures that the requested path is valid
-    (either a directory or a file) and provides methods to retrieve the resolved path.
-
-    Attributes
-    ----------
-    base_path : Path
-        The base path (current working directory) used for resolving relative paths.
-    route : str
-        The resolved absolute path to the directory or file.
-    """
-
-    _instance = None
-    _lock = threading.Lock()
-
-    def __new__(cls):
-        """
-        Override the __new__ method to ensure only one instance of the class is created.
-
-        Returns
-        -------
-        PathService
-            The singleton instance of the PathService class.
-        """
-        # Use the lock to ensure thread-safe instantiation
-        with cls._lock:
-            if cls._instance is None:
-                cls._instance = super().__new__(cls)
-                cls._instance._initialize()
-        return cls._instance
-
-    def _initialize(self):
-        """
-        Initializes the instance by setting the base path to the current working directory.
-        """
-        self.base_path = Path(os.getcwd())
-
-    def resolve(self, route: str) -> str:
-        """
-        Resolves and returns the absolute path as a string.
-
-        This method combines the base path (current working directory) with the provided
-        relative path, resolves it to an absolute path, and validates that it exists
-        and is either a directory or a file.
-
-        Parameters
-        ----------
-        route : str
-            The relative directory or file path to be resolved.
-
-        Returns
-        -------
-        str
-            The absolute path to the directory or file.
-
-        Raises
-        ------
-        ValueError
-            If the resolved path does not exist or is neither a directory nor a file.
-        """
-        # Combine base path with the relative route
-        real_path = (self.base_path / route).resolve()
-
-        # Validate that the path exists and is either a directory or a file
-        if not real_path.exists():
-            raise ValueError(f"The requested path does not exist: {real_path}")
-        if not (real_path.is_dir() or real_path.is_file()):
-            raise ValueError(f"The requested path is neither a directory nor a file: {real_path}")
-
-        self.route = str(real_path)
-        return self.route
-
-    def __str__(self) -> str:
-        """
-        Returns the resolved absolute path as a string (dunder method).
-
-        Returns
-        -------
-        str
-            The absolute path to the directory or file.
-        """
-        return self.route