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

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/metadata/framework.py

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

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/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/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/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.dist-info → orionis-0.374.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.373.0
+Version: 0.374.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.dist-info → orionis-0.374.0.dist-info}/RECORD

@@ -130,7 +130,7 @@ orionis/container/exceptions/exception.py,sha256=goTDEwC70xTMD2qppN8KV-xyR0Nps21
 orionis/container/exceptions/type.py,sha256=cYuvoXVOgRYj3tZPfK341aUERkf33-buOiI2eXxcrAw,470
 orionis/container/exceptions/value.py,sha256=hjY0YEusoL3DurME1ornxvIv1wyGaf6tBggLFlGHblo,472
 orionis/container/facades/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/facades/facade.py,sha256=22AMMDEqfUCIj2EsGTnjTKLsnLq3QhhqpV6mp4gfRzw,3229
+orionis/container/facades/facade.py,sha256=gVbZHu200hJleoQOTJ2NPBIwBL4TDxFTLDnQ_I2Jabs,3174
 orionis/container/providers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/providers/service_provider.py,sha256=9SHDzeuJbktRhrLq0zo2fZhRR4xOaYGOb2wKl7iBR4k,1923
 orionis/container/resolver/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -247,7 +247,7 @@ orionis/foundation/providers/path_resolver_provider.py,sha256=rXvaVc5sSqmDgRzWJo
 orionis/foundation/providers/progress_bar_provider.py,sha256=75Jr4iEgUOUGl8Di1DioeP5_HRQlR-1lVzPmS96sWjA,737
 orionis/foundation/providers/workers_provider.py,sha256=WWlji3C69_-Y0c42aZDbR_bmcE_qZEh2SaA_cNkCivI,702
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=n5P3VhS-24TttbJMjYiIuwCDr1uNzEs6BpL9YY3KjPo,4960
+orionis/metadata/framework.py,sha256=HMzmQvTOZ24-I-MI3Rsq9LZTjBgF1rFEUcyEoKBn6Y0,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -349,17 +349,17 @@ orionis/support/standard/exceptions/value.py,sha256=7xry_TZz3k-BLAZTR_uDiQ0RfXOk
 orionis/support/wrapper/__init__.py,sha256=jGoWoIGYuRYqMYQKlrX7Dpcbg-AGkHoB_aM2xhu73yc,62
 orionis/support/wrapper/dot_dict.py,sha256=VdAUH-DO6y86pl_9N6v-vU9mdLraWh5HjVzI5iC1dMs,5295
 orionis/test/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/kernel.py,sha256=eFBuctFaeRNXuK7MbWMIOs0Wsw2Kdi9yHaImkQJc2O4,10771
+orionis/test/kernel.py,sha256=_dzms3-5IuDNIE_JjaexwaoZhkHNvU-aAUEwOVtW8sc,13337
 orionis/test/arguments/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/arguments/parser.py,sha256=tbTouQ0X2Q_RKbYixzbj_eiEu5d5CcsrzJ4EU3IY0Xk,5810
+orionis/test/arguments/parser.py,sha256=Oz09NCbQ9JrJgviiPJ92WbRa54rXWCsr6RDzPoh05vE,6019
 orionis/test/cases/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/cases/asynchronous.py,sha256=0nOSpl8jMFZ7sshbL0pLZ5QSnhjn4cAK2ndDWzBdNik,4687
 orionis/test/cases/synchronous.py,sha256=8KOQnby7Zm_w_zxhcqroMQWt5KblbLgpI3rvKE3v-8w,3762
 orionis/test/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/contracts/dumper.py,sha256=5OqGc4GEXCXX76sCX185giQMyKwwZvlOv3I7tTwV2fQ,1324
-orionis/test/contracts/kernel.py,sha256=anUHpXZ5XDZs_vfHGDNv1nQpxD8iyQd2Eru7YdoDnVU,3593
+orionis/test/contracts/kernel.py,sha256=j4vx4KRhDrRI7hF95Scfpbso7-ltWPtvQOIFu9X-1Vs,4768
 orionis/test/contracts/logs.py,sha256=uqnTfq1TsaD31t0gc4WjHJP5wJXWFosRX6yqZ1HcBBQ,4409
-orionis/test/contracts/parser.py,sha256=Yn3vB3mZzv5A61fJe4bM8mUZnBSTLY4Qmjkm28SDJHc,975
+orionis/test/contracts/parser.py,sha256=njz9OJShDqw85mNdLSH4un9JQZC3qbtrKGKzApwrQJs,1240
 orionis/test/contracts/printer.py,sha256=FcTii6uglVIfvsgbmG0lj3hv1RGmDWuDo0eo4Z8rMbQ,6014
 orionis/test/contracts/render.py,sha256=0o6NjrKx2ewBf1JvAf8BaAtJQPb64yq1FJCeKb3iXys,967
 orionis/test/contracts/unit_test.py,sha256=pEceAVTJGb1ohEiiMD8X3YKT6xUsRECpB0ZO9K-RUWU,8383
@@ -385,7 +385,7 @@ orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hS
 orionis/test/records/logs.py,sha256=EOQcloMVdhlNl2lU9igQz8H4b-OtKtiwh2pgr_QZWOI,13186
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=zd7xDvVfmQ2HxZamDTzL2-z2PpyL99EaolbbM7wTah4,5014
-orionis-0.373.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.374.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/example/test_example.py,sha256=enE3spBo1Eue1nfKicIW4Za0u2CIvgQGKcn2K4QBnDU,693
@@ -486,8 +486,8 @@ tests/support/wrapper/test_services_wrapper_docdict.py,sha256=nTNrvJkMSPx_aopEQ9
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=fnH7hjumNSErAFGITJgq2LHxSzvPF2tdtmHL9kyAv-Y,4409
 tests/testing/test_testing_unit.py,sha256=d3CRGo6608fMzYcZKIKapjx_af2aigqWiKSiuK9euIY,7600
-orionis-0.373.0.dist-info/METADATA,sha256=m_b-wSvwskKTXgGTuNaNvbYHfIaN_QXBjV_IULpfbkU,4772
-orionis-0.373.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.373.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.373.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.373.0.dist-info/RECORD,,
+orionis-0.374.0.dist-info/METADATA,sha256=gzRoXGpLNU-9II5k3-WIUM1UZjUXvYFs9UjgKBsqpcQ,4772
+orionis-0.374.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.374.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.374.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.374.0.dist-info/RECORD,,