orionis 0.111.0__py3-none-any.whl → 0.113.0__py3-none-any.whl

orionis/framework.py

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

orionis/luminate/{app.py → application.py}

@@ -1,6 +1,6 @@
 from typing import Any, Callable
+from contextlib import contextmanager
 from orionis.contracts.foundation.i_bootstraper import IBootstrapper
-from orionis.luminate.console.output.console import Console
 from orionis.luminate.container.container import Container
 from orionis.luminate.foundation.config.config_bootstrapper import ConfigBootstrapper
 from orionis.luminate.foundation.console.command_bootstrapper import CommandsBootstrapper
@@ -37,6 +37,33 @@ class Application(metaclass=SingletonMeta):
     _afterBootstrapProviders()
         Registers and boots additional providers after bootstrapping.
     """
+    booted = False
+
+    @classmethod
+    def started(cls):
+        """
+        Marks the application as booted.
+        """
+        cls.booted = True
+
+    @classmethod
+    def getCurrentInstance(cls):
+        """
+        Returns the existing application instance if available.
+
+        Returns
+        -------
+        Application
+            The current singleton instance of the application.
+
+        Raises
+        ------
+        RuntimeError
+            If no instance has been initialized yet.
+        """
+        if cls not in SingletonMeta._instances:
+            raise RuntimeError("Application has not been initialized yet. Please create an instance first.")
+        return SingletonMeta._instances[cls]
 
     def __init__(self, container: Container):
         """
@@ -58,10 +85,6 @@ class Application(metaclass=SingletonMeta):
         # Initialize the application container
         self.container = container
         self.container.instance(container)
-        try:
-            self._boot()
-        except Exception as e:
-            Console.exception(e)
 
     def isBooted(self) -> bool:
         """
@@ -189,7 +212,7 @@ class Application(metaclass=SingletonMeta):
         """
         return self.container.forgetScopedInstances()
 
-    def _boot(self):
+    def boot(self):
         """
         Bootstraps the application by loading environment configuration and core providers.
         Notes
@@ -207,7 +230,9 @@ class Application(metaclass=SingletonMeta):
         self._bootstrapping()
         self._afterBootstrapProviders()
         self._loadCommands()
-        self._booted = True
+
+        # Mark the application as booted
+        Application.started()
 
     def _bootServices(self):
         """
@@ -303,4 +328,60 @@ class Application(metaclass=SingletonMeta):
         for service in self._after_boot_service_providers:
             _environment_provider : ServiceProvider = service(app=self.container)
             _environment_provider.register()
-            _environment_provider.boot()
+            _environment_provider.boot()
+
+@contextmanager
+def app_context():
+    """
+    Context manager for creating an instance of the Orionis application.
+
+    This function initializes the Orionis application with a new container,
+    ensuring that the application is properly set up before use.
+
+    Yields
+    ------
+    Application
+        The initialized Orionis application instance.
+
+    Raises
+    ------
+    RuntimeError
+        If the application has not been properly initialized.
+    """
+    try:
+
+        # Check if the application has been booted
+        if not Application.booted:
+            # Create a new application instance
+            app = Application(Container())
+            app.boot()
+        else:
+            # Get the current application instance
+            app = Application.getCurrentInstance()
+
+        # Yield the application instance
+        yield app
+
+    finally:
+
+        # Close Context Manager
+        pass
+
+def app_booted():
+    """
+    Context manager for creating an instance of the Orionis application.
+
+    This function initializes the Orionis application with a new container,
+    ensuring that the application is properly set up before use.
+
+    Yields
+    ------
+    Application
+        The initialized Orionis application instance.
+
+    Raises
+    ------
+    RuntimeError
+        If the application has not been properly initialized.
+    """
+    return Application.booted

orionis/luminate/console/commands/help.py

@@ -1,4 +1,4 @@
-from orionis.luminate.app_context import app_context
+from orionis.luminate.application import app_context
 from orionis.luminate.console.base.command import BaseCommand
 from orionis.luminate.console.exceptions.cli_exception import CLIOrionisRuntimeError
 

orionis/luminate/facades/app.py

@@ -1,6 +1,8 @@
 from typing import Any
+from orionis.luminate.application import app_booted
+from orionis.luminate.console.output.console import Console
 from orionis.luminate.container.container import Container
-from orionis.luminate.container.exception import OrionisContainerTypeError
+from orionis.luminate.container.exception import OrionisContainerException, OrionisContainerTypeError
 
 def app(concrete: Any = None):
     """
@@ -27,6 +29,9 @@ def app(concrete: Any = None):
     OrionisContainerException
         If `concrete` is not bound to the container.
     """
+    if not app_booted():
+        Console.error("The application context is not valid.")
+        raise OrionisContainerException("The application context is not valid.")
 
     # Create a new container instance
     container : Container = Container()

{orionis-0.111.0.dist-info → orionis-0.113.0.dist-info}/METADATA

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

{orionis-0.111.0.dist-info → orionis-0.113.0.dist-info}/RECORD

@@ -1,6 +1,6 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/cli_manager.py,sha256=0bM-hABXJSoPGuvEgnqeaj9qcLP8VjTQ3z9Mb0TSEUI,1381
-orionis/framework.py,sha256=LJ4bB-pQZajXH743nG2PW3jk3E59MsEaUCkk_24X8Zk,1387
+orionis/framework.py,sha256=iSTU5g6xH5z5JccKETU1PC7iCtwePfLLf_HXHLM5zPU,1387
 orionis/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/contracts/config/i_config.py,sha256=rbeojO2gm8XhSXIPY8EnUt4e0wO633OKF9Nx_tN5y60,785
@@ -67,8 +67,7 @@ orionis/installer/installer_manager.py,sha256=Hb6T0bmSl39T30maY-nUWkrLhG77JdrKe4
 orionis/installer/installer_output.py,sha256=LeKxzuXpnHOKbKpUtx3tMGkCi2bGcPV1VNnfBxwfxUU,7161
 orionis/installer/installer_setup.py,sha256=c2HtVklSa-2_-YVonc7fwtoK-RTDqBS2Ybvbekgfqtc,6970
 orionis/luminate/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/app.py,sha256=CT_d7yKeYvCSZw09Lj-8muZM87g2sfOs7frk3u2BYBs,12027
-orionis/luminate/app_context.py,sha256=se2xpsGoy_drcuOROC7OHaIAN5Yd0kbm5V1zzsxxyQc,996
+orionis/luminate/application.py,sha256=C2zBPly4MQYdzb8f7Y1oZTY9iEgGvWiM7UqG37yNimI,14122
 orionis/luminate/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/config/app.py,sha256=7teuVPuaV2ao0M5Bv-jhSgjEwb9DtVwde2saTRmYru4,1737
 orionis/luminate/config/auth.py,sha256=CG8F0pfVjKz4DY3d1Wi7gscdhnp4TT-Q8SJ2sdsHh18,523
@@ -88,7 +87,7 @@ orionis/luminate/console/base/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5N
 orionis/luminate/console/base/command.py,sha256=YGHd5xVYILcNhQumi74IRnzvagvjufEO2Bx1CwHRToY,12544
 orionis/luminate/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/console/commands/cache_clear.py,sha256=KyXVSwtLaV1O1cTEkNzX9czCwEoeQlAjiT0jUFMO8iE,2684
-orionis/luminate/console/commands/help.py,sha256=8_LOTuiZvA8HToKP5qBoN7rWlEo3T0Qik7-f3fyrTgo,2288
+orionis/luminate/console/commands/help.py,sha256=kbE4WiTE1ypGKZl5lGnz_HxRA5moKxOSYvo92IjiuCQ,2288
 orionis/luminate/console/commands/schedule_work.py,sha256=xbutdJMYL0fIZtABiS_XalNzvRhYvR2tmu8shNiDEW4,2165
 orionis/luminate/console/commands/tests.py,sha256=Z7e6aM5Vu8C7R8iC8sJgUYVN9aJgtVMkqjUEFxPq91o,1281
 orionis/luminate/console/commands/version.py,sha256=llVPK6ELtf8dIdPvLbybrtipWwZkzV0EXc9ShL-C-GY,1140
@@ -103,7 +102,7 @@ orionis/luminate/container/container.py,sha256=kg1zrvlMrzYCrORbDZ12JVZJ_z81gLDUp
 orionis/luminate/container/exception.py,sha256=ap1SqYEjQEEHXJJTNmL7V1jrmRjgT5_7geZ95MYkhMA,1691
 orionis/luminate/container/types.py,sha256=BDcXN0__voRNHZ5Gr5dF0sWIYAQyNk4TxAwILBWyDAA,1735
 orionis/luminate/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/luminate/facades/app.py,sha256=DHwCdhfU-Mfj0gPX5nwXR_cgnkvg6agMP2WBa-L0JE8,1294
+orionis/luminate/facades/app.py,sha256=8s0CLzGXcfgwXpJDsgde4Zw7CJd7cuwQzPyaSh20iGI,1607
 orionis/luminate/facades/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/luminate/facades/commands/commands_facade.py,sha256=xy-5sW5_fDXhS2y0c0CCbBOfrOR0mJQLVTwBe3J8WTk,1561
 orionis/luminate/facades/commands/scheduler_facade.py,sha256=X1Ox0NVOA9RyiKmw3UYgiF68jdIWU8HNyOf7uD0SZ54,1432
@@ -175,9 +174,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=bhLQ7VGVod4B8sv-rW9AjnOumvaBVsoxieA3sdoM2yM,5244
-orionis-0.111.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
-orionis-0.111.0.dist-info/METADATA,sha256=AftUlzF4B0CrF3exdG4h1AcAGAIQ91bkbJ7jNGuZZNI,2979
-orionis-0.111.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
-orionis-0.111.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
-orionis-0.111.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.111.0.dist-info/RECORD,,
+orionis-0.113.0.dist-info/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.113.0.dist-info/METADATA,sha256=T1C21-uTpYqyGstkpJkpfVOqifHmlcEGr47yBfmqdGk,2979
+orionis-0.113.0.dist-info/WHEEL,sha256=In9FTNxeP60KnTkGw7wk6mJPYd_dQSjEZmXdBdMCI-8,91
+orionis-0.113.0.dist-info/entry_points.txt,sha256=eef1_CVewfokKjrGBynXa06KabSJYo7LlDKKIKvs1cM,53
+orionis-0.113.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.113.0.dist-info/RECORD,,

orionis/luminate/app_context.py

@@ -1,35 +0,0 @@
-from contextlib import contextmanager
-from orionis.luminate.app import Application
-from orionis.luminate.container.container import Container
-
-@contextmanager
-def app_context():
-    """
-    Context manager for resolving dependencies within a valid Orionis application context.
-
-    This function ensures that Orionis is properly initialized before resolving dependencies,
-    similar to how Laravel’s `app()` helper works.
-
-    Yields
-    ------
-    Application
-        The initialized Orionis application instance.
-
-    Raises
-    ------
-    RuntimeError
-        If the application has not been properly initialized.
-    """
-    container = Container()
-    app = Application(container)
-
-    if not app.isBooted():
-        raise RuntimeError(
-            "Error: Not running within a valid Orionis Framework context. "
-            "Ensure that the Orionis application is correctly initialized."
-        )
-
-    try:
-        yield app
-    finally:
-        pass