orionis 0.399.0__py3-none-any.whl → 0.400.0__py3-none-any.whl

orionis/foundation/application.py

@@ -1,3 +1,4 @@
+import time
 from pathlib import Path
 from typing import Any, List, Type
 from orionis.container.container import Container
@@ -16,6 +17,7 @@ from orionis.foundation.config.startup import Configuration
 from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.foundation.contracts.application import IApplication
 from orionis.foundation.contracts.config import IConfig
+from orionis.foundation.exceptions import OrionisTypeError, OrionisRuntimeError
 
 class Application(Container, IApplication):
     """
@@ -59,24 +61,47 @@ class Application(Container, IApplication):
 
         # Singleton pattern - prevent multiple initializations
         if not hasattr(self, '_Application__initialized'):
-            self.__providers: List[IServiceProvider] = []
+            self.__providers: List[IServiceProvider, Any] = []
             self.__configurators : dict = {}
             self.__config: dict = {}
             self.__booted: bool = False
+            self.__startAt = time.time_ns()
+
+            # Flag to prevent re-initialization
             self.__initialized = True
 
+    # << Frameworks Kernel >>
+
+    def __loadFrameworksKernel(
+        self
+    ) -> None:
+        """
+        Load and register core framework kernels.
+
+        Instantiates and registers kernel components:
+        - TestKernel: Testing framework kernel
+        """
+        # Import core framework kernels
+        from orionis.test.kernel import TestKernel, ITestKernel
+
+        # Core framework kernels
+        core_kernels = {
+            ITestKernel: TestKernel
+        }
+
+        # Register each kernel instance
+        for kernel_name, kernel_cls in core_kernels.items():
+            self.instance(kernel_name, kernel_cls(self))
+
+    # << Service Providers >>
+
     def __loadFrameworkProviders(
         self
     ) -> None:
         """
         Load core framework service providers.
 
-        Registers essential providers required for framework operation:
-        - ConsoleProvider: Console output management
-        - DumperProvider: Data dumping utilities
-        - PathResolverProvider: Path resolution services
-        - ProgressBarProvider: Progress bar functionality
-        - WorkersProvider: Worker management
+        Registers essential providers required for framework operation
         """
         # Import core framework providers
         from orionis.foundation.providers.console_provider import ConsoleProvider
@@ -98,27 +123,6 @@ class Application(Container, IApplication):
         for provider_cls in core_providers:
             self.addProvider(provider_cls)
 
-    def __loadFrameworksKernel(
-        self
-    ) -> None:
-        """
-        Load and register core framework kernels.
-
-        Instantiates and registers kernel components:
-        - TestKernel: Testing framework kernel
-        """
-        # Import core framework kernels
-        from orionis.test.kernel import TestKernel, ITestKernel
-
-        # Core framework kernels
-        core_kernels = {
-            ITestKernel: TestKernel
-        }
-
-        # Register each kernel instance
-        for kernel_name, kernel_cls in core_kernels.items():
-            self.instance(kernel_name, kernel_cls(self))
-
     def __registerProviders(
         self
     ) -> None:
@@ -128,8 +132,24 @@ class Application(Container, IApplication):
         Calls the register method on each provider to bind services
         into the container.
         """
+
+        # Ensure providers list is empty before registration
+        initialized_providers = []
+
+        # Iterate over each provider and register it
         for provider in self.__providers:
-            provider.register()
+
+            # Initialize the provider
+            class_provider: IServiceProvider = provider(self)
+
+            # Register the provider in the container
+            class_provider.register()
+
+            # Add the initialized provider to the list
+            initialized_providers.append(class_provider)
+
+        # Update the providers list with initialized providers
+        self.__providers = initialized_providers
 
     def __bootProviders(
         self
@@ -140,8 +160,12 @@ class Application(Container, IApplication):
         Calls the boot method on each provider to initialize services
         after all providers have been registered.
         """
+        # Iterate over each provider and boot it
         for provider in self.__providers:
-            provider.boot()
+
+            # Ensure provider is initialized before calling boot
+            if hasattr(provider, 'boot') and callable(getattr(provider, 'boot')):
+                provider.boot()
 
     def withProviders(
         self,
@@ -187,20 +211,58 @@ class Application(Container, IApplication):
 
         Raises
         ------
-        TypeError
+        OrionisTypeError
             If provider is not a subclass of IServiceProvider
         """
 
         # Validate provider type
         if not isinstance(provider, type) or not issubclass(provider, IServiceProvider):
-            raise TypeError(f"Expected IServiceProvider class, got {type(provider).__name__}")
+            raise OrionisTypeError(f"Expected IServiceProvider class, got {type(provider).__name__}")
+
+        # Add the provider to the list
+        if provider not in self.__providers:
+            self.__providers.append(provider)
 
-        # Instantiate and add provider
-        self.__providers.append(provider(self))
+        # If already added, raise an error
+        else:
+            raise OrionisTypeError(f"Provider {provider.__name__} is already registered.")
 
         # Return self instance.
         return self
 
+    # << Configuration >>
+
+    def __loadConfig(
+        self,
+    ) -> None:
+        """
+        Retrieve a configuration value by key.
+
+        Returns
+        -------
+        None
+            Initializes the application configuration if not already set.
+        """
+
+        # Try to load the configuration
+        try:
+
+            # Check if configuration is a dictionary
+            if not self.__config:
+
+                # Initialize with default configuration
+                if not self.__configurators:
+                    self.__config = Configuration().toDict()
+
+                # If configurators are provided, use them to create the configuration
+                else:
+                    self.__config = Configuration(**self.__configurators).toDict()
+
+        except Exception as e:
+
+            # Handle any exceptions during configuration loading
+            raise OrionisRuntimeError(f"Failed to load application configuration: {str(e)}")
+
     def withConfigurators(
         self,
         *,
@@ -354,7 +416,7 @@ class Application(Container, IApplication):
 
         # Validate config type
         if not isinstance(app, App):
-            raise TypeError(f"Expected App instance, got {type(app).__name__}")
+            raise OrionisTypeError(f"Expected App instance, got {type(app).__name__}")
 
         # Store the configuration
         self.__configurators['app'] = app
@@ -407,7 +469,7 @@ class Application(Container, IApplication):
 
         # Validate auth type
         if not isinstance(auth, Auth):
-            raise TypeError(f"Expected Auth instance, got {type(auth).__name__}")
+            raise OrionisTypeError(f"Expected Auth instance, got {type(auth).__name__}")
 
         # Store the configuration
         self.__configurators['auth'] = auth
@@ -460,7 +522,7 @@ class Application(Container, IApplication):
 
         # Validate cache type
         if not isinstance(cache, Cache):
-            raise TypeError(f"Expected Cache instance, got {type(cache).__name__}")
+            raise OrionisTypeError(f"Expected Cache instance, got {type(cache).__name__}")
 
         # Store the configuration
         self.__configurators['cache'] = cache
@@ -513,7 +575,7 @@ class Application(Container, IApplication):
 
         # Validate cors type
         if not isinstance(cors, Cors):
-            raise TypeError(f"Expected Cors instance, got {type(cors).__name__}")
+            raise OrionisTypeError(f"Expected Cors instance, got {type(cors).__name__}")
 
         # Store the configuration
         self.__configurators['cors'] = cors
@@ -569,7 +631,7 @@ class Application(Container, IApplication):
 
         # Validate database type
         if not isinstance(database, Database):
-            raise TypeError(f"Expected Database instance, got {type(database).__name__}")
+            raise OrionisTypeError(f"Expected Database instance, got {type(database).__name__}")
 
         # Store the configuration
         self.__configurators['database'] = database
@@ -625,7 +687,7 @@ class Application(Container, IApplication):
 
         # Validate filesystems type
         if not isinstance(filesystems, Filesystems):
-            raise TypeError(f"Expected Filesystems instance, got {type(filesystems).__name__}")
+            raise OrionisTypeError(f"Expected Filesystems instance, got {type(filesystems).__name__}")
 
         # Store the configuration
         self.__configurators['filesystems'] = filesystems
@@ -681,7 +743,7 @@ class Application(Container, IApplication):
 
         # Validate logging type
         if not isinstance(logging, Logging):
-            raise TypeError(f"Expected Logging instance, got {type(logging).__name__}")
+            raise OrionisTypeError(f"Expected Logging instance, got {type(logging).__name__}")
 
         # Store the configuration
         self.__configurators['logging'] = logging
@@ -737,7 +799,7 @@ class Application(Container, IApplication):
 
         # Validate mail type
         if not isinstance(mail, Mail):
-            raise TypeError(f"Expected Mail instance, got {type(mail).__name__}")
+            raise OrionisTypeError(f"Expected Mail instance, got {type(mail).__name__}")
 
         # Store the configuration
         self.__configurators['mail'] = mail
@@ -793,7 +855,7 @@ class Application(Container, IApplication):
 
         # Validate queue type
         if not isinstance(queue, Queue):
-            raise TypeError(f"Expected Queue instance, got {type(queue).__name__}")
+            raise OrionisTypeError(f"Expected Queue instance, got {type(queue).__name__}")
 
         # Store the configuration
         self.__configurators['queue'] = queue
@@ -849,7 +911,7 @@ class Application(Container, IApplication):
 
         # Validate session type
         if not isinstance(session, Session):
-            raise TypeError(f"Expected Session instance, got {type(session).__name__}")
+            raise OrionisTypeError(f"Expected Session instance, got {type(session).__name__}")
 
         # Store the configuration
         self.__configurators['session'] = session
@@ -905,7 +967,7 @@ class Application(Container, IApplication):
 
         # Validate testing type
         if not isinstance(testing, Testing):
-            raise TypeError(f"Expected Testing instance, got {type(testing).__name__}")
+            raise OrionisTypeError(f"Expected Testing instance, got {type(testing).__name__}")
 
         # Store the configuration
         self.__configurators['testing'] = testing
@@ -913,36 +975,7 @@ class Application(Container, IApplication):
         # Return the application instance for method chaining
         return self
 
-    def __loadConfig(
-        self,
-    ) -> None:
-        """
-        Retrieve a configuration value by key.
-
-        Returns
-        -------
-        None
-            Initializes the application configuration if not already set.
-        """
-
-        # Try to load the configuration
-        try:
-
-            # Check if configuration is a dictionary
-            if not self.__config:
-
-                # Initialize with default configuration
-                if not self.__configurators:
-                    self.__config = Configuration().toDict()
-
-                # If configurators are provided, use them to create the configuration
-                else:
-                    self.__config = Configuration(**self.__configurators).toDict()
-
-        except Exception as e:
-
-            # Handle any exceptions during configuration loading
-            raise RuntimeError(f"Failed to load application configuration: {str(e)}")
+    # << Application Lifecycle >>
 
     def create(
         self
@@ -958,22 +991,24 @@ class Application(Container, IApplication):
         # Check if already booted
         if not self.__booted:
 
-            # Load core framework components
-            self.__loadFrameworkProviders()
-            self.__loadFrameworksKernel()
+            # Load configuration if not already set
+            self.__loadConfig()
 
-            # Register and boot all providers
+            # Load framework providers and register them
+            self.__loadFrameworkProviders()
             self.__registerProviders()
             self.__bootProviders()
 
-            # Load configuration if not already set
-            self.__loadConfig()
+            # Load core framework kernels
+            self.__loadFrameworksKernel()
 
             # Mark as booted
             self.__booted = True
 
         return self
 
+    # << Configuration Access >>
+
     def config(
         self,
         key: str,
@@ -1023,6 +1058,8 @@ class Application(Container, IApplication):
         # Return the final configuration value
         return config_value
 
+    # << Path Configuration Access >>
+
     def path(
         self,
         key: str,

orionis/foundation/exceptions/__init__.py

@@ -1,7 +1,11 @@
 from .integrity import OrionisIntegrityException
 from .value import OrionisValueError
+from .type import OrionisTypeError
+from .runtime import OrionisRuntimeError
 
 __all__ = [
     "OrionisIntegrityException",
-    "OrionisValueError"
+    "OrionisValueError",
+    "OrionisTypeError",
+    "OrionisRuntimeError"
 ]

orionis/foundation/exceptions/runtime.py

@@ -0,0 +1,19 @@
+class OrionisRuntimeError(RuntimeError):
+
+    def __init__(self, msg: str):
+        """
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

orionis/foundation/exceptions/type.py

@@ -0,0 +1,19 @@
+class OrionisTypeError(TypeError):
+
+    def __init__(self, msg: str):
+        """
+        Parameters
+        ----------
+        msg : str
+            Descriptive error message explaining the cause of the exception.
+        """
+        super().__init__(msg)
+
+    def __str__(self) -> str:
+        """
+        Returns
+        -------
+        str
+            Formatted string describing the exception.
+        """
+        return str(self.args[0])

orionis/metadata/framework.py

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

{orionis-0.399.0.dist-info → orionis-0.400.0.dist-info}/METADATA

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

{orionis-0.399.0.dist-info → orionis-0.400.0.dist-info}/RECORD

@@ -146,7 +146,7 @@ orionis/container/validators/is_subclass.py,sha256=4sBaGLoRs8nUhuWjlP0VJqyTwVHYq
 orionis/container/validators/is_valid_alias.py,sha256=4uAYcq8xov7jZbXnpKpjNkxcZtlTNnL5RRctVPMwJes,1424
 orionis/container/validators/lifetime.py,sha256=IQ43fDNrxYHMlZH2zlYDJnlkLO_eS4U7Fs3UJgQBidI,1844
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=Nxv_0nfBec8mOlEFVED0UY7PFgWw_e5uBoM4e-0T2w8,33794
+orionis/foundation/application.py,sha256=iR8wCicowPy4Rfn-teOlLgN3ILWCPC9TuiCPX7dvyCM,34992
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=zutF-34DkW68bpiTxH9xrmIe1iJdXCF9Y6wueXS6qys,8265
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -237,8 +237,10 @@ orionis/foundation/config/testing/enums/test_mode.py,sha256=IbFpauu7J-iSAfmC8jDb
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/contracts/application.py,sha256=iFUGJBnA3Aqab9x4axqRiuzyORpwj37JL--Npjn1e1w,16739
 orionis/foundation/contracts/config.py,sha256=Rpz6U6t8OXHO9JJKSTnCimytXE-tfCB-1ithP2nG8MQ,628
-orionis/foundation/exceptions/__init__.py,sha256=XtG3MJ_MFNY_dU5mmTyz_N_4QG1jYrcv5RegBso7wuY,163
+orionis/foundation/exceptions/__init__.py,sha256=q6we1N8kcd6j6GjUJY30WQhhHnqF9RXA0c6-ksEztlc,294
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
+orionis/foundation/exceptions/runtime.py,sha256=QS9Wjy79UFoM_lA-JR907p4l4Z8ae5E810HAHAnmIq8,469
+orionis/foundation/exceptions/type.py,sha256=Ug51YdaUKUlbngR0KeWnJNqIwS9StP4ScVobFY1eI18,463
 orionis/foundation/exceptions/value.py,sha256=hQhXybXEnaa59ba7JxG65jceHt3mnql9MyekF-TChpM,465
 orionis/foundation/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/providers/console_provider.py,sha256=pAIklY1QKx2HKjTp7YyJT6KbJPlEEyzWSr79RTFkEK0,700
@@ -247,7 +249,7 @@ orionis/foundation/providers/path_resolver_provider.py,sha256=rXvaVc5sSqmDgRzWJo
 orionis/foundation/providers/progress_bar_provider.py,sha256=75Jr4iEgUOUGl8Di1DioeP5_HRQlR-1lVzPmS96sWjA,737
 orionis/foundation/providers/workers_provider.py,sha256=WWlji3C69_-Y0c42aZDbR_bmcE_qZEh2SaA_cNkCivI,702
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=K8scP1C_3ceCS2Knn8YTyYMxbmUHtFWI98zWSnaLpns,4960
+orionis/metadata/framework.py,sha256=cjv4CHVM62AzFx5-htVVpWEHinon7yMVjzb5Y-1YemA,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -384,7 +386,7 @@ orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 orionis/test/records/logs.py,sha256=EOQcloMVdhlNl2lU9igQz8H4b-OtKtiwh2pgr_QZWOI,13186
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=zd7xDvVfmQ2HxZamDTzL2-z2PpyL99EaolbbM7wTah4,5014
-orionis-0.399.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.400.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=yctjQT5ocYEu__kNvJxmQJ-l5yxRMkohwcfYWSjWDVo,25566
@@ -485,8 +487,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=nTNrvJkMSPx_aopEQ9
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=fnH7hjumNSErAFGITJgq2LHxSzvPF2tdtmHL9kyAv-Y,4409
 tests/testing/test_testing_unit.py,sha256=d3CRGo6608fMzYcZKIKapjx_af2aigqWiKSiuK9euIY,7600
-orionis-0.399.0.dist-info/METADATA,sha256=W1dRShLunXjACwe2Xjv3LK4FEiBPaa8b9gMMN1oEQL4,4772
-orionis-0.399.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.399.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.399.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.399.0.dist-info/RECORD,,
+orionis-0.400.0.dist-info/METADATA,sha256=UEh4Wj-neUiv_E3PcTpu72nc1EoshadIzPwiSAPh_QU,4772
+orionis-0.400.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.400.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.400.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.400.0.dist-info/RECORD,,