orionis 0.454.0__py3-none-any.whl → 0.456.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/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

@@ -8,13 +8,14 @@ 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
 from orionis.services.log.contracts.log_service import ILogger
 
-class Reactor:
+class Reactor(IReactor):
 
     def __init__(
         self,
@@ -100,9 +101,13 @@ class Reactor:
 
         # 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]
+        core_commands = [
+            VersionCommand,
+            HelpCommand
+        ]
 
         # Iterate through the core command classes and register them
         for obj in core_commands:

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

@@ -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

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/foundation/providers/testing_provider.py

@@ -1,8 +1,6 @@
 from orionis.container.providers.service_provider import ServiceProvider
 from orionis.test.contracts.unit_test import IUnitTest
 from orionis.test.core.unit_test import UnitTest
-from orionis.foundation.config.testing.entities.testing import Testing
-import os
 
 class TestingProvider(ServiceProvider):
     """
@@ -39,87 +37,41 @@ class TestingProvider(ServiceProvider):
 
     def register(self) -> None:
         """
-        Register the unit testing service in the application container.
+        Register and configure the unit testing service in the application container.
 
-        This method creates and configures a UnitTest instance using the application's
-        testing configuration, discovers test files based on specified patterns and paths,
-        and registers the configured testing service as a singleton in the dependency
-        injection container with the IUnitTest interface binding.
+        This method loads the testing configuration from the application, instantiates
+        and configures a UnitTest service, and registers it as a singleton in the
+        dependency injection container. The service is bound to the IUnitTest interface
+        and is accessible via the alias "x-orionis.test.core.unit_test".
 
         The registration process includes:
-        - Loading testing configuration from the application config
-        - Creating and configuring a UnitTest instance with various settings
-        - Discovering test files based on configuration parameters
-        - Binding the service to the container with alias "x-orionis.test.core.unit_test"
+            - Retrieving testing configuration from the application settings.
+            - Instantiating the UnitTest service with the appropriate configuration.
+            - Registering the UnitTest service as a singleton in the container.
+            - Binding the service to the IUnitTest interface and alias.
 
         Returns
         -------
         None
             This method does not return any value. It performs side effects by
-            registering the testing service in the application container.
+            registering and binding the testing service in the application container.
         """
 
-        # Load testing configuration from application config and create Testing instance
-        config = Testing(**self.app.config('testing'))
-
-        # Instantiate the UnitTest implementation with application reference
-        unit_test = UnitTest(
-            app=self.app
-        )
-
-        # Apply configuration settings to the UnitTest instance
-        unit_test.configure(
-            verbosity=config.verbosity,                 # Set output verbosity level
-            execution_mode=config.execution_mode,       # Configure test execution mode
-            max_workers=config.max_workers,             # Set maximum worker threads for parallel execution
-            fail_fast=config.fail_fast,                 # Enable/disable fail-fast behavior
-            print_result=config.print_result,           # Control result output printing
-            throw_exception=config.throw_exception,     # Configure exception throwing behavior
-            persistent=config.persistent,               # Enable/disable persistent test results
-            persistent_driver=config.persistent_driver, # Set persistent storage driver
-            web_report=config.web_report                # Enable/disable web-based reporting
-        )
-
-        # Discover and load test files based on configuration criteria
-        unit_test.discoverTests(
-            base_path=config.base_path,                 # Root directory for test discovery
-            folder_path=config.folder_path,             # Specific folder path within base_path
-            pattern=config.pattern,                     # File name pattern for test files
-            test_name_pattern=config.test_name_pattern, # Pattern for test method names
-            tags=config.tags                            # Tags to filter tests during discovery
-        )
-
-        # Register the configured UnitTest instance in the DI container
-        # Binds IUnitTest interface to the UnitTest implementation as a singleton
-        self.app.instance(IUnitTest, unit_test, alias="x-orionis.test.core.unit_test")
+        # Register the UnitTest service as a singleton in the application container.
+        # The service is bound to the IUnitTest interface and can be resolved using the alias.
+        self.app.singleton(IUnitTest, UnitTest, alias="x-orionis.test.core.unit_test")
 
     def boot(self) -> None:
         """
-        Perform post-registration initialization for the testing provider.
+        Finalize initialization for the testing provider after service registration.
 
-        This method is called after the service registration phase to handle any
-        additional setup required for the testing environment. It ensures that
-        the necessary storage directories for testing operations are created
-        and available before test execution begins.
-
-        The boot process includes:
-        - Creating the testing storage directory if it doesn't exist
-        - Setting appropriate permissions for the storage path
-        - Preparing the filesystem structure for test artifacts
+        This method is called after the registration phase to allow for any additional
+        setup required for the testing environment. In this implementation, no further
+        actions are performed during the boot phase.
 
         Returns
         -------
         None
-            This method does not return any value. It performs initialization
-            side effects by creating required directories in the filesystem.
+            This method does not return any value.
         """
-
-        # Retrieve the configured storage path for testing artifacts and temporary files
-        storage_path = self.app.path('storage_testing')
-
-        # Check if the testing storage directory exists in the filesystem
-        if not os.path.exists(storage_path):
-
-            # Create the directory structure recursively, including parent directories
-            # exist_ok=True prevents errors if directory is created by another process
-            os.makedirs(storage_path, exist_ok=True)
+        pass

orionis/metadata/framework.py

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

orionis/test/contracts/unit_test.py

@@ -52,6 +52,60 @@ class IUnitTest(ABC):
         """
         pass
 
+    @abstractmethod
+    def discoverTests(
+        self,
+        base_path: str | Path,
+        folder_path: str | List[str],
+        pattern: str,
+        test_name_pattern: Optional[str] = None,
+        tags: Optional[List[str]] = None
+    ) -> 'IUnitTest':
+        """
+        Discover test cases from specified folders using flexible path discovery.
+
+        This method provides a convenient way to discover and load test cases from multiple folders
+        based on various path specifications. It supports wildcard discovery, single folder loading,
+        and multiple folder loading. The method automatically resolves paths relative to the base
+        directory and discovers all folders containing files matching the specified pattern.
+
+        Parameters
+        ----------
+        base_path : str or Path
+            Base directory path for resolving relative folder paths. This serves as the root
+            directory from which all folder searches are conducted.
+        folder_path : str or list of str
+            Specification of folders to search for test cases. Can be:
+            - '*' : Discover all folders containing matching files within base_path
+            - str : Single folder path relative to base_path
+            - list of str : Multiple folder paths relative to base_path
+        pattern : str
+            File name pattern to match test files, supporting wildcards (* and ?).
+            Examples: 'test_*.py', '*_test.py', 'test*.py'
+        test_name_pattern : str, optional
+            Regular expression pattern to filter test method names. Only tests whose
+            names match this pattern will be included. Default is None (no filtering).
+        tags : list of str, optional
+            List of tags to filter tests. Only tests decorated with matching tags
+            will be included. Default is None (no tag filtering).
+
+        Returns
+        -------
+        UnitTest
+            The current UnitTest instance with discovered tests added to the suite,
+            enabling method chaining.
+
+        Notes
+        -----
+        - All paths are resolved as absolute paths relative to the base_path
+        - When folder_path is '*', the method searches recursively through all subdirectories
+        - The method uses the existing discoverTestsInFolder method for actual test discovery
+        - Duplicate folders are automatically eliminated using a set data structure
+        - The method does not validate the existence of specified folders; validation
+          occurs during the actual test discovery process
+        """
+        pass
+
     @abstractmethod
     def discoverTestsInFolder(
         self,

orionis/test/kernel.py

@@ -2,6 +2,7 @@ from orionis.console.output.contracts.console import IConsole
 from orionis.foundation.contracts.application import IApplication
 from orionis.test.contracts.kernel import ITestKernel
 from orionis.test.contracts.unit_test import IUnitTest
+from orionis.foundation.config.testing.entities.testing import Testing
 from orionis.test.exceptions import OrionisTestConfigException, OrionisTestFailureException
 
 class TestKernel(ITestKernel):
@@ -38,8 +39,33 @@ class TestKernel(ITestKernel):
                 f"Failed to initialize TestKernel: expected IApplication, got {type(app).__module__}.{type(app).__name__}."
             )
 
+        # Load testing configuration from application config and create Testing instance
+        config = Testing(**app.config('testing'))
+
         # Resolve the unit test service from the application container
-        self.__unit_test: IUnitTest = app.make('x-orionis.test.core.unit_test')
+        self.__unit_test: IUnitTest = app.make('x-orionis.test.core.unit_test', app)
+
+        # Apply configuration settings to the UnitTest instance
+        self.__unit_test.configure(
+            verbosity=config.verbosity,                 # Set output verbosity level
+            execution_mode=config.execution_mode,       # Configure test execution mode
+            max_workers=config.max_workers,             # Set maximum worker threads for parallel execution
+            fail_fast=config.fail_fast,                 # Enable/disable fail-fast behavior
+            print_result=config.print_result,           # Control result output printing
+            throw_exception=config.throw_exception,     # Configure exception throwing behavior
+            persistent=config.persistent,               # Enable/disable persistent test results
+            persistent_driver=config.persistent_driver, # Set persistent storage driver
+            web_report=config.web_report                # Enable/disable web-based reporting
+        )
+
+        # Discover and load test files based on configuration criteria
+        self.__unit_test.discoverTests(
+            base_path=config.base_path,                 # Root directory for test discovery
+            folder_path=config.folder_path,             # Specific folder path within base_path
+            pattern=config.pattern,                     # File name pattern for test files
+            test_name_pattern=config.test_name_pattern, # Pattern for test method names
+            tags=config.tags                            # Tags to filter tests during discovery
+        )
 
         # Resolve the console service from the application container
         self.__console: IConsole = app.make('x-orionis.console.output.console')

{orionis-0.454.0.dist-info → orionis-0.456.0.dist-info}/METADATA

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

{orionis-0.454.0.dist-info → orionis-0.456.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/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=soDKgpUv6yJRbBi2KYSaIBl7Wduuh18M6_r_GJUlt-4,21440
+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=NJnNMI7rRs-UUqrBeKz4qFWh8m4CxSzfXIeFXqWyNIE,76913
+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
@@ -177,10 +179,11 @@ orionis/foundation/providers/executor_provider.py,sha256=kwkH8YWEXoEoP51akJXQJ0U
 orionis/foundation/providers/inspirational_provider.py,sha256=uq2o0uLd5p6PR99uH4cJAcc6NnU6nIOwe0ZIdzZcF4Q,3726
 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/testing_provider.py,sha256=YTubcNnWrG3SPx5NM5HgYefvUYoXdlzXcjljnjavUwM,6462
+orionis/foundation/providers/reactor_provider.py,sha256=g7X5eyZviQkX2hD7jZof6h1hZmN8rNvODmhGFysfiEY,3712
+orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 orionis/foundation/providers/workers_provider.py,sha256=5CvlUETdIblh7Wx8pT0MswTeTCGhYah-EvFqOrLu8Mo,4113
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=oSHL9LvTh8EDTJZ8jCIrUJM3JI8L6rsiWy1p93G_r-U,4088
+orionis/metadata/framework.py,sha256=F5pE_UIelgIj5tk73nlMNZoqHahNmXnoQAl4vkJJjmg,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
@@ -298,7 +301,7 @@ orionis/support/standard/exceptions/value.py,sha256=rsyWFQweImaJGTJa7Id7RhPlwWJ4
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=T8xWwwOhBZHNeXRwE_CxvOwG9UFxsLqNmOJjV2CNIrc,7284
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=iis03o0DH3kc-y2gaLdGxluFi0y4kpWNTBQetQBE24Y,3250
+orionis/test/kernel.py,sha256=iFJh72_YHPzQbeFyOJWU4R9vfWohfElLRU17Ak_Vhos,5024
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/cases/asynchronous.py,sha256=3e1Y3qzIxVU7i7lbLFEVyJ89IA74JsB7famx71W-p2E,1974
 orionis/test/cases/synchronous.py,sha256=S5jhuDEZ5I9wosrTFaCtowkD5r5HzJH6mKPOdEJcDJE,1734
@@ -309,7 +312,7 @@ orionis/test/contracts/logs.py,sha256=kRH3TGQcTNI0kRxFyEs13Y7NOPP9x9WGitPexnoLzQ
 orionis/test/contracts/printer.py,sha256=iBz8wHAGaS21VBsHlZQVcx0xu9Bqusb-CLAjj-R1Sjg,3412
 orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZO1c,744
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
-orionis/test/contracts/unit_test.py,sha256=PSnjEyM-QGQ3Pm0ZOqaa8QdPOtilGBVO4R87JYdVa-8,5386
+orionis/test/contracts/unit_test.py,sha256=getqaBoadQT_wh_V6aTQvm0yx9IgbVrE9EEOD8b031g,8031
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/core/unit_test.py,sha256=WU107nW5mhLZ8wluhtxkaBNuOKaqAb6BswpdQ-ozCXI,64834
 orionis/test/entities/__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.454.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.456.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,16 +444,16 @@ 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
@@ -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.454.0.dist-info/METADATA,sha256=ka4ELLbV-p9I2aj-3AbF6rGacgecPpH2QGSbCiOkqJk,4772
-orionis-0.454.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.454.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.454.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.454.0.dist-info/RECORD,,
+orionis-0.456.0.dist-info/METADATA,sha256=CuJ0cT18-oNIn-451hxfWvnoA4an7SVDx3Lv9uTvSY4,4772
+orionis-0.456.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.456.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.456.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.456.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)