orionis 0.66.0__tar.gz → 0.70.0__tar.gz

{orionis-0.66.0/orionis.egg-info → orionis-0.70.0}/PKG-INFO

@@ -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.70.0/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-0.66.0/orionis/contracts/services/files/i_path_service.py → orionis-0.70.0/orionis/contracts/services/files/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-0.66.0 → orionis-0.70.0}/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-0.66.0 → orionis-0.70.0}/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-0.70.0/orionis/luminate/bootstrap/environment_bootstrapper.py

@@ -0,0 +1,76 @@
+from typing import Dict
+from orionis.contracts.bootstrap.i_environment_bootstrapper import IEnvironmentBootstrapper
+from orionis.luminate.facades.app import app
+from orionis.luminate.services.environment.environment_service import EnvironmentService
+
+class EnvironmentBootstrapper(IEnvironmentBootstrapper):
+    """
+    A class responsible for loading and managing environment variables from a `.env` file.
+
+    This class implements the `IEnvironment` interface and provides functionality to
+    automatically load environment variables from a `.env` file located in the current
+    working directory. If the file does not exist, it creates it.
+
+    Attributes
+    ----------
+    _environment_vars : Dict[str, str]
+        A dictionary to store the loaded environment variables.
+    path : Path
+        The path to the `.env` file.
+
+    Methods
+    -------
+    __init__()
+        Initializes the `EnvironmentBootstrapper` and triggers the autoload process.
+    _autoload()
+        Loads environment variables from the `.env` file or creates the file if it does not exist.
+    """
+
+    def __init__(self) -> None:
+        """
+        Initializes the `EnvironmentBootstrapper` and triggers the autoload process.
+
+        The `_environment_vars` dictionary is initialized to store environment variables,
+        and the `_autoload` method is called to load variables from the `.env` file.
+        """
+        self._environment_vars: Dict[str, str] = {}
+        self._autoload()
+
+    def _autoload(self) -> None:
+        """
+        Loads environment variables from the `.env` file or creates the file if it does not exist.
+
+        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.
+        """
+        environment_service : EnvironmentService = app(EnvironmentService)
+        self._environment_vars = environment_service.all()
+
+    def get(self, key: str = None) -> str:
+        """
+        Retrieves the value of an environment variable by its key.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable to retrieve.
+
+        Returns
+        -------
+        str
+            The value of the environment variable.
+
+        Raises
+        ------
+        KeyError
+            If the environment variable does not exist.
+        """
+
+        if not key:
+            return self._environment_vars
+
+        if key not in self._environment_vars:
+            raise KeyError(f"Environment variable {key} not found")
+
+        return self._environment_vars[key]

orionis-0.70.0/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-0.70.0/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-0.66.0 → orionis-0.70.0}/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-0.70.0/orionis/luminate/facades/environment/environment_facade.py

@@ -0,0 +1,93 @@
+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:
+    """
+    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
+    -------
+    str
+        The value of the environment variable, or the default value if the variable
+        does not exist.
+    """
+    return Env.get(key, default)
+
+class Env(IEnv):
+
+
+    @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.
+
+        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.
+        """
+
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.get(key, default)
+
+    @staticmethod
+    def set(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.
+        """
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.set(key, value)
+
+    @staticmethod
+    def unset(key: str) -> None:
+        """
+        Removes an environment variable from the .env file.
+
+        Parameters
+        ----------
+        key : str
+            The key of the environment variable to remove.
+        """
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.unset(key)
+
+    @staticmethod
+    def all() -> dict:
+        """
+        Retrieves all environment variable values from the .env file.
+
+        Returns
+        -------
+        dict
+            A dictionary of all environment variables and their values.
+        """
+        _env_service : EnvironmentService = app(EnvironmentService)
+        return _env_service.all()

{orionis-0.66.0 → orionis-0.70.0}/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-0.66.0 → orionis-0.70.0}/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-0.70.0/orionis/luminate/providers/config/config_service_provider.py

@@ -0,0 +1,19 @@
+from orionis.luminate.providers.service_provider import ServiceProvider
+from orionis.luminate.services.config.config_service import ConfigService
+
+class ConfigServiceProvider(ServiceProvider):
+
+    def register(self,) -> None:
+        """
+        Registers services or bindings into the given container.
+        """
+        self._container_id = self.app.scoped(ConfigService)
+
+    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-0.70.0/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-0.70.0/orionis/luminate/providers/log/log_service_provider.py

@@ -0,0 +1,19 @@
+from orionis.luminate.providers.service_provider import ServiceProvider
+from orionis.luminate.services.log.log_service import LogguerService
+
+class LogServiceProvider(ServiceProvider):
+
+    def register(self) -> None:
+        """
+        Registers services or bindings into the given container.
+        """
+        self._container_id = self.app.singleton(LogguerService)
+
+    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-0.70.0/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")