orionis 0.399.0__tar.gz → 0.401.0__tar.gz

{orionis-0.399.0/orionis.egg-info → orionis-0.401.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.399.0
+Version: 0.401.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 → orionis-0.401.0}/orionis/console/output/console.py

@@ -25,7 +25,7 @@ class Console(IConsole):
         """
         return f"{ANSIColors.TEXT_MUTED.value}{datetime.datetime.now().strftime('%Y-%m-%d %H:%M:%S')}{ANSIColors.DEFAULT.value}"
 
-    def __printWithBackground(self, label: str, bg_color: ANSIColors, message: str, timestamp: bool):
+    def __printWithBackground(self, label: str, bg_color: ANSIColors, message: str, timestamp: bool) -> None:
         """
         Prints a formatted message with a background color.
 
@@ -43,7 +43,7 @@ class Console(IConsole):
         str_time = self.__getTimestamp() if timestamp else ''
         print(f"{bg_color.value}{ANSIColors.TEXT_WHITE.value} {label} {ANSIColors.DEFAULT.value} {str_time} {message}{ANSIColors.DEFAULT.value}")
 
-    def __printColored(self, message: str, text_color: ANSIColors):
+    def __printColored(self, message: str, text_color: ANSIColors) -> None:
         """
         Prints a message with a specified text color.
 
@@ -56,7 +56,7 @@ class Console(IConsole):
         """
         print(f"{text_color.value}{message}{ANSIColors.DEFAULT.value}")
 
-    def success(self, message: str, timestamp: bool = True):
+    def success(self, message: str, timestamp: bool = True) -> None:
         """
         Prints a success message with a green background.
 
@@ -69,7 +69,7 @@ class Console(IConsole):
         """
         self.__printWithBackground("SUCCESS", ANSIColors.BG_SUCCESS, message, timestamp)
 
-    def textSuccess(self, message: str):
+    def textSuccess(self, message: str) -> None:
         """
         Prints a success message in green.
 
@@ -80,7 +80,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_SUCCESS)
 
-    def textSuccessBold(self, message: str):
+    def textSuccessBold(self, message: str) -> None:
         """
         Prints a bold success message in green.
 
@@ -91,7 +91,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_BOLD_SUCCESS)
 
-    def info(self, message: str, timestamp: bool = True):
+    def info(self, message: str, timestamp: bool = True) -> None:
         """
         Prints an informational message with a blue background.
 
@@ -104,7 +104,7 @@ class Console(IConsole):
         """
         self.__printWithBackground("INFO", ANSIColors.BG_INFO, message, timestamp)
 
-    def textInfo(self, message: str):
+    def textInfo(self, message: str) -> None:
         """
         Prints an informational message in blue.
 
@@ -115,7 +115,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_INFO)
 
-    def textInfoBold(self, message: str):
+    def textInfoBold(self, message: str) -> None:
         """
         Prints a bold informational message in blue.
 
@@ -126,7 +126,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_BOLD_INFO)
 
-    def warning(self, message: str, timestamp: bool = True):
+    def warning(self, message: str, timestamp: bool = True) -> None:
         """
         Prints a warning message with a yellow background.
 
@@ -139,7 +139,7 @@ class Console(IConsole):
         """
         self.__printWithBackground("WARNING", ANSIColors.BG_WARNING, message, timestamp)
 
-    def textWarning(self, message: str):
+    def textWarning(self, message: str) -> None:
         """
         Prints a warning message in yellow.
 
@@ -150,7 +150,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_WARNING)
 
-    def textWarningBold(self, message: str):
+    def textWarningBold(self, message: str) -> None:
         """
         Prints a bold warning message in yellow.
 
@@ -161,7 +161,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_BOLD_WARNING)
 
-    def fail(self, message: str, timestamp: bool = True):
+    def fail(self, message: str, timestamp: bool = True) -> None:
         """
         Prints a failure message with a red background.
 
@@ -174,7 +174,7 @@ class Console(IConsole):
         """
         self.__printWithBackground("FAIL", ANSIColors.BG_FAIL, message, timestamp)
 
-    def error(self, message: str, timestamp: bool = True):
+    def error(self, message: str, timestamp: bool = True) -> None:
         """
         Prints an error message with a red background.
 
@@ -187,7 +187,7 @@ class Console(IConsole):
         """
         self.__printWithBackground("ERROR", ANSIColors.BG_ERROR, message, timestamp)
 
-    def textError(self, message: str):
+    def textError(self, message: str) -> None:
         """
         Prints an error message in red.
 
@@ -198,7 +198,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_ERROR)
 
-    def textErrorBold(self, message: str):
+    def textErrorBold(self, message: str) -> None:
         """
         Prints a bold error message in red.
 
@@ -209,7 +209,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_BOLD_ERROR)
 
-    def textMuted(self, message: str):
+    def textMuted(self, message: str) -> None:
         """
         Prints a muted (gray) message.
 
@@ -220,7 +220,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_MUTED)
 
-    def textMutedBold(self, message: str):
+    def textMutedBold(self, message: str) -> None:
         """
         Prints a bold muted (gray) message.
 
@@ -231,7 +231,7 @@ class Console(IConsole):
         """
         self.__printColored(message, ANSIColors.TEXT_BOLD_MUTED)
 
-    def textUnderline(self, message: str):
+    def textUnderline(self, message: str) -> None:
         """
         Prints an underlined message.
 
@@ -242,26 +242,26 @@ class Console(IConsole):
         """
         print(f"{ANSIColors.TEXT_STYLE_UNDERLINE.value}{message}{ANSIColors.DEFAULT.value}")
 
-    def clear(self):
+    def clear(self) -> None:
         """
         Clears the console screen.
         """
         os.system('cls' if os.name == 'nt' else 'clear')
 
-    def clearLine(self):
+    def clearLine(self) -> None:
         """
         Clears the current line in the console.
         """
         sys.stdout.write("\r \r")
         sys.stdout.flush()
 
-    def line(self):
+    def line(self) -> None:
         """
         Prints a horizontal line in the console.
         """
         print("\n", end="")
 
-    def newLine(self, count: int = 1):
+    def newLine(self, count: int = 1) -> None:
         """
         Prints multiple new lines.
 
@@ -279,7 +279,7 @@ class Console(IConsole):
             raise ValueError(f"Unsupported Value '{count}'")
         print("\n" * count, end="")
 
-    def write(self, message: str):
+    def write(self, message: str) -> None:
         """
         Prints a message without moving to the next line.
 
@@ -291,7 +291,7 @@ class Console(IConsole):
         sys.stdout.write(f"{message}")
         sys.stdout.flush()
 
-    def writeLine(self, message: str):
+    def writeLine(self, message: str) -> None:
         """
         Prints a message and moves to the next line.
 
@@ -355,7 +355,7 @@ class Console(IConsole):
         """
         return getpass.getpass(f"{ANSIColors.TEXT_INFO.value}{str(question).strip()}{ANSIColors.DEFAULT.value} ")
 
-    def table(self, headers: list, rows: list):
+    def table(self, headers: list, rows: list) -> None:
         """
         Prints a table in the console with the given headers and rows, with bold headers.
 
@@ -402,7 +402,7 @@ class Console(IConsole):
 
         print(bottom_border)
 
-    def anticipate(self, question: str, options: list, default=None):
+    def anticipate(self, question: str, options: list, default=None) -> str:
         """
         Provides autocomplete suggestions based on user input.
 

{orionis-0.399.0 → orionis-0.401.0}/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-0.401.0/orionis/foundation/exceptions/__init__.py

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

orionis-0.401.0/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-0.401.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-0.399.0 → orionis-0.401.0}/orionis/metadata/framework.py

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

{orionis-0.399.0 → orionis-0.401.0/orionis.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.399.0
+Version: 0.401.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 → orionis-0.401.0}/orionis.egg-info/SOURCES.txt

@@ -249,6 +249,8 @@ orionis/foundation/contracts/application.py
 orionis/foundation/contracts/config.py
 orionis/foundation/exceptions/__init__.py
 orionis/foundation/exceptions/integrity.py
+orionis/foundation/exceptions/runtime.py
+orionis/foundation/exceptions/type.py
 orionis/foundation/exceptions/value.py
 orionis/foundation/providers/__init__.py
 orionis/foundation/providers/console_provider.py

orionis-0.399.0/orionis/foundation/exceptions/__init__.py

@@ -1,7 +0,0 @@
-from .integrity import OrionisIntegrityException
-from .value import OrionisValueError
-
-__all__ = [
-    "OrionisIntegrityException",
-    "OrionisValueError"
-]