orionis 0.50.0__tar.gz → 0.54.0__tar.gz

{orionis-0.50.0/orionis.egg-info → orionis-0.54.0}/PKG-INFO

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

orionis-0.50.0/orionis/contracts/support/i_environment.py → orionis-0.54.0/orionis/contracts/facades/environment/i_environment_facade.py

@@ -1,6 +1,6 @@
 from abc import ABC, abstractmethod
 
-class IEnvironment(ABC):
+class IEnv(ABC):
 
     @abstractmethod
     def _initialize(self, path: str = None):

{orionis-0.50.0 → orionis-0.54.0}/orionis/framework.py

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

orionis-0.54.0/orionis/luminate/app.py

@@ -0,0 +1,18 @@
+from orionis.luminate.container.container import Container
+from orionis.luminate.bootstrap.config_bootstrapper import ConfigBootstrapper
+from orionis.luminate.patterns.singleton import SingletonMeta
+
+class Application(metaclass=SingletonMeta):
+
+    def __init__(self):
+        self.container = Container()
+        self.container.instance(self.container)
+        self._bootstraping()
+
+    def _bootstraping(self):
+        config_bootstrapper = self.container.singleton(ConfigBootstrapper)
+        config = self.container.make(config_bootstrapper)
+        print(config)
+
+    def isBooted(self):
+        return True

orionis-0.50.0/orionis/luminate/support/environment.py → orionis-0.54.0/orionis/luminate/facades/environment/environment_facade.py

@@ -1,19 +1,61 @@
 import os
+import threading
 from pathlib import Path
 from dotenv import set_key, unset_key, dotenv_values
-from orionis.contracts.support.i_environment import IEnvironment
-from orionis.luminate.patterns.singleton import SingletonMeta
-
-class Environment(IEnvironment, metaclass=SingletonMeta):
-
-    def __init__(self, path: str = None):
+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 Environment().get(key, default)
+
+class Environment(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):
         """
-        Initialize the environment configuration.
+        Override the __new__ method to ensure only one instance of the class is created.
 
-        Args:
-            path (str, optional): The path to the configuration file. Defaults to None.
+        Parameters
+        ----------
+        path : str, optional
+            The path to the .env file. Defaults to None.
+
+        Returns
+        -------
+        Environment
+            The singleton instance of the Environment class.
         """
-        self._initialize(path)
+        # 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):
         """
@@ -25,7 +67,6 @@ class Environment(IEnvironment, metaclass=SingletonMeta):
         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"
 
@@ -50,7 +91,6 @@ class Environment(IEnvironment, metaclass=SingletonMeta):
         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)
 
@@ -68,7 +108,6 @@ class Environment(IEnvironment, metaclass=SingletonMeta):
         value : str
             The value to set.
         """
-
         # Set the value in the .env file
         set_key(str(self.path), key, value)
 
@@ -81,7 +120,6 @@ class Environment(IEnvironment, metaclass=SingletonMeta):
         key : str
             The key of the environment variable to remove.
         """
-
         # Remove the key from the .env file
         unset_key(str(self.path), key)
 
@@ -94,6 +132,5 @@ class Environment(IEnvironment, metaclass=SingletonMeta):
         dict
             A dictionary of all environment variables and their values.
         """
-
         # Return all environment variables
         return dotenv_values(self.path)

{orionis-0.50.0 → orionis-0.54.0}/orionis/luminate/facades/files/path_facade.py

@@ -1,6 +1,5 @@
 import os
 from orionis.contracts.facades.files.i_path_facade import IPath
-from orionis.luminate.app_context import AppContext
 from orionis.luminate.services.files.path_service import PathService
 
 class Path(IPath):
@@ -66,9 +65,7 @@ class Path(IPath):
         route = os.path.normpath(route)
 
         # Obtain the path service from the container
-        with AppContext() as app:
-            path_service : PathService = app.container.make(PathService)
-            return path_service.resolve(route)
+        PathService().resolve(route)
 
     @staticmethod
     def app(file: str = None):

{orionis-0.50.0 → orionis-0.54.0}/orionis/luminate/services/files/path_service.py

@@ -1,10 +1,11 @@
 import os
+import threading
 from pathlib import Path
 from orionis.contracts.services.files.i_path_service import IPathService
 
 class PathService(IPathService):
     """
-    A service class for resolving and validating absolute paths.
+    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
@@ -12,29 +13,37 @@ class PathService(IPathService):
 
     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.
-
-    Methods
-    -------
-    __init__(route: str)
-        Initializes the `PathService` and resolves the absolute path.
-    resolve() -> str
-        Returns the resolved absolute path as a string.
-    __str__() -> str
-        Returns the resolved absolute path as a string (dunder method).
     """
 
-    def __init__(self) -> None:
+    _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.
         """
-        Initializes the `PathService` and resolves the absolute path for a given relative path.
+        # 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
 
-        The path is resolved relative to the script's execution directory. It validates
-        that the resolved path exists and is either a directory or a file.
+    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.
@@ -58,7 +67,6 @@ class PathService(IPathService):
         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()
 
@@ -68,4 +76,16 @@ class PathService(IPathService):
         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)
+        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

{orionis-0.50.0 → orionis-0.54.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.50.0 → orionis-0.54.0}/orionis.egg-info/SOURCES.txt

@@ -56,7 +56,6 @@ orionis/contracts/services/files/__init__.py
 orionis/contracts/services/files/i_path_service.py
 orionis/contracts/services/log/__init__.py
 orionis/contracts/services/log/i_log_service.py
-orionis/contracts/support/i_environment.py
 orionis/contracts/support/i_exception_to_dict.py
 orionis/contracts/support/i_reflection.py
 orionis/contracts/support/i_std.py
@@ -79,7 +78,6 @@ orionis/luminate/config/cache.py
 orionis/luminate/config/cors.py
 orionis/luminate/config/database.py
 orionis/luminate/config/filesystems.py
-orionis/luminate/config/helpers.py
 orionis/luminate/config/logging.py
 orionis/luminate/config/mail.py
 orionis/luminate/config/queue.py
@@ -127,8 +125,6 @@ orionis/luminate/pipelines/cli_pipeline.py
 orionis/luminate/providers/__init__.py
 orionis/luminate/providers/config/__init__.py
 orionis/luminate/providers/config/config_service_provider.py
-orionis/luminate/providers/files/__init__.py
-orionis/luminate/providers/files/path_service_provider.py
 orionis/luminate/providers/log/__init__.py
 orionis/luminate/providers/log/log_service_provider.py
 orionis/luminate/services/__init__.py
@@ -139,7 +135,6 @@ orionis/luminate/services/files/path_service.py
 orionis/luminate/services/log/__init__.py
 orionis/luminate/services/log/log_service.py
 orionis/luminate/support/dot_dict.py
-orionis/luminate/support/environment.py
 orionis/luminate/support/exception_to_dict.py
 orionis/luminate/support/reflection.py
 orionis/luminate/support/std.py

orionis-0.50.0/orionis/contracts/facades/environment/i_environment_facade.py

@@ -1,40 +0,0 @@
-
-from abc import ABC, abstractmethod
-
-class IEnv(ABC):
-    """
-    A facade class for accessing environment variables.
-
-    This class provides a static method to retrieve environment variables
-    stored in the application context. It implements the `IEnv` interface.
-
-    Methods
-    -------
-    get(key: str, default=None) -> str
-        Retrieves the value of an environment variable.
-    """
-
-    @abstractmethod
-    def get(key: str, default=None) -> str:
-        """
-        Retrieves the value of an environment variable.
-
-        This method 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.
-        """
-        pass

orionis-0.50.0/orionis/luminate/app.py

@@ -1,103 +0,0 @@
-import traceback
-from orionis.luminate.container.container import Container
-from orionis.luminate.bootstrap.config_bootstrapper import Bootstrapper as BootstrapperConfig
-from orionis.luminate.patterns.singleton import SingletonMeta
-
-class Application(metaclass=SingletonMeta):
-    """
-    The main service container for the Orionis Framework, ensuring persistent dependency resolution.
-
-    This class acts as a singleton service container, similar to Laravel's Application class.
-    It maintains service bindings, ensures proper initialization, and prevents unnecessary re-instantiation.
-
-    Attributes
-    ----------
-    container : Container
-        The IoC container that holds all service bindings.
-    booted : bool
-        Indicates whether the application has been initialized.
-    error_info : tuple or None
-        Stores error information if an exception occurs during boot.
-
-    Methods
-    -------
-    boot()
-        Initializes the application and registers all necessary dependencies.
-    isBooted()
-        Checks if the application is currently running.
-    getError()
-        Retrieves stored error information, if any.
-    """
-
-    def __init__(self):
-        """Initializes the application with an empty dependency container."""
-        self.container = Container()
-        self.booted = False
-        self.error_info = None
-
-        self._config = {}
-
-    def register(self):
-        """
-        Registers all necessary service bindings with the application container.
-
-        This method is intended to be overridden by the user to define custom service bindings.
-        """
-        pass
-
-    def boot(self):
-        """
-        Boots the application and registers necessary dependencies.
-
-        This method ensures that all required services are bound to the container and instantiated.
-        If the application is already booted, it returns immediately.
-
-        Returns
-        -------
-        Application
-            The current instance of the application.
-
-        Raises
-        ------
-        Exception
-            If an error occurs during the boot process.
-        """
-        if self.booted:
-            return self
-
-        try:
-            # Config Bootstrapper and retrieve application configuration
-            boot_config = self.container.singleton(BootstrapperConfig)
-            app_config = self.container.make(boot_config)
-            self._config = app_config.get()
-
-            self.booted = True
-            return self
-
-        except Exception as e:
-            # Capture and store exception details
-            self.error_info = (e, traceback.format_exc())
-            raise
-
-    def isBooted(self):
-        """
-        Checks if the application has been successfully initialized.
-
-        Returns
-        -------
-        bool
-            True if the application has been booted, False otherwise.
-        """
-        return self.booted
-
-    def getError(self):
-        """
-        Retrieves the last stored error details.
-
-        Returns
-        -------
-        tuple or None
-            A tuple containing the exception instance and its formatted traceback if an error occurred;
-            otherwise, None.
-        """
-        return self.error_info

orionis-0.50.0/orionis/luminate/config/helpers.py

@@ -1,20 +0,0 @@
-from orionis.luminate.support.environment import Environment
-
-def env(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.
-    """
-    return Environment().get(key, default)

orionis-0.50.0/orionis/luminate/facades/environment/environment_facade.py

@@ -1,68 +0,0 @@
-from orionis.contracts.facades.environment.i_environment_facade import IEnv
-from orionis.luminate.app_context import AppContext
-
-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.
-    """
-    with AppContext() as app:
-        env : dict = app._environment_vars
-        return env.get(key, default)
-
-class Env(IEnv):
-    """
-    A facade class for accessing environment variables.
-
-    This class provides a static method to retrieve environment variables
-    stored in the application context. It implements the `IEnv` interface.
-
-    Methods
-    -------
-    get(key: str, default=None) -> str
-        Retrieves the value of an environment variable.
-    """
-
-    @staticmethod
-    def get(key: str, default=None) -> str:
-        """
-        Retrieves the value of an environment variable.
-
-        This method 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.
-        """
-        with AppContext() as app:
-            env : dict = app._environment_vars
-            return env.get(key, default)

orionis-0.50.0/orionis/luminate/providers/files/path_service_provider.py

@@ -1,26 +0,0 @@
-from orionis.contracts.providers.i_service_provider import IServiceProvider
-from orionis.luminate.container.container import Container
-from orionis.luminate.services.files.path_service import PathService
-
-class PathServiceProvider(IServiceProvider):
-
-    def register(self, container: Container) -> 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(PathService)
-
-    def boot(self, container: Container) -> 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)