orionis 0.223.0__py3-none-any.whl → 0.225.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/application.py

@@ -9,8 +9,7 @@ from orionis.luminate.foundation.console.command_bootstrapper import CommandsBoo
 from orionis.luminate.foundation.environment.environment_bootstrapper import EnvironmentBootstrapper
 from orionis.luminate.foundation.exceptions.exception_bootstrapper import BootstrapRuntimeError
 from orionis.luminate.foundation.providers.service_providers_bootstrapper import ServiceProvidersBootstrapper
-from orionis.luminate.patterns.singleton import SingletonMeta
-from orionis.luminate.support.async.async_io import AsyncExecutor
+from orionis.luminate.support.patterns.singleton import SingletonMeta
 
 class Application(metaclass=SingletonMeta):
     """
@@ -156,7 +155,7 @@ class Application(metaclass=SingletonMeta):
         """
         self._bootstrapping()
         self._loadCommands()
-        AsyncExecutor.run(self._bootServiceProviders())
+        # AsyncExecutor.run(self._bootServiceProviders())
         Application.boot()
 
     async def _bootServiceProviders(self) -> None:

orionis/luminate/container/resolve.py

@@ -1,7 +1,6 @@
 from typing import Any, Callable
 from orionis.luminate.container.container import Container
 from orionis.luminate.container.exception import OrionisContainerValueError
-from orionis.luminate.support.async.async_io import AsyncExecutor
 
 class Resolve:
     """
@@ -62,4 +61,4 @@ class Resolve:
             )
 
         # Resolve and return the service associated with the abstract or alias
-        return AsyncExecutor.run(container.make(abstract_or_alias))
+        # return AsyncExecutor.run(container.make(abstract_or_alias))

orionis/luminate/foundation/environment/environment_bootstrapper.py

@@ -1,6 +1,7 @@
 from typing import Dict
 from orionis.luminate.contracts.foundation.environment.environment_bootstrapper import IEnvironmentBootstrapper
-from orionis.luminate.services.environment.environment_service import EnvironmentService
+from orionis.luminate.support.environment.env import Env
+# from orionis.luminate.services.environment.environment_service import EnvironmentService
 
 class EnvironmentBootstrapper(IEnvironmentBootstrapper):
     """
@@ -43,7 +44,7 @@ class EnvironmentBootstrapper(IEnvironmentBootstrapper):
         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.
         """
-        environment_service = EnvironmentService()
+        environment_service =Env()
         self._environment_vars = environment_service.all()
 
     def get(self, key: str = None) -> str:

orionis/luminate/support/environment/env.py

@@ -0,0 +1,104 @@
+import os
+from typing import Any, Optional, Union
+from dotenv import set_key, unset_key, dotenv_values
+from orionis.luminate.support.environment.functions import (
+    _initialize,
+    _parse_value,
+    _serialize_value,
+)
+
+class Env:
+    """
+    A utility class for managing environment variables stored in a `.env` file.
+    """
+
+    @staticmethod
+    def get(key: str, default: Optional[Any] = None) -> Any:
+        """
+        Retrieves the value of an environment variable from the `.env` file.
+
+        Parameters
+        ----------
+        path : str or Path, optional
+            The path to the `.env` file. If None, a default path is used.
+        key : str
+            The name of the environment variable to retrieve.
+        default : Any, optional
+            The default value to return if the variable is not found.
+
+        Returns
+        -------
+        Any
+            The value of the environment variable, parsed into its appropriate type,
+            or the default value if the variable is not found.
+        """
+        resolved_path = _initialize()
+        value = dotenv_values(resolved_path).get(key) or os.getenv(key)
+        return _parse_value(value) if value is not None else default
+
+    @staticmethod
+    def set(key: str, value: Union[str, int, float, bool, list, dict]) -> None:
+        """
+        Sets the value of an environment variable in the `.env` file.
+
+        Parameters
+        ----------
+        path : str or Path, optional
+            The path to the `.env` file. If None, a default path is used.
+        key : str
+            The name of the environment variable to set.
+        value : str, int, float, bool, list, or dict
+            The value to assign to the environment variable. It will be serialized
+            before being stored.
+
+        Returns
+        -------
+        None
+        """
+        resolved_path = _initialize()
+        serialized_value = _serialize_value(value)
+        set_key(str(resolved_path), key, serialized_value)
+
+    @staticmethod
+    def unset(key: str) -> None:
+        """
+        Removes an environment variable from the `.env` file.
+
+        Parameters
+        ----------
+        path : str or Path, optional
+            The path to the `.env` file. If None, a default path is used.
+        key : str
+            The name of the environment variable to remove.
+
+        Returns
+        -------
+        None
+        """
+        resolved_path = _initialize()
+        unset_key(str(resolved_path), key)
+
+    @staticmethod
+    def all() -> dict:
+        """
+        Retrieves all environment variables from the `.env` file.
+
+        Parameters
+        ----------
+        path : str or Path, optional
+            The path to the `.env` file. If None, a default path is used.
+
+        Returns
+        -------
+        dict
+            A dictionary containing all environment variables from the `.env` file,
+            with their values parsed into their appropriate types.
+        """
+        resolved_path = _initialize()
+        env_vars = {}
+        data = dotenv_values(resolved_path)
+
+        for key, value in data.items():
+            env_vars[key] = _parse_value(value)
+
+        return env_vars

orionis/luminate/support/environment/functions.py

@@ -0,0 +1,41 @@
+import ast
+import os
+from pathlib import Path
+from typing import Any
+
+def _initialize() -> Path:
+    """
+    Inicializa la ruta al archivo `.env`.
+    """
+    resolved_path = Path(os.getcwd()) / ".env"
+
+    # Asegurarse de que el archivo .env exista
+    if not resolved_path.exists():
+        resolved_path.touch()
+
+    return resolved_path
+
+def _parse_value(value: Any) -> Any:
+    """
+    Parsea un valor de cadena en un tipo de dato de Python.
+    """
+    value = str(value).strip() if value is not None else None
+
+    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)
+    try:
+        return ast.literal_eval(value)
+    except (ValueError, SyntaxError):
+        return value
+
+def _serialize_value(value: Any) -> str:
+    """
+    Serializa un tipo de dato de Python en una cadena para almacenarlo en el archivo `.env`.
+    """
+    if isinstance(value, (list, dict, bool, int, float)):
+        return repr(value)
+    return str(value)

orionis/luminate/support/environment/helper.py

@@ -0,0 +1,26 @@
+from typing import Any
+from orionis.luminate.support.environment.env import Env
+
+def env(key: str, default = None) -> Any:
+    """
+    Retrieves the value of an environment variable.
+
+    This function provides a convenient way to access environment variables
+    stored in the application context. If the variable does not exist, it
+    returns the specified default value.
+
+    Parameters
+    ----------
+    key : str
+        The name of the environment variable to retrieve.
+    default : Any, optional
+        The default value to return if the environment variable does not exist.
+        Defaults to None.
+
+    Returns
+    -------
+    Any
+        The value of the environment variable, or the default value if the variable
+        does not exist.
+    """
+    return Env.get(key, default)

orionis/luminate/support/paths/contracts/resolver.py

@@ -0,0 +1,67 @@
+from abc import ABC, abstractmethod
+from typing import Optional
+
+class IResolver(ABC):
+    """
+    Interface for a utility class that resolves file and directory paths relative to a base path.
+    """
+
+    @abstractmethod
+    def __init__(self, root_path: Optional[str] = None):
+        """
+        Initializes the resolver with an optional root path.
+
+        Parameters
+        ----------
+        root_path : str, optional
+            The root directory to resolve relative paths from.
+        """
+        pass
+
+    @abstractmethod
+    def relativePath(self, relative_path: str):
+        """
+        Resolves a relative path into an absolute one and validates its existence.
+
+        Parameters
+        ----------
+        relative_path : str
+            The relative path to resolve.
+
+        Returns
+        -------
+        ResolverInterface
+            The instance itself for method chaining.
+
+        Raises
+        ------
+        FileNotFoundError
+            If the resolved path does not exist.
+        ValueError
+            If the resolved path is neither a file nor a directory.
+        """
+        pass
+
+    @abstractmethod
+    def toString(self) -> str:
+        """
+        Returns the resolved path as a string.
+
+        Returns
+        -------
+        str
+            The resolved path.
+        """
+        pass
+
+    @abstractmethod
+    def __str__(self) -> str:
+        """
+        Returns the resolved path as a string (for print or str()).
+
+        Returns
+        -------
+        str
+            The resolved path.
+        """
+        pass

orionis/luminate/support/paths/resolver.py

@@ -0,0 +1,83 @@
+import os
+from pathlib import Path
+from orionis.luminate.support.paths.contracts.resolver import IResolver
+
+class Resolver(IResolver):
+    """
+    A utility class for resolving file and directory paths relative to the project's root directory.
+    """
+
+    def __init__(self, root_path: str = None):
+        """
+        Initializes the Resolver instance with the project's root directory.
+
+        Parameters
+        ----------
+        root_path : str, optional
+            The root directory of the project. If not provided, it defaults to the current working directory.
+        """
+        self.base_path = Path(root_path).resolve() if root_path else Path(os.getcwd()).resolve()
+        self.resolved_path = None
+
+    def relativePath(self, relative_path: str) -> 'Resolver':
+        """
+        Resolves a given relative path to an absolute path and validates its existence.
+
+        This method combines the project's root directory with the provided relative path,
+        resolves it to an absolute path, and ensures it exists as either a directory or a file.
+
+        Parameters
+        ----------
+        relative_path : str
+            The relative path to a directory or file to be resolved.
+
+        Returns
+        -------
+        Resolver
+            The current instance of the Resolver class with the resolved path.
+
+        Raises
+        ------
+        FileNotFoundError
+            If the resolved path does not exist.
+        ValueError
+            If the resolved path is neither a valid directory nor a file.
+        """
+        # Combine the base path with the relative path and resolve it
+        resolved_path = (self.base_path / relative_path).resolve()
+
+        # Validate that the path exists
+        if not resolved_path.exists():
+            raise FileNotFoundError(f"The requested path does not exist: {resolved_path}")
+
+        # Validate that the path is either a directory or a file
+        if not (resolved_path.is_dir() or resolved_path.is_file()):
+            raise ValueError(f"The requested path is neither a valid directory nor a file: {resolved_path}")
+
+        # Store the resolved path in the instance variable
+        self.resolved_path = resolved_path
+
+        # Return the current instance
+        return self
+
+    def toString(self) -> str:
+        """
+        Returns the string representation of the resolved path.
+
+        Returns
+        -------
+        str
+            The resolved path as a string.
+        """
+        return str(self.resolved_path)
+
+    def __str__(self) -> str:
+        """
+        Returns the string representation of the resolved path.
+
+        Returns
+        -------
+        str
+            The resolved path as a string.
+        """
+        return str(self.resolved_path)

{orionis-0.223.0.dist-info → orionis-0.225.0.dist-info}/METADATA

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

{orionis-0.223.0.dist-info → orionis-0.225.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console.py,sha256=4gYWxf0fWYgJ4RKwARvnTPh06FL3GJ6SAZ7R2NzOICw,1342
-orionis/framework.py,sha256=3CtL5RE88aY3ytj57zC1hrhgUabiCYcqG9djYM5up1k,1458
+orionis/framework.py,sha256=TmXoK20GzRH5EFAjlvUZYkiWA9JLEqDtzW0SOPe8rCs,1458
 orionis/installer/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/installer/manager.py,sha256=Li4TVziRXWfum02xNG4JHwbnLk-u8xzHjdqKz-D894k,2755
 orionis/installer/output.py,sha256=7O9qa2xtXMB_4ZvVi-Klneom9YazwygAd_4uYAoxhbU,8548
@@ -10,7 +10,7 @@ orionis/installer/contracts/manager.py,sha256=Zfndhuyu0JaTKo3PsGsKmVsvotQMw8Pmt4
 orionis/installer/contracts/output.py,sha256=t1KLw610-hHy63UbFFE2BYwWHWRbW8_ofuEvRLx_IUE,983
 orionis/installer/contracts/setup.py,sha256=aWYkCv-z48bXXZynYapc3uMIE1gyO6XnkTw3b4MTBq4,784
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/application.py,sha256=q48CQ79vuSjg1WbU6cqMnxdyQctCtqxyvLyGuo_C7Go,9532
+orionis/luminate/application.py,sha256=6pnmBJVjiTY8O0MXfCXt1nX7PzslBPTFyol_3uwjqnQ,9475
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/app.py,sha256=o-Ons0LMp77_E18e_dx_DqGVbjaY2l-5RdVSCILxgfg,1655
 orionis/luminate/config/auth.py,sha256=ivAUgoEYEtfdC49vDwOl_MXFUVAQnUJTc8iG3Lu0Stc,430
@@ -48,7 +48,7 @@ orionis/luminate/container/container.py,sha256=9xdODX1h4YK6V-THrfgm5XN95imobExzr
 orionis/luminate/container/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
 orionis/luminate/container/lifetimes.py,sha256=2lbdiV7R2WlJf1cLD6eBxLnJud_lZvX1IhQH2Djy3Ww,375
-orionis/luminate/container/resolve.py,sha256=JZCCwdGOHkd7gc8t7AMars2dmbqEr_k2XnNbNU6kTlk,2312
+orionis/luminate/container/resolve.py,sha256=JW-jep8Qo6SEA8owpiqcaKc5SdzIL2x_Wmr1kFwj3lQ,2247
 orionis/luminate/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/contracts/application.py,sha256=FIR6WMY0y-Hkjp0jWfjJV9kwIqBb-RB1-Jl0GWCk9eI,1077
 orionis/luminate/contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -126,7 +126,7 @@ orionis/luminate/foundation/config/config_bootstrapper.py,sha256=Zdk3C-asIc0zizR
 orionis/luminate/foundation/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/foundation/console/command_bootstrapper.py,sha256=o1R3puuDyRIf3KXfxyluj6KixPTg96JD2V6TYKLOonw,7064
 orionis/luminate/foundation/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/foundation/environment/environment_bootstrapper.py,sha256=ckS32khBvLXe_8Xu3iAAyJ3aDKhA6qnCafqtJy2WzXA,2727
+orionis/luminate/foundation/environment/environment_bootstrapper.py,sha256=5CUT4HZJTxaqYw2PUIkjXLlUZhfzNHohOvw0dY3McBY,2771
 orionis/luminate/foundation/exceptions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/foundation/exceptions/exception_bootstrapper.py,sha256=wDKfEW295c7-bavr7YUHK2CLYcTSZgjT9ZRSBne6GOE,1356
 orionis/luminate/foundation/exceptions/exception_providers.py,sha256=VxrzuDRKXn8b73xKINPb-FxBusUz8ITXCu0KZh7Pm2o,1329
@@ -151,10 +151,6 @@ orionis/luminate/services/commands/reactor_commands_service.py,sha256=oca_xPEQ_d
 orionis/luminate/services/commands/scheduler_service.py,sha256=mKy5I293GtpH98U4rOGXvcpqYwPVvp1cfceXdk53dsQ,22483
 orionis/luminate/services/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/config/config_service.py,sha256=RKZ194_0RAEkRFSm3OPoDDdme0_wyBZNLaEQhIVdbYk,2114
-orionis/luminate/services/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/services/environment/environment_service.py,sha256=GdrXWmOK2lWpa6GkIwFI8kHee5hQel_cIF9sduRfGfo,4776
-orionis/luminate/services/files/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/services/files/path_resolver_service.py,sha256=gCGVLtdXGuEIE6I8tm6JEB84HS1Fa5rk2whO2R6u8Wc,1698
 orionis/luminate/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/services/log/log_service.py,sha256=jrCrKz7Uj6n_ri-v5A4YOILQGUQ9MAmrlSizbbOvKhI,8303
 orionis/luminate/support/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -162,7 +158,12 @@ orionis/luminate/support/adapters/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeR
 orionis/luminate/support/adapters/dot_dict.py,sha256=FVHfBuAGTTVMjNG01Fix645fRNKKUMmNx61pYkxPL5c,1253
 orionis/luminate/support/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/asynchrony/async_io.py,sha256=IkgVrJnnvNExkhy9brfZpTq2EXptyg3ZB2_ZSH9xDe8,1591
+orionis/luminate/support/asynchrony/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/asynchrony/contracts/async_coroutine.py,sha256=lwtDa6r7I6qbxzKr5MyJtMRaYW6e5j2dbymEPNaNIEo,614
+orionis/luminate/support/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/environment/env.py,sha256=MgFZ53fG77eugimdXfuYsbpXBadgi0KaM3b_DNB02D8,3291
+orionis/luminate/support/environment/functions.py,sha256=qiKc2oPaWwspSeUF0E8ZZYMsKlFDI1VGLl6vfpAnP4s,1129
+orionis/luminate/support/environment/helper.py,sha256=G1670w1xkI1pj-rW_inv6D3XmU4oliwnWnrJO5CBm2E,818
 orionis/luminate/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/inspection/container_integrity.py,sha256=6d9FsGk-Rm1AXgqBS3Nww49dR7n1ptXTTNyGUuBHgNY,10111
 orionis/luminate/support/inspection/functions.py,sha256=4wDT7iNp-5l4vuHk0UsIxN9wakASJRD4V0KY24uMDzk,7227
@@ -181,6 +182,10 @@ orionis/luminate/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRk
 orionis/luminate/support/parsers/exception_parser.py,sha256=6MTeql76c1Muh9Nn-jz2jJdzb9_F7SLdoFjqBD5F8lY,3642
 orionis/luminate/support/parsers/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/parsers/contracts/exception_parser.py,sha256=HcWN7nJrvD7xLREPKEnBhyG30IkkAB7Bx_hGpcfb0ZE,912
+orionis/luminate/support/paths/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/paths/resolver.py,sha256=hsJCY0kvYGqSGuiZL-IdVp2YShiaOvbWKcbwqTHc9X0,2829
+orionis/luminate/support/paths/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/luminate/support/paths/contracts/resolver.py,sha256=v7uTgByE2nQS2ZM_b1rtMzY6HH03MNKfAYQoTswPf9o,1627
 orionis/luminate/support/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/support/patterns/singleton.py,sha256=b3U0nubKSQWyal5wTXADVPtOztkaTk-M8Zwy-bje1L0,1425
 orionis/luminate/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -218,6 +223,9 @@ tests/support/adapters/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 tests/support/adapters/fakes/fake_dict.py,sha256=KD48_xBc8pqj3LAe1_v1esu-1Fdz8fL5eZ70LSqkcbg,393
 tests/support/async_io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/async_io/test_async_coroutine.py,sha256=qXmpfyqaeNUSRQFdKVViGiF2FsRQle9VqyFeR-jAetg,1532
+tests/support/environment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/environment/test_env.py,sha256=jRJ2Xa7_cEnZg-1KzHOIDvGa0vQ-GxIw3u-MhuC3Aks,1899
+tests/support/environment/test_helper.py,sha256=YDTJMl-zAivnchPJMDzDh520GP73OL-nbU_LzRuZCeA,414
 tests/support/inspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/inspection/test_reflection_abstract.py,sha256=6w8vm8H_fR4Z-KYjQGm8bq-HcetlpQl0EsDmDy3WzQ8,9311
 tests/support/inspection/test_reflection_concrete.py,sha256=3BWSU7MkFEv2UgAVAwhiaMrzEwAyDBBJCa6edOENKSU,6782
@@ -234,13 +242,15 @@ tests/support/parsers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3h
 tests/support/parsers/test_exception_parser.py,sha256=s-ZRbxyr9bs5uis2SM0IN-vCc-AJhWqRnEMIVgeEFXE,2363
 tests/support/parsers/fakes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/parsers/fakes/fake_custom_error.py,sha256=BD8tQPhmIYFYVcaeMpEQ6uK1d6pcU4EGbwRkVfCZp7c,802
+tests/support/path/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tests/support/path/test_resolver.py,sha256=VkHeHu87Hmmq4_mHB6jM8OsjxDyWgB-5E7KGAn-dRe0,1258
 tests/support/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/patterns/test_singleton.py,sha256=U5uwpgGcP7-fIazsnFLwg30mmc24S62udhVIHuL-scY,634
 tests/support/standard/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/support/standard/test_std.py,sha256=bJ5LV_OKEEZa_Bk3PTk9Kapk6qECLzcKf0hfR_x2QqM,2042
-orionis-0.223.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.223.0.dist-info/METADATA,sha256=J342L_1JSvDAMScCxwplIcVB-v1fh2A_ZiJIj-syD4Q,3003
-orionis-0.223.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.223.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
-orionis-0.223.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.223.0.dist-info/RECORD,,
+orionis-0.225.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.225.0.dist-info/METADATA,sha256=B0oTyxhlmB97eRjZp_pOy3H3-kfEz7qHBTOYiB0AAUw,3003
+orionis-0.225.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.225.0.dist-info/entry_points.txt,sha256=a_e0faeSqyUCVZd0MqljQ2oaHHdlsz6g9sU_bMqi5zQ,49
+orionis-0.225.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.225.0.dist-info/RECORD,,

tests/support/environment/test_env.py

@@ -0,0 +1,64 @@
+from orionis.luminate.support.environment.env import Env
+from orionis.luminate.test.test_case import TestCase
+
+class TestsEnvironment(TestCase):
+
+    async def testGetEnvVariable(self):
+        """
+        Test retrieving an environment variable from the `.env` file.
+        """
+
+        # Mock the environment setup
+        Env.set('TEST_KEY', 'TEST_VALUE')
+
+        # Test the get method
+        result = Env.get('TEST_KEY')
+        self.assertEqual(result, "TEST_VALUE")
+
+        # Test with a non-existent key
+        result = Env.get('NON_EXISTENT_KEY', True)
+        self.assertEqual(result, True)
+
+    async def testSetEnvVariable(self):
+        """
+        Test setting an environment variable in the `.env` file.
+        """
+
+        # Set the environment variable
+        Env.set('TEST_KEY', 'NEW_VALUE')
+
+        # Verify the value was set correctly
+        result = Env.get('TEST_KEY')
+        self.assertEqual(result, 'NEW_VALUE')
+
+    async def testUnsetEnvVariable(self):
+        """
+        Test removing an environment variable from the `.env` file.
+        """
+
+        # Set and then unset the environment variable
+        Env.set('TEST_KEY', "TEST_VALUE")
+        Env.unset('TEST_KEY')
+
+        # Verify the variable was removed
+        result = Env.get('TEST_KEY')
+        self.assertIsNone(result)
+
+    async def test_get_all_env_variables(self):
+        """
+        Test retrieving all environment variables from the `.env` file.
+        """
+
+        # Mock the environment setup
+        Env.set('KEY1', 'value1')
+        Env.set('KEY2', 'value2')
+
+        # Retrieve all environment variables
+        result = Env.all()
+
+        # Verify the result
+        self.assertEqual(result.get('KEY1'), 'value1')
+        self.assertEqual(result.get('KEY2'), 'value2')
+
+        Env.unset('KEY1')
+        Env.unset('KEY2')

tests/support/environment/test_helper.py

@@ -0,0 +1,11 @@
+from orionis.luminate.support.environment.helper import env
+from orionis.luminate.test.test_case import TestCase
+
+class TestsEnvironmentHelper(TestCase):
+
+    async def testGetEnvHelper(self):
+        """"
+        Test retrieving an environment variable using the env helper.
+        """
+        result = env('FRAMEWORK')
+        self.assertEqual(result, 'https://github.com/orionis-framework/framework')

tests/support/path/test_resolver.py

@@ -0,0 +1,33 @@
+from orionis.luminate.support.paths.resolver import Resolver
+from orionis.luminate.test.test_case import TestCase
+
+class TestsResolver(TestCase):
+
+    async def testFileNotFound(self):
+        """
+        Test the Resolver class for a non-existent file path.
+        """
+        file_path = "non_existent_file.txt"
+        with self.assertRaises(FileNotFoundError):
+            Resolver().relativePath(file_path)
+
+    async def testValidFilePath(self):
+        """
+        Test the Resolver class for a valid file path.
+        """
+        path = Resolver().relativePath('orionis/luminate/test/test_suite.py').toString()
+        self.assertTrue(path.endswith('test_suite.py'))
+
+    async def testOtherBasePath(self):
+        """
+        Test the Resolver class for a different base path.
+        """
+        path = Resolver('orionis/luminate/test').relativePath('test_suite.py').toString()
+        self.assertTrue(path.endswith('test_suite.py'))
+
+    async def testEqualOutputString(self):
+        """
+        Test the Resolver class for a string representation of the resolved path.
+        """
+        path = Resolver().relativePath('orionis/luminate/test/test_suite.py')
+        self.assertEqual(path.toString(), str(path))

orionis/luminate/services/environment/environment_service.py

@@ -1,154 +0,0 @@
-import ast
-import os
-from pathlib import Path
-from typing import Any
-from dotenv import set_key, unset_key, dotenv_values
-
-def env(key: str, default = None) -> Any:
-    """
-    Retrieves the value of an environment variable.
-
-    This function provides a convenient way to access environment variables
-    stored in the application context. If the variable does not exist, it
-    returns the specified default value.
-
-    Parameters
-    ----------
-    key : str
-        The name of the environment variable to retrieve.
-    default : Any, optional
-        The default value to return if the environment variable does not exist.
-        Defaults to None.
-
-    Returns
-    -------
-    Any
-        The value of the environment variable, or the default value if the variable
-        does not exist.
-    """
-    return EnvironmentService().get(key, default)
-
-class EnvironmentService:
-
-    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

@@ -1,50 +0,0 @@
-import os
-from pathlib import Path
-
-class PathResolverService:
-
-    def __init__(self):
-        """
-        Override the __new__ method to ensure only one instance of the class is created.
-
-        Returns
-        -------
-        PathResolverService
-            The singleton instance of the PathResolverService class.
-        """
-        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
-        ------
-        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 str(real_path).endswith('.log'):
-            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)