orionis 0.42.0__py3-none-any.whl → 0.43.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/app.py

@@ -0,0 +1,99 @@
+import traceback
+from orionis.luminate.container.container import Container
+from orionis.luminate.cache.app.config import CacheConfig
+from orionis.luminate.bootstrap.config.register import Register
+from orionis.luminate.bootstrap.config.bootstrapper import Bootstrapper
+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
+
+    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:
+            # Register core services as singletons
+            self.container.singleton(CacheConfig)
+            self.container.singleton(Register)
+            self.container.singleton(Bootstrapper)
+
+            # Resolve the registered dependencies
+            self.container.make(Register)
+            self.container.make(Bootstrapper)
+
+            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/luminate/app_context.py

@@ -0,0 +1,58 @@
+from orionis.luminate.app import Application
+
+class AppContext:
+    """
+    Context manager for resolving dependencies within a valid Orionis application context.
+
+    This class ensures that Orionis is properly initialized before resolving dependencies,
+    similar to how Laravel’s `app()` helper works.
+
+    Methods
+    -------
+    __enter__()
+        Validates the application state and provides access to the service container.
+    __exit__(exc_type, exc_val, exc_tb)
+        Ensures exceptions propagate naturally.
+    """
+
+    def __enter__(self):
+        """
+        Validates that the Orionis application is booted before allowing access to the container.
+
+        Returns
+        -------
+        Container
+            The application’s IoC container instance.
+
+        Raises
+        ------
+        RuntimeError
+            If the application has not been properly initialized.
+        """
+        app = Application()
+        if not app.isBooted():
+            raise RuntimeError(
+                "Error: Not running within a valid Orionis Framework context. "
+                "Ensure that the Orionis application is correctly initialized."
+            )
+        return app.container
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        """
+        Allows exceptions to propagate naturally.
+
+        Parameters
+        ----------
+        exc_type : type
+            The exception type, if an error occurred.
+        exc_val : Exception
+            The exception instance, if an error occurred.
+        exc_tb : traceback
+            The traceback object associated with the exception, if an error occurred.
+
+        Returns
+        -------
+        bool
+            Always returns False to ensure exceptions are not suppressed.
+        """
+        return False

orionis/luminate/facades/config.py

@@ -1,6 +1,6 @@
 from orionis.luminate.container.container import Container
 from orionis.luminate.cache.app.config import CacheConfig
-from orionis.luminate.orionis import OrionisContext
+from orionis.luminate.app import OrionisContext
 
 class Config:
 

{orionis-0.42.0.dist-info → orionis-0.43.0.dist-info}/METADATA

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

{orionis-0.42.0.dist-info → orionis-0.43.0.dist-info}/RECORD

@@ -1,8 +1,9 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=9wNVJxB0HyqUbNesUvkwlsqTyUbZwK6R46iVLE5WVBQ,1715
-orionis/framework.py,sha256=TlT7nkQG2E_adhasSB1bze9IufktITLC1x24P5H2Ubo,1386
+orionis/framework.py,sha256=w-skVjle56yYri7y4-JudXFEnPxgzqAFQ-jKgobFre4,1386
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/orionis.py,sha256=HojY14tDsDZ38CeyOaQFMDsXz3hiTCbq8zscVsUmYls,3150
+orionis/luminate/app.py,sha256=w7uUYbbLiGcpf_dOao6t0k0BJzXEJ2KC2zbfBHO3tvo,3231
+orionis/luminate/app_context.py,sha256=MikUzwxyVC_ni-EWSNkVblrcM3SJTYwBjk4VoaC66x4,1837
 orionis/luminate/bootstrap/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/bootstrap/cli_exception.py,sha256=wDKfEW295c7-bavr7YUHK2CLYcTSZgjT9ZRSBne6GOE,1356
 orionis/luminate/bootstrap/commands/bootstrapper.py,sha256=TuXuQUzeaiDL8sJyZNdqnFl2h2MfxcnSU045IeIKVQE,4016
@@ -108,7 +109,7 @@ orionis/luminate/contracts/tools/exception_to_dict_interface.py,sha256=rCuhx2tmU
 orionis/luminate/contracts/tools/reflection_interface.py,sha256=k9y7So3Z-_QFBBaCl-4t50ZRixt1pcxPtpwlo1NrSGk,8140
 orionis/luminate/contracts/tools/std_interface.py,sha256=VtOlmz7c1llBRVzKnEBA4aJE5m0Y0w7pFJ_1TgG1-G0,1408
 orionis/luminate/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/config.py,sha256=5x-m8XNz_IEGNtnLqQ0rkRkVR2NCs_vPocbDOxZygow,324
+orionis/luminate/facades/config.py,sha256=Yiy9rhxsnRZYutXt0pyvgtTUzIJCI89ZhyafPFmT1qY,320
 orionis/luminate/facades/environment.py,sha256=HFnePQKzbBuJxKuL2bv3-6Fwm2xXeJdqDIpGTeY2HUM,2225
 orionis/luminate/facades/log.py,sha256=yHht-ok-eseVmwZgsAiHuFOS3MRLJ-YJrbG7VmHguMU,1643
 orionis/luminate/facades/paths.py,sha256=qXU9KvgNw54IsNc82_S66o198CA9bMZqO8wuCMW1Rnk,7300
@@ -147,9 +148,9 @@ tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/tools/class_example.py,sha256=dIPD997Y15n6WmKhWoOFSwEldRm9MdOHTZZ49eF1p3c,1056
 tests/tools/test_reflection.py,sha256=dNN5p_xAosyEf0ddAElmmmTfhcTtBd4zBNl7qzgnsc0,5242
-orionis-0.42.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.42.0.dist-info/METADATA,sha256=4pDDzZVrM92tNXgB5Uv7WfdTmpyoBOW6iUCyv7fKsT0,2978
-orionis-0.42.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.42.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.42.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.42.0.dist-info/RECORD,,
+orionis-0.43.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.43.0.dist-info/METADATA,sha256=wANx3owLTDihMBZ9BxkZbJ3lKwc1IW_AonBcTFXvWEw,2978
+orionis-0.43.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.43.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.43.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.43.0.dist-info/RECORD,,

orionis/luminate/orionis.py

@@ -1,109 +0,0 @@
-import traceback
-from orionis.luminate.container.container import Container
-from orionis.luminate.cache.app.config import CacheConfig
-from orionis.luminate.bootstrap.config.register import Register
-from orionis.luminate.bootstrap.config.bootstrapper import Bootstrapper
-from orionis.luminate.patterns.singleton import SingletonMeta
-
-class Orionis(metaclass=SingletonMeta):
-    """
-    Manages the Orionis application lifecycle, ensuring proper initialization
-    and cleanup while handling exceptions.
-    """
-
-    def __init__(self):
-        """Initialize Orionis with a container and setup state tracking."""
-        self.container = None
-        self.is_started = False
-        self.error_info = None
-
-    def __enter__(self):
-        """
-        Starts the Orionis application and registers required dependencies.
-
-        Returns
-        -------
-        Orionis
-            The initialized Orionis instance.
-
-        Raises
-        ------
-        Exception
-            If an error occurs during startup.
-        """
-        try:
-            if self.is_started:
-                return self
-
-            self.container = Container()
-
-            self.container.singleton(CacheConfig)
-            self.container.singleton(Register)
-            self.container.singleton(Bootstrapper)
-
-            self.container.make(Register)
-            self.container.make(Bootstrapper)
-
-            self.is_started = True
-            return self
-
-        except Exception as e:
-            self.error_info = (e, traceback.format_exc())
-            raise
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        """
-        Cleans up resources and ensures proper shutdown.
-
-        Returns
-        -------
-        bool
-            False to propagate exceptions.
-        """
-        self.container = None
-        self.is_started = False
-
-        if exc_type:
-            self.error_info = (exc_val, traceback.format_exc())
-            return False
-
-    def isStarted(self):
-        """Check if Orionis is currently active."""
-        return self.is_started
-
-    def getError(self):
-        """Retrieve stored error information."""
-        return self.error_info
-
-
-class OrionisContext:
-    """
-    Ensures that Orionis is running within a valid context before allowing access
-    to the dependency container.
-    """
-
-    def __enter__(self):
-        """
-        Validates that Orionis is active and provides access to its container.
-
-        Returns
-        -------
-        Container
-            The Orionis container instance.
-
-        Raises
-        ------
-        RuntimeError
-            If Orionis is not running.
-        """
-        orionis = Orionis()
-        if not orionis.isStarted():
-            raise RuntimeError(
-                "Error: Not running within a valid Orionis Framework context. "
-                "Ensure that the Orionis application is correctly initialized."
-            )
-        return orionis
-
-    def __exit__(self, exc_type, exc_val, exc_tb):
-        """Ensures exceptions propagate naturally."""
-        return False