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

orionis/framework.py

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

orionis/luminate/facades/config.py

@@ -7,4 +7,4 @@ class Config:
     @staticmethod
     def get():
         with OrionisContext() as ctx:
-            return ctx.make(CacheConfig).config
+            return ctx.container.make(CacheConfig).config

orionis/luminate/orionis.py

@@ -7,52 +7,35 @@ from orionis.luminate.patterns.singleton import SingletonMeta
 
 class Orionis(metaclass=SingletonMeta):
     """
-    Context manager for the Orionis application that handles startup and cleanup.
-
-    This class manages the lifecycle of an Orionis application instance.
-    It starts the application when entering the context and ensures that the
-    application is properly finished when exiting, capturing any exceptions that occur.
-
-    Attributes
-    ----------
-    is_started : bool
-        Flag indicating whether the application has been successfully started.
-    app : App
-        Instance of the Orionis application.
-    error_info : tuple or None
-        Tuple containing the exception instance and its formatted traceback if an error occurs;
-        otherwise, None.
+    Manages the Orionis application lifecycle, ensuring proper initialization
+    and cleanup while handling exceptions.
     """
 
     def __init__(self):
-        """
-        Initialize the OrionisContext.
-
-        Sets up the application instance and initializes state variables.
-        """
-        self.container = Container()
+        """Initialize Orionis with a container and setup state tracking."""
+        self.container = None
         self.is_started = False
         self.error_info = None
 
     def __enter__(self):
         """
-        Enter the runtime context and start the application.
-
-        Attempts to start the Orionis application. If successful, sets the active flag
-        and returns the context instance. If an exception is raised during startup,
-        captures the exception and its traceback before re-raising it.
+        Starts the Orionis application and registers required dependencies.
 
         Returns
         -------
-        OrionisContext
-            The current context instance with the application started.
+        Orionis
+            The initialized Orionis instance.
 
         Raises
         ------
         Exception
-            Re-raises any exception that occurs during the application startup.
+            If an error occurs during startup.
         """
         try:
+            if self.is_started:
+                return self
+
+            self.container = Container()
 
             self.container.singleton(CacheConfig)
             self.container.singleton(Register)
@@ -62,81 +45,65 @@ class Orionis(metaclass=SingletonMeta):
             self.container.make(Bootstrapper)
 
             self.is_started = True
-            OrionisContext().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):
         """
-        Exit the runtime context and finish the application.
-
-        Calls the application's finish method to perform cleanup regardless of whether
-        an exception occurred. If an exception occurred, captures its information and
-        returns False to indicate that the exception should not be suppressed.
-
-        Parameters
-        ----------
-        exc_type : type
-            The type of the exception raised (if any).
-        exc_val : Exception
-            The exception instance raised (if any).
-        exc_tb : traceback
-            The traceback associated with the exception (if any).
+        Cleans up resources and ensures proper shutdown.
 
         Returns
         -------
         bool
-            Always returns False so that any exception is propagated.
+            False to propagate exceptions.
         """
-        try:
-            self.container = None
-        finally:
-            self.is_started = False
+        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 the application is currently active.
-
-        Returns
-        -------
-        bool
-            True if the application has been started and is active, False otherwise.
-        """
+        """Check if Orionis is currently active."""
         return self.is_started
 
     def getError(self):
-        """
-        Retrieve the stored error information.
-
-        Returns
-        -------
-        tuple or None
-            A tuple containing the exception and its formatted traceback if an error occurred;
-            otherwise, None.
-        """
+        """Retrieve stored error information."""
         return self.error_info
 
-class OrionisContext(metaclass=SingletonMeta):
 
-    def __init__(self):
-        self.is_started = False
+class OrionisContext:
+    """
+    Ensures that Orionis is running within a valid context before allowing access
+    to the dependency container.
+    """
 
     def __enter__(self):
-        if self.is_started:
-            return Orionis()
-        raise Exception(
-            "Error: Not running within a valid Orionis Framework context. "
-            "Please ensure that you are using the proper context manager."
-        )
+        """
+        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):
-        pass
+        """Ensures exceptions propagate naturally."""
+        return False

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

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

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

@@ -1,8 +1,8 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=9wNVJxB0HyqUbNesUvkwlsqTyUbZwK6R46iVLE5WVBQ,1715
-orionis/framework.py,sha256=QNUxBn1Jbt-I_q5oRxU6SFR2XUkJIi_wkUbotEZfiU8,1386
+orionis/framework.py,sha256=TlT7nkQG2E_adhasSB1bze9IufktITLC1x24P5H2Ubo,1386
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/orionis.py,sha256=ZIvcgUotEzBJ3XyCOb99U_t6-sj0eMFguICIOjWdrZ8,4553
+orionis/luminate/orionis.py,sha256=HojY14tDsDZ38CeyOaQFMDsXz3hiTCbq8zscVsUmYls,3150
 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 +108,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=Wa8WDE6NmKVwwFO-MuLK_mhA7jLiZsEDz8f7Yo3myAA,314
+orionis/luminate/facades/config.py,sha256=5x-m8XNz_IEGNtnLqQ0rkRkVR2NCs_vPocbDOxZygow,324
 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 +147,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.41.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.41.0.dist-info/METADATA,sha256=WY13y9zN_a8QUXtxurKKCk09yjsYHrkBUaLUhuDOfWU,2978
-orionis-0.41.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.41.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.41.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.41.0.dist-info/RECORD,,
+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,,