orionis 0.371.0__py3-none-any.whl → 0.373.0__py3-none-any.whl

orionis/__init__.py

@@ -0,0 +1,9 @@
+from orionis.foundation.application import (
+    Application as Orionis,
+    IApplication as IOrionis
+)
+
+__all__ = [
+    "Orionis",
+    "IOrionis"
+]

orionis/container/resolver/resolver.py

@@ -7,7 +7,7 @@ from orionis.container.enums.lifetimes import Lifetime
 from orionis.container.exceptions import OrionisContainerException
 from orionis.services.introspection.callables.reflection import ReflectionCallable
 from orionis.services.introspection.concretes.reflection import ReflectionConcrete
-from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 
 class Resolver(IResolver):
     """
@@ -367,8 +367,8 @@ class Resolver(IResolver):
             params = {}
             for param_name, dep in dependencies.resolved.items():
 
-                # If the dependency is a ResolvedDependency, resolve it
-                if isinstance(dep, ResolvedDependency):
+                # If the dependency is a KnownDependency, resolve it
+                if isinstance(dep, KnownDependency):
 
                     # If the dependency is a built-in type, raise an exception
                     if dep.module_name == 'builtins':

orionis/foundation/application.py

@@ -3,7 +3,7 @@ from orionis.container.container import Container
 from orionis.container.contracts.service_provider import IServiceProvider
 from orionis.foundation.contracts.application import IApplication
 
-class Orionis(Container, IApplication):
+class Application(Container, IApplication):
     """
     Application container that manages service providers.
 
@@ -42,7 +42,7 @@ class Orionis(Container, IApplication):
         super().__init__()
 
         # Check if this specific instance has already been initialized
-        if not hasattr(self, '_Orionis__initialized'):
+        if not hasattr(self, '_Application__initialized'):
 
             # Initialize provider-specific attributes
             self.__providers: List[IServiceProvider] = []
@@ -51,6 +51,69 @@ class Orionis(Container, IApplication):
             # Mark this instance as initialized
             self.__initialized = True
 
+            # Bootstrap core services
+            self.__bootFramework()
+
+    def __bootFramework(self) -> None:
+        """
+        Bootstrap the application by loading internal framework providers.
+
+        This method should be called once to ensure that core services
+        required by the framework are registered before user-defined
+        providers are loaded.
+        """
+        if not self.__booted:
+            self.__loadFrameworkProviders()
+            self.__loadFrameworksKernel()
+
+    def __loadFrameworkProviders(self) -> None:
+        """
+        Load internal framework service providers.
+
+        This method should register core services required by the framework
+        before user-defined providers are loaded.
+        """
+
+        # Import core provider classes
+        from orionis.foundation.providers.console_provider import ConsoleProvider
+        from orionis.foundation.providers.dumper_provider import DumperProvider
+        from orionis.foundation.providers.path_resolver_provider import PathResolverProvider
+        from orionis.foundation.providers.progress_bar_provider import ProgressBarProvider
+        from orionis.foundation.providers.workers_provider import WorkersProvider
+
+        # List of core providers to register
+        core_providers = [
+            ConsoleProvider,
+            DumperProvider,
+            PathResolverProvider,
+            ProgressBarProvider,
+            WorkersProvider
+        ]
+
+        # Register each core provider with the application
+        for provider_cls in core_providers:
+            self.__registerProvider(provider_cls)
+
+    def __loadFrameworksKernel(self) -> None:
+        """
+        Load the core framework kernel.
+
+        This method is responsible for loading the core kernel of the framework,
+        which is essential for the application to function correctly.
+        """
+
+        # Import Kernel classes
+        from orionis.test.kernel import TestKernel, ITestKernel
+
+        # List of core kernels to register
+        core_kernels = {
+            ITestKernel: TestKernel
+        }
+
+        # Register each core kernel with the application
+        for kernel_name, kernel_cls in core_kernels.items():
+            self.instance(kernel_name, kernel_cls(self))
+
     def __registerProvider(
         self,
         provider_cls: Type[IServiceProvider]
@@ -103,32 +166,7 @@ class Orionis(Container, IApplication):
 
         self.__booted = True
 
-    def __loadFrameworkProviders(self) -> None:
-        """
-        Load internal framework service providers.
-
-        This method should register core services required by the framework
-        before user-defined providers are loaded.
-        """
-        from orionis.foundation.providers.console_provider import ConsoleProvider
-        from orionis.foundation.providers.dumper_provider import DumperProvider
-        from orionis.foundation.providers.path_resolver_provider import PathResolverProvider
-        from orionis.foundation.providers.progress_bar_provider import ProgressBarProvider
-        from orionis.foundation.providers.workers_provider import WorkersProvider
-
-        core_providers = [
-            ConsoleProvider,
-            DumperProvider,
-            PathResolverProvider,
-            ProgressBarProvider,
-            WorkersProvider
-        ]
-
-        for provider_cls in core_providers:
-            self.__registerProvider(provider_cls)
-
-
-    def load(self, providers: List[Type[IServiceProvider]]) -> None:
+    def load(self, providers: List[Type[IServiceProvider]] = []) -> None:
         """
         Load and boot a list of service providers.
 
@@ -144,9 +182,6 @@ class Orionis(Container, IApplication):
         None
         """
 
-        # Load internal framework providers first
-        self.__loadFrameworkProviders()
-
         # Register and boot each provided service provider
         for provider_cls in providers:
             self.__registerProvider(provider_cls)

orionis/foundation/contracts/application.py

@@ -28,7 +28,7 @@ class IApplication(IContainer):
         pass
 
     @abstractmethod
-    def load(self, providers: List[Type[IServiceProvider]]) -> None:
+    def load(self, providers: List[Type[IServiceProvider]] = []) -> None:
         """
         Load and boot a list of service providers.
 

orionis/metadata/framework.py

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

orionis/services/introspection/dependencies/entities/callable_dependencies.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
-from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
@@ -10,9 +10,9 @@ class CallableDependency:
 
     Parameters
     ----------
-    resolved : Dict[ResolvedDependency, Any]
+    resolved : Dict[KnownDependency, Any]
         A dictionary mapping resolved dependency descriptors to their corresponding
-        resolved instances or values for the method. All keys must be ResolvedDependency instances.
+        resolved instances or values for the method. All keys must be KnownDependency instances.
     unresolved : List[str]
         A list of method parameter names or dependency identifiers that could not be resolved.
         Must contain only non-empty strings.
@@ -21,12 +21,12 @@ class CallableDependency:
     ------
     ReflectionTypeError
         If types don't match the expected:
-            - resolved: Dict[ResolvedDependency, Any]
+            - resolved: Dict[KnownDependency, Any]
             - unresolved: List[str]
     ValueError
         If resolved contains None keys or unresolved contains empty strings
     """
-    resolved: Dict[ResolvedDependency, Any]
+    resolved: Dict[KnownDependency, Any]
     unresolved: List[str]
 
     def __post_init__(self):
@@ -37,7 +37,7 @@ class CallableDependency:
         ------
         ReflectionTypeError
             If types don't match the expected:
-                - resolved: Dict[ResolvedDependency, Any]
+                - resolved: Dict[KnownDependency, Any]
                 - unresolved: List[str]
         ValueError
             If resolved contains None keys or unresolved contains empty strings

orionis/services/introspection/dependencies/entities/class_dependencies.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
-from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
@@ -10,21 +10,21 @@ class ClassDependency:
 
     Parameters
     ----------
-    resolved : Dict[ResolvedDependency, Any]
+    resolved : Dict[KnownDependency, Any]
         A dictionary mapping resolved dependency descriptors to their corresponding resolved instances or values.
-        All keys must be ResolvedDependency instances.
+        All keys must be KnownDependency instances.
     unresolved : List[str]
         A list of dependency names or identifiers that could not be resolved.
         Must contain only strings.
 
     Attributes
     ----------
-    resolved : Dict[ResolvedDependency, Any]
+    resolved : Dict[KnownDependency, Any]
         Dictionary of resolved dependencies.
     unresolved : List[str]
         List of unresolved dependency names.
     """
-    resolved: Dict[ResolvedDependency, Any]
+    resolved: Dict[KnownDependency, Any]
     unresolved: List[str]
 
     def __post_init__(self):
@@ -35,12 +35,12 @@ class ClassDependency:
         ------
         ReflectionTypeError
             If types don't match the expected:
-                - resolved: Dict[ResolvedDependency, Any]
+                - resolved: Dict[KnownDependency, Any]
                 - unresolved: List[str]
         ValueError
             If resolved contains None keys or unresolved contains empty strings.
         """
-        # Validate 'resolved' is a dict with ResolvedDependency keys
+        # Validate 'resolved' is a dict with KnownDependency keys
         if not isinstance(self.resolved, dict):
             raise ReflectionTypeError(
                 f"'resolved' must be a dict, got {type(self.resolved).__name__}"

orionis/services/introspection/dependencies/entities/{resolved_dependencies.py → known_dependencies.py}

@@ -3,7 +3,7 @@ from typing import Type, Any
 from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
-class ResolvedDependency:
+class KnownDependency:
     """
     Represents a fully resolved dependency with complete type information.
 

orionis/services/introspection/dependencies/entities/method_dependencies.py

@@ -1,6 +1,6 @@
 from dataclasses import dataclass
 from typing import Any, Dict, List
-from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 from orionis.services.introspection.exceptions import ReflectionTypeError
 
 @dataclass(frozen=True, kw_only=True)
@@ -10,9 +10,9 @@ class MethodDependency:
 
     Parameters
     ----------
-    resolved : Dict[ResolvedDependency, Any]
+    resolved : Dict[KnownDependency, Any]
         A dictionary mapping resolved dependency descriptors to their corresponding
-        resolved instances or values for the method. All keys must be ResolvedDependency instances.
+        resolved instances or values for the method. All keys must be KnownDependency instances.
     unresolved : List[str]
         A list of method parameter names or dependency identifiers that could not be resolved.
         Must contain only non-empty strings.
@@ -21,12 +21,12 @@ class MethodDependency:
     ------
     ReflectionTypeError
         If types don't match the expected:
-            - resolved: Dict[ResolvedDependency, Any]
+            - resolved: Dict[KnownDependency, Any]
             - unresolved: List[str]
     ValueError
         If resolved contains None keys or unresolved contains empty strings
     """
-    resolved: Dict[ResolvedDependency, Any]
+    resolved: Dict[KnownDependency, Any]
     unresolved: List[str]
 
     def __post_init__(self):
@@ -37,7 +37,7 @@ class MethodDependency:
         ------
         ReflectionTypeError
             If types don't match the expected:
-                - resolved: Dict[ResolvedDependency, Any]
+                - resolved: Dict[KnownDependency, Any]
                 - unresolved: List[str]
         ValueError
             If resolved contains None keys or unresolved contains empty strings

orionis/services/introspection/dependencies/reflection.py

@@ -4,7 +4,7 @@ from orionis.services.introspection.dependencies.contracts.reflection import IRe
 from orionis.services.introspection.dependencies.entities.callable_dependencies import CallableDependency
 from orionis.services.introspection.dependencies.entities.class_dependencies import ClassDependency
 from orionis.services.introspection.dependencies.entities.method_dependencies import MethodDependency
-from orionis.services.introspection.dependencies.entities.resolved_dependencies import ResolvedDependency
+from orionis.services.introspection.dependencies.entities.known_dependencies import KnownDependency
 from orionis.services.introspection.exceptions import ReflectionValueError
 
 class ReflectDependencies(IReflectDependencies):
@@ -114,7 +114,7 @@ class ReflectDependencies(IReflectDependencies):
             # If the parameter has an annotation, it is added to the list of resolved dependencies
             if param.annotation is not param.empty:
                 module_path = param.annotation.__module__
-                resolved_dependencies[param_name] = ResolvedDependency(
+                resolved_dependencies[param_name] = KnownDependency(
                     module_name=module_path,
                     class_name=param.annotation.__name__,
                     type=param.annotation,
@@ -165,7 +165,7 @@ class ReflectDependencies(IReflectDependencies):
             # If the parameter has an annotation, it is added to the list of resolved dependencies
             if param.annotation is not param.empty:
                 module_path = param.annotation.__module__
-                resolved_dependencies[param_name] = ResolvedDependency(
+                resolved_dependencies[param_name] = KnownDependency(
                     module_name=module_path,
                     class_name=param.annotation.__name__,
                     type=param.annotation,
@@ -216,7 +216,7 @@ class ReflectDependencies(IReflectDependencies):
             # If the parameter has an annotation, it is added to the list of resolved dependencies
             if param.annotation is not param.empty:
                 module_path = param.annotation.__module__
-                resolved_dependencies[param_name] = ResolvedDependency(
+                resolved_dependencies[param_name] = KnownDependency(
                     module_name=module_path,
                     class_name=param.annotation.__name__,
                     type=param.annotation,

orionis/test/arguments/parser.py

@@ -0,0 +1,197 @@
+import argparse
+from orionis.test.contracts.parser import ITestArgumentParser
+from orionis.test.entities.arguments import TestArguments
+
+class TestArgumentParser(ITestArgumentParser):
+    """
+    A parser class for handling test command-line arguments.
+
+    This class encapsulates the logic for creating and configuring the argument parser
+    for the Orionis test runner, providing a clean interface for parsing test arguments.
+    """
+
+    def __init__(
+        self
+    ) -> None:
+        """Initialize the argument parser with all required arguments."""
+        self.parser = self.__create()
+
+    def __create(
+        self
+    ) -> argparse.ArgumentParser:
+        """
+        Create and configure the argument parser with all test-related arguments.
+
+        Returns
+        -------
+        argparse.ArgumentParser
+            The configured argument parser instance.
+        """
+        parser = argparse.ArgumentParser(description="Run Orionis tests.")
+
+        # Basic test configuration
+        parser.add_argument(
+            '--verbosity',
+            type=int,
+            default=2,
+            help='Verbosity level (default: 2)'
+        )
+
+        parser.add_argument(
+            '--mode',
+            choices=['parallel', 'sequential'],
+            default='parallel',
+            help='Execution mode for tests (default: parallel)'
+        )
+
+        # Fail fast configuration
+        parser.add_argument(
+            '--fail_fast',
+            dest='fail_fast',
+            action='store_true',
+            help='Stop on first failure'
+        )
+        parser.add_argument(
+            '--no_fail_fast',
+            dest='fail_fast',
+            action='store_false',
+            help='Do not stop on first failure (default)'
+        )
+        parser.set_defaults(fail_fast=False)
+
+        # Print result configuration
+        parser.add_argument(
+            '--print_result',
+            dest='print_result',
+            action='store_true',
+            help='Print test results to console (default)'
+        )
+        parser.add_argument(
+            '--no_print_result',
+            dest='print_result',
+            action='store_false',
+            help='Do not print test results to console'
+        )
+        parser.set_defaults(print_result=True)
+
+        # Exception handling configuration
+        parser.add_argument(
+            '--throw_exception',
+            dest='throw_exception',
+            action='store_true',
+            help='Throw exception on test failure'
+        )
+        parser.add_argument(
+            '--no_throw_exception',
+            dest='throw_exception',
+            action='store_false',
+            help='Do not throw exception on test failure (default)'
+        )
+        parser.set_defaults(throw_exception=False)
+
+        # Persistent mode configuration
+        parser.add_argument(
+            '--persistent',
+            dest='persistent',
+            action='store_true',
+            help='Run tests in persistent mode'
+        )
+        parser.add_argument(
+            '--no_persistent',
+            dest='persistent',
+            action='store_false',
+            help='Do not run tests in persistent mode (default)'
+        )
+        parser.set_defaults(persistent=False)
+
+        parser.add_argument(
+            '--persistent_driver',
+            type=str,
+            default=None,
+            help='Persistent driver to use (default: None)'
+        )
+
+        # Web report configuration
+        parser.add_argument(
+            '--web_report',
+            dest='web_report',
+            action='store_true',
+            help='Generate web report'
+        )
+        parser.add_argument(
+            '--no_web_report',
+            dest='web_report',
+            action='store_false',
+            help='Do not generate web report (default)'
+        )
+        parser.set_defaults(web_report=False)
+
+        # Output buffer configuration
+        parser.add_argument(
+            '--print_output_buffer',
+            dest='print_output_buffer',
+            action='store_true',
+            help='Print output buffer (for CI integrations)'
+        )
+        parser.add_argument(
+            '--no_print_output_buffer',
+            dest='print_output_buffer',
+            action='store_false',
+            help='Do not print output buffer (default)'
+        )
+        parser.set_defaults(print_output_buffer=False)
+
+        return parser
+
+    def parse(
+        self,
+        args=None
+    ) -> TestArguments:
+        """
+        Parse command line arguments and return TestArguments object.
+
+        Parameters
+        ----------
+        args : list, optional
+            List of arguments to parse. If None, uses sys.argv.
+
+        Returns
+        -------
+        TestArguments
+            Parsed test arguments object.
+        """
+        return self.parser.parse_args(args)
+
+    def help(
+        self
+    ) -> None:
+        """Print help message for the test runner."""
+        self.parser.print_help()
+
+def test_parser_init() -> TestArgumentParser:
+    """
+    Factory function to create a TestArgumentParser instance.
+
+    Returns
+    -------
+    TestArgumentParser
+        A new instance of the test argument parser.
+    """
+    return TestArgumentParser()
+
+def cli_test_args(args=None) -> TestArguments:
+    """
+    Convenience function to quickly parse test arguments.
+
+    Parameters
+    ----------
+    args : list, optional
+        List of arguments to parse. If None, uses sys.argv.
+
+    Returns
+    -------
+    TestArguments
+        Parsed test arguments object.
+    """
+    parser = test_parser_init()
+    return parser.parse(args)