orionis 0.373.0__tar.gz → 0.375.0__tar.gz

{orionis-0.373.0/orionis.egg-info → orionis-0.375.0}/PKG-INFO

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

{orionis-0.373.0 → orionis-0.375.0}/orionis/container/facades/facade.py

@@ -1,10 +1,13 @@
 from typing import Any
-from orionis.container.container import Container
 from orionis.container.exceptions import OrionisContainerAttributeError, OrionisContainerException
+from orionis.foundation.application import Application
+from typing import TypeVar, Any
+
+T = TypeVar('T')
 
 class FacadeMeta(type):
 
-    def __getattr__(cls, name: str) -> Any:
+    def __getattr__(cls, name: str) -> T:
         """
         When an undefined attribute is accessed, this method resolves the service and delegates the call.
 
@@ -30,8 +33,8 @@ class FacadeMeta(type):
 
 class Facade(metaclass=FacadeMeta):
 
-    # Container instance to resolve services
-    _container = Container()
+    # Application instance to resolve services
+    _app = Application()
 
     @classmethod
     def getFacadeAccessor(cls) -> str:
@@ -79,13 +82,12 @@ class Facade(metaclass=FacadeMeta):
         service_name = cls.getFacadeAccessor()
 
         # Check if the service is bound in the container
-        if not cls._container.bound(service_name):
+        if not cls._app.bound(service_name):
             raise OrionisContainerException(
                 f"Service '{service_name}' not bound in the container. "
-                f"Please ensure '{service_name}' is registered in the container before using the {cls.__name__} facade. "
-                "You can register services in a service provider using the 'register' method."
+                f"Please ensure '{service_name}' is registered in the container before using the {cls.__name__} facade."
             )
 
         # Resolve the service instance from the container
-        service_instance = cls._container.make(service_name, *args, **kwargs)
+        service_instance = cls._app.make(service_name, *args, **kwargs)
         return service_instance

{orionis-0.373.0 → orionis-0.375.0}/orionis/metadata/framework.py

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

{orionis-0.373.0 → orionis-0.375.0}/orionis/test/arguments/parser.py

@@ -145,53 +145,43 @@ class TestArgumentParser(ITestArgumentParser):
 
     def parse(
         self,
-        args=None
+        sys_argv: list[str]
     ) -> TestArguments:
         """
-        Parse command line arguments and return TestArguments object.
+        Parse command line arguments from sys.argv and return TestArguments object.
 
         Parameters
         ----------
-        args : list, optional
-            List of arguments to parse. If None, uses sys.argv.
+        sys_argv : list[str]
+            Command line arguments including script name. The script name (first element)
+            will be automatically removed before parsing.
 
         Returns
         -------
         TestArguments
             Parsed test arguments object.
         """
-        return self.parser.parse_args(args)
+        # Remove script name from sys.argv (first element)
+        args_only = sys_argv[1:] if len(sys_argv) > 0 else []
+
+        # Parse arguments and convert to TestArguments object
+        parsed_args = self.parser.parse_args(args_only)
+
+        # Create TestArguments instance from parsed arguments
+        return TestArguments(
+            verbosity=parsed_args.verbosity,
+            mode=parsed_args.mode,
+            fail_fast=parsed_args.fail_fast,
+            print_result=parsed_args.print_result,
+            throw_exception=parsed_args.throw_exception,
+            persistent=parsed_args.persistent,
+            persistent_driver=parsed_args.persistent_driver,
+            web_report=parsed_args.web_report,
+            print_output_buffer=parsed_args.print_output_buffer
+        )
 
     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)
+        self.parser.print_help()

{orionis-0.373.0 → orionis-0.375.0}/orionis/test/contracts/kernel.py

@@ -61,6 +61,41 @@ class ITestKernel(ABC):
         """
         pass
 
+    @abstractmethod
+    def handleCLI(
+        self,
+        sys_argv: list[str]
+    ) -> UnitTest:
+        """
+        Process command line arguments for test execution.
+
+        This method configures and runs tests based on command line arguments. It parses
+        the provided sys_argv list into a TestArguments object, extracts configuration
+        values, executes the tests, and handles output generation.
+
+        Parameters
+        ----------
+        sys_argv : list[str]
+            Command line arguments list including script name. The script name
+            (first element) will be automatically removed before parsing.
+
+        Returns
+        -------
+        UnitTest
+            The test suite instance containing all test results.
+
+        Raises
+        ------
+        OrionisTestConfigException
+            If the provided sys_argv is not a valid list or if argument parsing fails.
+
+        Notes
+        -----
+        The method supports various test execution options including parallel/sequential
+        execution mode, fail fast behavior, result output configuration, and web reporting.
+        """
+        pass
+
     @abstractmethod
     def exit(
         self,

{orionis-0.373.0 → orionis-0.375.0}/orionis/test/contracts/parser.py

@@ -12,20 +12,26 @@ class ITestArgumentParser(ABC):
     @abstractmethod
     def parse(
         self,
-        args=None
+        sys_argv: list[str]
     ) -> TestArguments:
         """
         Parse command line arguments and return TestArguments object.
 
         Parameters
         ----------
-        args : list, optional
-            List of arguments to parse. If None, uses sys.argv.
+        sys_argv : list[str]
+            Command line arguments including script name. The script name (first element)
+            will be automatically removed before parsing.
 
         Returns
         -------
         TestArguments
-            Parsed test arguments object.
+            Parsed test arguments object containing all configuration options for test execution.
+
+        Raises
+        ------
+        SystemExit
+            If argument parsing fails or help is requested.
         """
         pass
 

{orionis-0.373.0 → orionis-0.375.0}/orionis/test/kernel.py

@@ -5,7 +5,10 @@ from os import walk
 from orionis.foundation.config.testing.entities.testing import Testing as Configuration
 from orionis.foundation.contracts.application import IApplication
 from orionis.test.contracts.kernel import ITestKernel
+from orionis.test.arguments.parser import TestArgumentParser
 from orionis.test.core.unit_test import UnitTest
+from orionis.test.entities.arguments import TestArguments
+from orionis.test.enums.execution_mode import ExecutionMode
 from orionis.test.exceptions import OrionisTestConfigException
 
 class TestKernel(ITestKernel):
@@ -227,6 +230,63 @@ class TestKernel(ITestKernel):
         # Return the test suite instance containing all results
         return tests
 
+    def handleCLI(
+        self,
+        sys_argv: list[str],
+    ) -> UnitTest:
+
+        """
+        Process command line arguments for test execution.
+        This method configures and runs tests based on command line arguments. It extracts
+        configuration from the provided TestArguments object, executes the tests, and
+        handles output generation.
+        Parameters
+        ----------
+        args : TestArguments
+            Command line arguments parsed into a TestArguments object.
+        base_path : str, optional
+            Base directory to search for test files, by default 'tests'.
+        folder_path : str, optional
+            Pattern for folder selection within base_path, by default '*'.
+        pattern : str, optional
+            Filename pattern for test files, by default 'test_*.py'.
+        Returns
+        -------
+        UnitTest
+            The test suite instance containing all test results.
+        Notes
+        -----
+        The method supports various test execution options including parallel/sequential
+        execution mode, fail fast behavior, and result output configuration.
+        """
+
+        # Validate the provided arguments
+        if not isinstance(sys_argv, list):
+            raise OrionisTestConfigException("The provided sys_argv must be a list of command line arguments.")
+
+        # Assign the provided arguments to a TestArguments instance
+        parser = TestArgumentParser()
+        args:TestArguments = parser.parse(sys_argv)
+
+        # Extract and validate the configuration from command line arguments
+        test = self.handle(
+            verbosity = int(args.verbosity),
+            execution_mode = ExecutionMode.PARALLEL if args.mode == 'parallel' else ExecutionMode.SEQUENTIAL,
+            fail_fast = bool(args.fail_fast),
+            print_result = bool(args.print_result),
+            throw_exception = bool(args.throw_exception),
+            persistent = bool(args.persistent),
+            persistent_driver = str(args.persistent_driver) if args.persistent_driver else None,
+            web_report = bool(args.web_report)
+        )
+
+        # If requested, print the output buffer
+        if args.print_output_buffer:
+            test.printOutputBuffer()
+
+        # Return the test suite instance containing all results
+        return test
+
     def exit(
         self,
         code: int = 0

{orionis-0.373.0 → orionis-0.375.0/orionis.egg-info}/PKG-INFO

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

{orionis-0.373.0 → orionis-0.375.0}/tests/example/test_example.py

@@ -6,7 +6,7 @@ class TestExample(SyncTestCase):
     Unit tests for basic example functionality.
     """
 
-    def testUnitExample(self, console: IConsole):
+    def testUnitExample(self):
         """
         Test that basic equality assertions work as expected.