orionis 0.453.0__py3-none-any.whl → 0.455.0__py3-none-any.whl

orionis/console/commands/help.py

@@ -0,0 +1,36 @@
+from orionis.console.base.command import BaseCommand
+from orionis.console.exceptions import CLIOrionisRuntimeError
+from rich.console import Console
+from rich.panel import Panel
+
+class HelpCommand(BaseCommand):
+    """
+    Command class to display usage information for the Orionis CLI.
+    """
+
+    timestamps: bool = False
+    signature: str = "help"
+    description: str = "Prints help information for the Orionis CLI commands."
+
+    def handle(self) -> None:
+        """
+        Executes the command to display usage information for the Orionis CLI.
+        """
+        try:
+            console = Console()
+            usage = (
+                "[bold cyan]Usage:[/]\n"
+                "  orionis <command> [options]\n\n"
+                "[bold cyan]Available Commands:[/]\n"
+                "  help        Show this help message\n"
+                "  run         Run the application\n"
+                "  make        Generate code scaffolding\n"
+                "  migrate     Run database migrations\n"
+                "  ...         Other available commands\n\n"
+                "[bold cyan]Options:[/]\n"
+                "  -h, --help  Show this help message and exit\n"
+            )
+            panel = Panel(usage, title="[bold green]Orionis CLI Help[/]", expand=False, border_style="bright_blue")
+            console.print(panel)
+        except Exception as e:
+            raise CLIOrionisRuntimeError(f"An unexpected error occurred: {e}") from e

orionis/console/commands/version.py

@@ -1,6 +1,8 @@
 from orionis.console.base.command import BaseCommand
 from orionis.console.exceptions import CLIOrionisRuntimeError
-from orionis.metadata.framework import VERSION
+from rich.console import Console
+from rich.panel import Panel
+from orionis.metadata import framework
 
 class VersionCommand(BaseCommand):
     """
@@ -8,6 +10,7 @@ class VersionCommand(BaseCommand):
 
     This command prints the version number of the framework in use.
     """
+    timestamps: bool = False
 
     signature: str = "version"
 
@@ -39,7 +42,32 @@ class VersionCommand(BaseCommand):
 
         # Print the Orionis framework version in a bold, success style
         try:
-            self.textSuccessBold(f"Orionis Framework v{VERSION}")
+
+            # Initialize the console for rich output
+            console = Console()
+
+            # Compose the main info
+            title = f"[bold yellow]{framework.NAME.capitalize()} Framework[/bold yellow] [white]v{framework.VERSION}[/white]"
+            author = f"[bold]Author:[/bold] {framework.AUTHOR}  |  [bold]Email:[/bold] {framework.AUTHOR_EMAIL}"
+            desc = f"[italic]{framework.DESCRIPTION}[/italic]"
+            python_req = f"[bold]Python Requires:[/bold] {framework.PYTHON_REQUIRES}"
+            docs = f"[bold]Docs:[/bold] [underline blue]{framework.DOCS}[/underline blue]"
+            repo = f"[bold]Repo:[/bold] [underline blue]{framework.FRAMEWORK}[/underline blue]"
+
+            body = "\n".join([desc, "", author, python_req, docs, repo, ""])
+
+            panel = Panel(
+                body,
+                title=title,
+                border_style="bold yellow",
+                padding=(1, 6),
+                expand=False,
+                subtitle="[bold yellow]Orionis CLI[/bold yellow]",
+                subtitle_align="right"
+            )
+            console.line()
+            console.print(panel)
+            console.line()
 
         # Raise a custom runtime error if any exception occurs
         except Exception as e:

orionis/console/contracts/reactor.py

@@ -0,0 +1,39 @@
+from abc import ABC, abstractmethod
+from typing import List, Optional
+
+class IReactor(ABC):
+
+    @abstractmethod
+    def call(
+        self,
+        signature: str,
+        args: Optional[List[str]] = None
+    ):
+        """
+        Executes a command by its signature with optional command-line arguments.
+
+        This method retrieves a registered command by its signature, validates any provided
+        arguments against the command's argument parser, and executes the command's handle
+        method with the parsed arguments and application context.
+
+        Parameters
+        ----------
+        signature : str
+            The unique signature identifier of the command to execute.
+        args : Optional[List[str]], default None
+            Command-line arguments to pass to the command. If None, no arguments are provided.
+
+        Returns
+        -------
+        None
+            This method does not return any value. The command's handle method is called
+            directly for execution.
+
+        Raises
+        ------
+        ValueError
+            If the command with the specified signature is not found in the registry.
+        SystemExit
+            If argument parsing fails due to invalid arguments provided.
+        """
+        pass

orionis/console/core/reactor.py

@@ -1,21 +1,21 @@
 import argparse
 import os
-from pathlib import Path
+import re
 import time
+from pathlib import Path
 from typing import List, Optional
 from orionis.app import Orionis
 from orionis.console.args.argument import CLIArgument
 from orionis.console.base.command import BaseCommand
 from orionis.console.base.contracts.command import IBaseCommand
+from orionis.console.contracts.reactor import IReactor
 from orionis.console.output.contracts.console import IConsole
 from orionis.console.output.contracts.executor import IExecutor
 from orionis.foundation.contracts.application import IApplication
 from orionis.services.introspection.modules.reflection import ReflectionModule
-import re
+from orionis.services.log.contracts.log_service import ILogger
 
-from orionis.services.log.contracts.log_service import ILoggerService
-
-class Reactor:
+class Reactor(IReactor):
 
     def __init__(
         self,
@@ -65,6 +65,9 @@ class Reactor:
         # Automatically discover and load command classes from the console commands directory
         self.__loadCommands(str(self.__app.path('console_commands')), self.__root)
 
+        # Load core command classes provided by the Orionis framework
+        self.__loadCoreCommands()
+
         # Initialize the executor for command output management
         self.__executer: IExecutor = self.__app.make('x-orionis.console.output.executor')
 
@@ -72,7 +75,57 @@ class Reactor:
         self.__console: IConsole = self.__app.make('x-orionis.console.output.console')
 
         # Initialize the logger service for logging command execution details
-        self.__logger: ILoggerService = self.__app.make('x-orionis.services.log.log_service')
+        self.__logger: ILogger = self.__app.make('x-orionis.services.log.log_service')
+
+    def __loadCoreCommands(self) -> None:
+        """
+        Loads and registers core command classes provided by the Orionis framework.
+
+        This method is responsible for discovering and registering core command classes
+        that are bundled with the Orionis framework itself (such as version, help, etc.).
+        These commands are essential for the framework's operation and are made available
+        to the command registry so they can be executed like any other user-defined command.
+
+        The method imports the required core command classes, validates their structure,
+        and registers them in the internal command registry. Each command is checked for
+        required attributes such as `timestamps`, `signature`, `description`, and `arguments`
+        to ensure proper integration and discoverability.
+
+        Returns
+        -------
+        None
+            This method does not return any value. All discovered core commands are
+            registered internally in the reactor's command registry for later lookup
+            and execution.
+        """
+
+        # Import the core command class for version
+        from orionis.console.commands.version import VersionCommand
+        from orionis.console.commands.help import HelpCommand
+
+        # List of core command classes to load (extend this list as more core commands are added)
+        core_commands = [
+            VersionCommand,
+            HelpCommand
+        ]
+
+        # Iterate through the core command classes and register them
+        for obj in core_commands:
+
+            # Validate and extract required command attributes
+            timestamp = self.__ensureTimestamps(obj)
+            signature = self.__ensureSignature(obj)
+            description = self.__ensureDescription(obj)
+            args = self.__ensureArguments(obj)
+
+            # Register the command in the internal registry with all its metadata
+            self.__commands[signature] = {
+                "class": obj,
+                "timestamps": timestamp,
+                "signature": signature,
+                "description": description,
+                "args": args
+            }
 
     def __loadCommands(self, commands_path: str, root_path: str) -> None:
         """
@@ -423,8 +476,8 @@ class Reactor:
             output =  self.__app.call(command_instance, 'handle')
 
             # Log the command execution completion with DONE state
+            elapsed_time = round(time.perf_counter() - start_time, 2)
             if timestamps:
-                elapsed_time = round(time.perf_counter() - start_time, 2)
                 self.__executer.done(program=signature, time=f"{elapsed_time}s")
 
             # Log the command execution success
@@ -443,6 +496,6 @@ class Reactor:
             self.__logger.error(f"Command '{signature}' execution failed: {e}")
 
             # Log the command execution failure with ERROR state
+            elapsed_time = round(time.perf_counter() - start_time, 2)
             if timestamps:
-                elapsed_time = round(time.perf_counter() - start_time, 2)
-                self.__executer.fail(program=signature, time=f"{elapsed_time}s")
+                self.__executer.fail(program=signature, time=f"{elapsed_time}s")

orionis/console/kernel.py

@@ -1,4 +1,6 @@
 from orionis.console.contracts.kernel import IKernelCLI
+from orionis.console.contracts.reactor import IReactor
+from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.contracts.application import IApplication
 from orionis.console.exceptions import CLIOrionisValueError
 
@@ -8,6 +10,24 @@ class KernelCLI(IKernelCLI):
         self,
         app: IApplication
     ) -> None:
+        """
+        Initializes the KernelCLI instance with the provided application container.
+
+        Parameters
+        ----------
+        app : IApplication
+            The application container instance that provides access to services and dependencies.
+
+        Returns
+        -------
+        None
+            This constructor does not return a value. It initializes internal dependencies required for CLI operations.
+
+        Raises
+        ------
+        CLIOrionisValueError
+            If the provided `app` argument is not an instance of `IApplication`.
+        """
 
         # Validate that the app is an instance of IApplication
         if not isinstance(app, IApplication):
@@ -15,11 +35,65 @@ class KernelCLI(IKernelCLI):
                 f"Failed to initialize TestKernel: expected IApplication, got {type(app).__module__}.{type(app).__name__}."
             )
 
+        # Retrieve and initialize the reactor instance from the application container.
+        # The reactor is responsible for dispatching CLI commands.
+        self.__reactor: IReactor = app.make('x-orionis.console.core.reactor', app)
+
+        # Retrieve and initialize the console instance for command output and error handling.
+        self.__console: IConsole = app.make('x-orionis.console.output.console')
+
     def handle(self, args: list) -> None:
         """
-        Handle the command line arguments.
+        Processes and dispatches command line arguments to the appropriate command handler.
+
+        Parameters
+        ----------
+        args : list
+            The list of command line arguments, typically `sys.argv`.
 
-        :param args: List of command line arguments (e.g., sys.argv).
+        Returns
+        -------
+        None
+            This method does not return a value. It may terminate the process or delegate execution to command handlers.
+
+        Raises
+        ------
+        SystemExit
+            If invalid arguments are provided or no command is specified, this method may terminate the process with an error message.
         """
-        # This method should be implemented in subclasses
-        print(args)
+
+        try:
+
+            # Ensure the arguments are provided as a list
+            if not isinstance(args, list):
+                raise CLIOrionisValueError(
+                    f"Failed to handle command line arguments: expected list, got {type(args).__module__}.{type(args).__name__}."
+                )
+
+            # If no arguments or only the script name is provided, show the default help command
+            if not args or len(args) <= 1:
+                return self.__reactor.call('help')
+
+            # Remove the first argument (script name) to process only the command and its parameters
+            args = args[1:]
+
+            # If no command is provided after removing the script name, exit with an error
+            if len(args) == 0:
+                raise CLIOrionisValueError("No command provided to execute.")
+
+            # If only the command is provided, call it without additional arguments
+            if len(args) == 1:
+                return self.__reactor.call(args[0])
+
+            # If command and arguments are provided, call the command with its arguments
+            return self.__reactor.call(args[0], args[1:])
+
+        except SystemExit as e:
+
+            # Handle SystemExit exceptions gracefully, allowing for clean exits with error messages
+            self.__console.exitError(str(e))
+
+        except Exception as e:
+
+            # Handle any other exceptions that may occur during command processing
+            self.__console.exitError(f"An unexpected error occurred: {str(e)}")

orionis/foundation/application.py

@@ -20,7 +20,7 @@ from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.foundation.contracts.application import IApplication
 from orionis.foundation.exceptions import OrionisTypeError, OrionisRuntimeError, OrionisValueError
 from orionis.foundation.providers.logger_provider import LoggerProvider
-from orionis.services.log.contracts.log_service import ILoggerService
+from orionis.services.log.contracts.log_service import ILogger
 
 class Application(Container, IApplication):
     """
@@ -179,6 +179,7 @@ class Application(Container, IApplication):
         from orionis.foundation.providers.testing_provider import TestingProvider
         from orionis.foundation.providers.inspirational_provider import InspirationalProvider
         from orionis.foundation.providers.executor_provider import ConsoleExecuteProvider
+        from orionis.foundation.providers.reactor_provider import ReactorProvider
 
         # Core framework providers
         core_providers = [
@@ -189,7 +190,8 @@ class Application(Container, IApplication):
             LoggerProvider,
             TestingProvider,
             InspirationalProvider,
-            ConsoleExecuteProvider
+            ConsoleExecuteProvider,
+            ReactorProvider
         ]
 
         # Register each core provider
@@ -1931,7 +1933,7 @@ class Application(Container, IApplication):
             self.__loadFrameworksKernel()
 
             # Retrieve logger and console instances from the container
-            logger: ILoggerService = self.make('x-orionis.services.log.log_service')
+            logger: ILogger = self.make('x-orionis.services.log.log_service')
 
             # Calculate elapsed time in milliseconds since application start
             elapsed_ms = (time.time_ns() - self.startAt) // 1_000_000

orionis/foundation/providers/logger_provider.py

@@ -1,6 +1,6 @@
 from orionis.container.providers.service_provider import ServiceProvider
-from orionis.services.log.contracts.log_service import ILoggerService
-from orionis.services.log.log_service import LoggerService
+from orionis.services.log.contracts.log_service import ILogger
+from orionis.services.log.log_service import Logger
 
 class LoggerProvider(ServiceProvider):
     """
@@ -8,7 +8,7 @@ class LoggerProvider(ServiceProvider):
 
     The LoggerProvider is responsible for registering and configuring the logging
     service implementation in the application's dependency injection container.
-    It binds the concrete LoggerService to the ILoggerService interface, enabling
+    It binds the concrete Logger to the ILogger interface, enabling
     application-wide access to structured logging capabilities.
 
     This provider handles the initialization of the logging service with the
@@ -32,7 +32,7 @@ class LoggerProvider(ServiceProvider):
         """
         Register the logging service in the application container.
 
-        This method binds the `LoggerService` implementation to the `ILoggerService`
+        This method binds the `Logger` implementation to the `ILogger`
         contract within the application's dependency injection container. The service
         is initialized with the application's logging configuration and registered
         with a specific alias for internal framework identification.
@@ -50,12 +50,12 @@ class LoggerProvider(ServiceProvider):
         # Retrieve logging configuration from application config
         logging_config = self.app.config('logging')
 
-        # Create LoggerService instance with the retrieved configuration
-        logger_service = LoggerService(logging_config)
+        # Create Logger instance with the retrieved configuration
+        logger_service = Logger(logging_config)
 
         # Register the service instance in the container with interface binding and alias
         self.app.instance(
-            ILoggerService,                             # Interface contract
+            ILogger,                             # Interface contract
             logger_service,                             # Concrete implementation instance
             alias="x-orionis.services.log.log_service"  # Internal framework alias
         )

orionis/foundation/providers/reactor_provider.py

@@ -0,0 +1,93 @@
+from orionis.console.contracts.reactor import IReactor
+from orionis.console.core.reactor import Reactor
+from orionis.container.providers.service_provider import ServiceProvider
+
+class ReactorProvider(ServiceProvider):
+    """
+    Service provider for worker management functionality within the Orionis framework.
+
+    This provider is responsible for registering and configuring the worker management
+    service implementation in the application's dependency injection container. It
+    establishes the binding between the IReactor interface contract and its concrete
+    Reactor implementation, enabling consistent reactor operations throughout the
+    application lifecycle.
+
+    The provider follows the standard service provider pattern, offering both
+    registration and boot phases for complete service lifecycle management.
+
+    Attributes
+    ----------
+    app : Application
+        The main application container instance used for service registration
+        and dependency injection management.
+
+    Notes
+    -----
+    This provider registers the reactor service with a transient lifetime, ensuring
+    that each request for reactor functionality receives a fresh instance. This
+    approach is optimal for operations that may maintain temporary state or require
+    isolation between different execution contexts.
+    """
+
+    def register(self) -> None:
+        """
+        Register the reactor management service in the application container.
+
+        This method binds the IReactor interface to a new instance of the Reactor
+        implementation within the application's dependency injection container. The
+        service is registered with a transient lifetime, ensuring that each resolution
+        yields a new Reactor instance. An alias is provided for convenient retrieval.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        None
+            This method does not return any value. It performs registration
+            as a side effect on the application container.
+
+        Notes
+        -----
+        - Each call to resolve IReactor will produce a new Reactor instance.
+        - No singleton or caching behavior is applied.
+        - The alias "x-orionis.console.core.reactor" can be used for explicit lookups.
+        """
+
+        # Register the Reactor service with the application container
+        # as a singleton, allowing it to be resolved throughout the application lifecycle
+        self.app.singleton(
+            IReactor,
+            Reactor,
+            alias="x-orionis.console.core.reactor"
+        )
+
+    def boot(self) -> None:
+        """
+        Perform post-registration initialization for the reactor management service.
+
+        This method is invoked after all services have been registered in the container.
+        It provides an opportunity for additional setup, configuration, or initialization
+        logic that may depend on other services being available. Currently, this method
+        does not perform any actions but serves as a placeholder for future enhancements.
+
+        Parameters
+        ----------
+        None
+
+        Returns
+        -------
+        None
+            This method does not return any value. It only performs initialization
+            side effects if required.
+
+        Notes
+        -----
+        - Called automatically during the application boot sequence.
+        - Intended for cross-service configuration or runtime setup.
+        - No initialization is currently required for the reactor service.
+        """
+
+        # No additional initialization required at this time
+        pass

orionis/metadata/framework.py

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

orionis/services/log/contracts/log_service.py

@@ -1,6 +1,6 @@
 from abc import ABC, abstractmethod
 
-class ILoggerService(ABC):
+class ILogger(ABC):
 
     @abstractmethod
     def info(self, message: str) -> None:

orionis/services/log/log_service.py

@@ -1,12 +1,12 @@
 from orionis.foundation.config.logging.entities.logging import Logging
 from orionis.foundation.config.logging.enums import Level
-from orionis.services.log.contracts.log_service import ILoggerService
+from orionis.services.log.contracts.log_service import ILogger
 from orionis.services.log.exceptions import LoggerRuntimeError
 from orionis.services.log.handlers.filename import FileNameLogger
 from orionis.services.log.handlers.size_rotating import PrefixedSizeRotatingFileHandler
 from orionis.services.log.handlers.timed_rotating import PrefixedTimedRotatingFileHandler
 
-class LoggerService(ILoggerService):
+class Logger(ILogger):
 
     def __init__(
         self,
@@ -14,7 +14,7 @@ class LoggerService(ILoggerService):
         **kwargs
     ):
         """
-        Initializes the LoggerService instance with the provided logging configuration.
+        Initializes the Logger instance with the provided logging configuration.
 
         This constructor sets up the logger configuration using either a `Logging` object,
         a configuration dictionary, or keyword arguments. It validates the input and

{orionis-0.453.0.dist-info → orionis-0.455.0.dist-info}/METADATA

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

{orionis-0.453.0.dist-info → orionis-0.455.0.dist-info}/RECORD

@@ -1,7 +1,7 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/app.py,sha256=b69fOzj2J8Aw5g0IldWZXixUDeeTO9vcHc_Njses9HU,603
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/kernel.py,sha256=1CuBCLR6KItRt0_m50YQXirJUMX6lJf4Z4vvOjBqaUU,856
+orionis/console/kernel.py,sha256=NGiINJzYRpxjQslZeELxxySxI-tL_isRrUL0yn4uz5o,3942
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/args/argument.py,sha256=Is8Z8_kW4DvcK1nK1UU-sa6Pk0BeOdcRczCayW0ZVHc,20360
 orionis/console/args/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -11,11 +11,13 @@ orionis/console/base/command.py,sha256=nasVPyKEvuv8sDFEWXhHyBCWAmSLfPPm2XlKaYYt_
 orionis/console/base/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/base/contracts/command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
 orionis/console/commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/commands/version.py,sha256=kR8xzyc-Wisk7AXqg3Do7M9xTg_CxJgAtESPGrbRtpI,1673
+orionis/console/commands/help.py,sha256=EGg5FfWnLasi7I7gCTBLyvau6I0gVpc2ewNefyJlHeE,1494
+orionis/console/commands/version.py,sha256=0neKUq7MulO0hLZyU9LLfIQYEaQtnm3faIjIfeK52V8,2886
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
+orionis/console/contracts/reactor.py,sha256=fT49-794RI-y0ZhDyXf91VQoFdGx6kF1Kg-monJnj7s,1296
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/core/reactor.py,sha256=nfts3Tuvz5GHhavN3AmFjSM2uxJDV8yh_xQP1JMgd9A,19265
+orionis/console/core/reactor.py,sha256=DoloMbAw7WojH38rSKmrRAArl8rWVb5J_p1YLepUMpc,21619
 orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dumper/dump.py,sha256=CATERiQ6XuIrKQsDaWcVxzTtlAJI9qLJX44fQxEX8ws,22443
 orionis/console/dumper/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -69,7 +71,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=51pEbB7s99-NxEBqXKT-6Wq7-vrN1Or1QUjEWTWRjgI,76927
+orionis/foundation/application.py,sha256=yZ1C92A2bTtWK4RUd9RSACLVQVBPjd6zElTt6_kjV6k,77026
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=vbzduprRCNyYeR2nnMaqc1uKXw6PTzAY2jVfXNQKN8I,9691
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -175,12 +177,13 @@ orionis/foundation/providers/console_provider.py,sha256=9oDHOGm79O8OtwTFPCYl4hNQ
 orionis/foundation/providers/dumper_provider.py,sha256=nKHjLDClCo-KnPloh6EYVySjgzf6SYSvoxVD6IwJt8M,3355
 orionis/foundation/providers/executor_provider.py,sha256=kwkH8YWEXoEoP51akJXQJ0U25rhlOLxnfE0s9fALr0I,3478
 orionis/foundation/providers/inspirational_provider.py,sha256=uq2o0uLd5p6PR99uH4cJAcc6NnU6nIOwe0ZIdzZcF4Q,3726
-orionis/foundation/providers/logger_provider.py,sha256=Xs7axVCuoOLl8jTMeLlCRPjqfnssViIHyECh90HnL7M,3670
+orionis/foundation/providers/logger_provider.py,sha256=bEJug46TNNxuqfCI8eI-GSp0eyNromvBDszQGK-0roc,3607
 orionis/foundation/providers/progress_bar_provider.py,sha256=X4Ke7mPr0MgVp6WDNaQ3bI3Z_LOS8qE-wid0MQErKms,3367
+orionis/foundation/providers/reactor_provider.py,sha256=g7X5eyZviQkX2hD7jZof6h1hZmN8rNvODmhGFysfiEY,3712
 orionis/foundation/providers/testing_provider.py,sha256=YTubcNnWrG3SPx5NM5HgYefvUYoXdlzXcjljnjavUwM,6462
 orionis/foundation/providers/workers_provider.py,sha256=5CvlUETdIblh7Wx8pT0MswTeTCGhYah-EvFqOrLu8Mo,4113
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=Yydz9pUk2t1eQMGQc4uRQ9sN3Yuqg26Q4mjWpxGSktM,4088
+orionis/metadata/framework.py,sha256=JAfHRLGQ0Og0YGg0c-lw57DmKEKRHHsLbF_MiXSsRyI,4088
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -251,9 +254,9 @@ orionis/services/introspection/modules/contracts/reflection.py,sha256=YLqKg5Ehad
 orionis/services/introspection/objects/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/introspection/objects/types.py,sha256=vNKWc2b7K-X7B2X8RCimgAWQqbQlVT-aL24nUB8t_yQ,6343
 orionis/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/log/log_service.py,sha256=DsbU8HVf035HxumFm4Xjo7kYhuXf0D57Xhuz7uzKhGo,11344
+orionis/services/log/log_service.py,sha256=PY8a7DB-kCOlwtG85J_ASQIPRw0_aRGBiqlyQho0Gxw,11316
 orionis/services/log/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/services/log/contracts/log_service.py,sha256=M8JLyb0roDfkxkA5y1T3ugs3BTEtalbKV-LbzZ5B5Es,1699
+orionis/services/log/contracts/log_service.py,sha256=YVWkK5z6-3jyJv6aT8fbp53nQBF8jlD-aHGKqFYPdAM,1692
 orionis/services/log/exceptions/__init__.py,sha256=PPn_LBV3U-0Yi69ZLDQmlkbmlL1iLTleLw-s88Ipg9o,84
 orionis/services/log/exceptions/runtime.py,sha256=LnaK0w0WlgxtZ9Zjn9RYIgp6fbQZmXZ_1fy9dkuA2jQ,468
 orionis/services/log/handlers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -345,7 +348,7 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.453.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.455.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -441,21 +444,21 @@ tests/services/environment/test_services_environment.py,sha256=8gbF2vK238lracBip
 tests/services/introspection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/introspection/test_reflection.py,sha256=AaBi0zi7GphOqnagV8N48GZHUuoT7743Pw3oc6_As6I,13700
 tests/services/introspection/dependencies/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/introspection/dependencies/test_reflect_dependencies.py,sha256=DRbYZC4EBreSS48txlZB_kzka1_NtOXZwI2ell_pOVc,13698
+tests/services/introspection/dependencies/test_reflect_dependencies.py,sha256=UJwASK4ItTehXvWMq75vIMxBWTg2euS105EgRaIkVic,13894
 tests/services/introspection/dependencies/mocks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/introspection/dependencies/mocks/mock_user.py,sha256=RxATxe0-Vm4HfX5jKz9Tny42E2fmrdtEN6ZEntbqRL8,912
 tests/services/introspection/dependencies/mocks/mock_user_controller.py,sha256=Hu4Xys5HENpKaLqsEAjtp_C-M9y6ozmJ_-qmj3ZvK6c,1214
 tests/services/introspection/dependencies/mocks/mock_users_permissions.py,sha256=oENXbS2qmQUudYSmnhB8fgHBqXZdbplplB-Y2nbx4hw,1388
 tests/services/introspection/reflection/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/introspection/reflection/test_reflection_abstract.py,sha256=tL6gvsiZC6LntguAetYv1W1ts7oY8ruHF2iJpqFlFuM,42422
+tests/services/introspection/reflection/test_reflection_abstract.py,sha256=MG243SrYBCaRHI85ifQE2t_Dwuy5LQdVAS4mrS3_n8E,41778
 tests/services/introspection/reflection/test_reflection_callable.py,sha256=OVu4FmzkfVBbDrjWqrrq-1eqe9myNGygNpmtyCnu9hs,6817
-tests/services/introspection/reflection/test_reflection_concrete.py,sha256=HXU5pzfwXEBP614yESqbtfZJiWBnZxHYAHB8FuE2hKs,39083
-tests/services/introspection/reflection/test_reflection_instance.py,sha256=C4Aj8AxtTP0buoprdtb96Su3DBj9i-k9lcdf4WSYnQA,58039
+tests/services/introspection/reflection/test_reflection_concrete.py,sha256=7L4QTae1mDCujMZ0vvI4qsoTQxnRkeIuv3cXRdbISuc,38441
+tests/services/introspection/reflection/test_reflection_instance.py,sha256=IpYm45S9kaGXGvkCIrnwAVxN-mtL1QUd7iV9niUpmTQ,57397
 tests/services/introspection/reflection/test_reflection_module.py,sha256=a4sjSHeKADHUO5FvSDg1wPYNGfO385JZxSCoIqjfuZE,24608
 tests/services/introspection/reflection/mock/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/introspection/reflection/mock/fake_reflect_instance.py,sha256=iMf_yKgk0Y91XUHhRcl2qw7Z83QeNspvLi_tl4Dp-rI,28032
 tests/services/log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-tests/services/log/test_log.py,sha256=fCI2gX9-YN1z-xPMwIlggUFHeBlqfUajQoyQu4dmao0,2868
+tests/services/log/test_log.py,sha256=AWaEjBbUxz_1-GNsqEyb36EyD6ZtrHd51DnxA3I5nvE,2798
 tests/services/system/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/services/system/test_services_system_imports.py,sha256=jbtIQkw_4DI6x2E-4Lg3evnLAgCgDIBWE63LdJTLkxc,7507
 tests/services/system/test_services_system_workers.py,sha256=wITbpJHKW_OXqTaFeteNRFuw5Q3_7d9lWNJnFE2r6to,5052
@@ -488,8 +491,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.453.0.dist-info/METADATA,sha256=2l6AHDIa0Uv_iDNRBUqX-k7yrNBwlTyuSR3Z8zUp4Mc,4772
-orionis-0.453.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.453.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.453.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.453.0.dist-info/RECORD,,
+orionis-0.455.0.dist-info/METADATA,sha256=SUABH7qF9bf2fsAB7sQBWXsVnnFjfXM5-k4vp6i_u2I,4772
+orionis-0.455.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.455.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.455.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.455.0.dist-info/RECORD,,

tests/services/introspection/dependencies/test_reflect_dependencies.py

@@ -170,7 +170,7 @@ class TestReflectDependencies(AsyncTestCase):
         self.assertEqual(dep_user_permissions.type, FakeUserWithPermissions)
 
         # Extract and validate the 'permissions' dependency (built-in generic type)
-        dep_permissions: Argument = method_dependencies.resolved.get('permissions')
+        dep_permissions: Argument = method_dependencies.unresolved.get('permissions')
 
         # Ensure the built-in type dependency is properly resolved as an Argument instance
         self.assertIsInstance(dep_permissions, Argument)
@@ -248,10 +248,14 @@ class TestReflectDependencies(AsyncTestCase):
         dep_x: Argument = callable_dependencies.resolved.get('x')
 
         # Verify that the 'x' parameter resolves to its default value of 3
-        self.assertEqual(dep_x, 3)
+        self.assertIsInstance(dep_x, Argument)
+        self.assertTrue(dep_x.resolved)
+        self.assertEqual(dep_x.default, 3)
 
         # Extract and validate the 'y' parameter dependency from resolved dependencies
         dep_y: Argument = callable_dependencies.resolved.get('y')
 
         # Verify that the 'y' parameter resolves to its default value of 4
-        self.assertEqual(dep_y, 4)
+        self.assertIsInstance(dep_y, Argument)
+        self.assertTrue(dep_y.resolved)
+        self.assertEqual(dep_y.default, 4)

tests/services/introspection/reflection/test_reflection_abstract.py

@@ -1007,14 +1007,5 @@ class TestServiceReflectionAbstract(AsyncTestCase):
         """
         reflect = ReflectionAbstract(AbstractFakeClass)
         method_deps: ResolveArguments = reflect.getMethodDependencies('instanceSyncMethod')
-        self.assertIn('x', method_deps.resolved)
-        self.assertIn('y', method_deps.resolved)
-        self.assertEqual(method_deps.resolved['x'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['y'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['x'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['y'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['x'].type, int)
-        self.assertEqual(method_deps.resolved['y'].type, int)
-        self.assertEqual(method_deps.resolved['x'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.resolved['y'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.unresolved, [])
+        self.assertIn('x', method_deps.unresolved)
+        self.assertIn('y', method_deps.unresolved)

tests/services/introspection/reflection/test_reflection_concrete.py

@@ -948,14 +948,5 @@ class TestServiceReflectionConcrete(AsyncTestCase):
         """
         reflect = ReflectionConcrete(FakeClass)
         method_deps: ResolveArguments = reflect.getMethodDependencies('instanceSyncMethod')
-        self.assertIn('x', method_deps.resolved)
-        self.assertIn('y', method_deps.resolved)
-        self.assertEqual(method_deps.resolved['x'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['y'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['x'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['y'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['x'].type, int)
-        self.assertEqual(method_deps.resolved['y'].type, int)
-        self.assertEqual(method_deps.resolved['x'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.resolved['y'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.unresolved, [])
+        self.assertIn('x', method_deps.unresolved)
+        self.assertIn('y', method_deps.unresolved)

tests/services/introspection/reflection/test_reflection_instance.py

@@ -1229,14 +1229,5 @@ class TestServiceReflectionInstance(AsyncTestCase):
         """
         reflect = ReflectionInstance(FakeClass())
         method_deps: ResolveArguments = reflect.getMethodDependencies('instanceSyncMethod')
-        self.assertIn('x', method_deps.resolved)
-        self.assertIn('y', method_deps.resolved)
-        self.assertEqual(method_deps.resolved['x'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['y'].class_name, 'int')
-        self.assertEqual(method_deps.resolved['x'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['y'].module_name, 'builtins')
-        self.assertEqual(method_deps.resolved['x'].type, int)
-        self.assertEqual(method_deps.resolved['y'].type, int)
-        self.assertEqual(method_deps.resolved['x'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.resolved['y'].full_class_path, 'builtins.int')
-        self.assertEqual(method_deps.unresolved, [])
+        self.assertIn('x', method_deps.unresolved)
+        self.assertIn('y', method_deps.unresolved)

tests/services/log/test_log.py

@@ -1,52 +1,52 @@
-from orionis.services.log.log_service import LoggerService
+from orionis.services.log.log_service import Logger
 from orionis.support.facades.logger import Log
 from orionis.test.cases.asynchronous import AsyncTestCase
 
-class TestLoggerService(AsyncTestCase):
+class TestLogger(AsyncTestCase):
 
     async def testHasInfoMethod(self):
         """
-        Checks if the LoggerService class has an 'info' method.
+        Checks if the Logger class has an 'info' method.
 
         Returns
         -------
         None
             This test passes if the 'info' method exists, otherwise it fails.
         """
-        self.assertTrue(hasattr(LoggerService, "info"))
+        self.assertTrue(hasattr(Logger, "info"))
 
     async def testHasErrorMethod(self):
         """
-        Checks if the LoggerService class has an 'error' method.
+        Checks if the Logger class has an 'error' method.
 
         Returns
         -------
         None
             This test passes if the 'error' method exists, otherwise it fails.
         """
-        self.assertTrue(hasattr(LoggerService, "error"))
+        self.assertTrue(hasattr(Logger, "error"))
 
     async def testHasWarningMethod(self):
         """
-        Checks if the LoggerService class has a 'warning' method.
+        Checks if the Logger class has a 'warning' method.
 
         Returns
         -------
         None
             This test passes if the 'warning' method exists, otherwise it fails.
         """
-        self.assertTrue(hasattr(LoggerService, "warning"))
+        self.assertTrue(hasattr(Logger, "warning"))
 
     async def testHasDebugMethod(self):
         """
-        Checks if the LoggerService class has a 'debug' method.
+        Checks if the Logger class has a 'debug' method.
 
         Returns
         -------
         None
             This test passes if the 'debug' method exists, otherwise it fails.
         """
-        self.assertTrue(hasattr(LoggerService, "debug"))
+        self.assertTrue(hasattr(Logger, "debug"))
 
     async def testLoggerWritesInfo(self):
         """