orionis 0.64.0__tar.gz → 0.68.0__tar.gz

{orionis-0.64.0/orionis.egg-info → orionis-0.68.0}/PKG-INFO

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

orionis-0.68.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.64.0/orionis/contracts/services/files/i_path_service.py → orionis-0.68.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.64.0 → orionis-0.68.0}/orionis/framework.py

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

orionis-0.68.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.68.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.64.0 → orionis-0.68.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.68.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.64.0 → orionis-0.68.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.64.0 → orionis-0.68.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.app_context import AppContext
+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.
         """
-        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.
         """
-        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.
         """
-        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.
         """
-        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.
         """
-        LogguerService().debug(message)
+        _log_service : LogguerService = app(LogguerService)
+        return _log_service.debug(message)

orionis-0.68.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.68.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.68.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.68.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")

orionis-0.64.0/orionis/luminate/facades/environment/environment_facade.py → orionis-0.68.0/orionis/luminate/services/environment/environment_service.py

@@ -1,61 +1,21 @@
 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
-
-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):
-    """
-    A thread-safe singleton class that manages environment variables from a .env file.
-    """
-
-    _instance = None
-    _lock = threading.Lock()
-
-    def __new__(cls, path: str = None):
+from orionis.contracts.services.environment.i_environment_service import IEnvironmentService
+
+class EnvironmentService(IEnvironmentService):
+
+    def __init__(self, path: str = None):
+
         """
-        Override the __new__ method to ensure only one instance of the class is created.
+        Initializes the EnvironmentService instance.
 
         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
+        self._initialize(path)
 
     def _initialize(self, path: str = None):
         """

orionis-0.68.0/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.64.0 → orionis-0.68.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.64.0 → orionis-0.68.0}/orionis.egg-info/SOURCES.txt

@@ -52,8 +52,10 @@ orionis/contracts/providers/i_service_provider.py
 orionis/contracts/services/__init__.py
 orionis/contracts/services/config/__init__.py
 orionis/contracts/services/config/i_config_service.py
+orionis/contracts/services/environment/__init__.py
+orionis/contracts/services/environment/i_environment_service.py
 orionis/contracts/services/files/__init__.py
-orionis/contracts/services/files/i_path_service.py
+orionis/contracts/services/files/i_path_resolver_service.py
 orionis/contracts/services/log/__init__.py
 orionis/contracts/services/log/i_log_service.py
 orionis/contracts/support/i_exception_to_dict.py
@@ -71,6 +73,7 @@ orionis/luminate/bootstrap/command_bootstrapper.py
 orionis/luminate/bootstrap/config_bootstrapper.py
 orionis/luminate/bootstrap/environment_bootstrapper.py
 orionis/luminate/bootstrap/exception_bootstrapper.py
+orionis/luminate/bootstrap/service_providers_bootstrapper.py
 orionis/luminate/config/__init__.py
 orionis/luminate/config/app.py
 orionis/luminate/config/auth.py
@@ -108,6 +111,7 @@ orionis/luminate/container/container.py
 orionis/luminate/container/exception.py
 orionis/luminate/container/types.py
 orionis/luminate/facades/__init__.py
+orionis/luminate/facades/app.py
 orionis/luminate/facades/config/__init__.py
 orionis/luminate/facades/config/config_facade.py
 orionis/luminate/facades/environment/__init__.py
@@ -123,15 +127,20 @@ orionis/luminate/patterns/singleton.py
 orionis/luminate/pipelines/__init__.py
 orionis/luminate/pipelines/cli_pipeline.py
 orionis/luminate/providers/__init__.py
+orionis/luminate/providers/service_provider.py
 orionis/luminate/providers/config/__init__.py
 orionis/luminate/providers/config/config_service_provider.py
+orionis/luminate/providers/environment/__init__.py
+orionis/luminate/providers/environment/environment_provider.py
 orionis/luminate/providers/log/__init__.py
 orionis/luminate/providers/log/log_service_provider.py
 orionis/luminate/services/__init__.py
 orionis/luminate/services/config/__init__.py
 orionis/luminate/services/config/config_service.py
+orionis/luminate/services/environment/__init__.py
+orionis/luminate/services/environment/environment_service.py
 orionis/luminate/services/files/__init__.py
-orionis/luminate/services/files/path_service.py
+orionis/luminate/services/files/path_resolver_service.py
 orionis/luminate/services/log/__init__.py
 orionis/luminate/services/log/log_service.py
 orionis/luminate/support/dot_dict.py