orionis 0.587.0__py3-none-any.whl → 0.589.0__py3-none-any.whl

orionis/test/kernel.py

@@ -2,7 +2,6 @@ from orionis.foundation.contracts.application import IApplication
 from orionis.services.log.contracts.log_service import ILogger
 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
 
 class TestKernel(ITestKernel):
@@ -12,94 +11,80 @@ class TestKernel(ITestKernel):
         app: IApplication
     ) -> None:
         """
-        Initialize the TestKernel with the provided application instance.
+        Initialize the TestKernel instance with the provided application.
 
-        This constructor sets up the test kernel by validating the application
-        instance and resolving required dependencies for testing operations.
+        This constructor validates the given application instance and sets up
+        the test kernel by resolving required dependencies for unit testing.
+        It ensures that the application parameter is of the correct type and
+        retrieves the unit test service from the application's dependency container.
 
         Parameters
         ----------
         app : IApplication
-            The application instance that provides dependency injection
-            and service resolution capabilities.
+            The application instance responsible for dependency injection and
+            service resolution.
 
         Raises
         ------
         OrionisTestConfigException
-            If the provided app parameter is not an instance of IApplication.
+            If the provided `app` parameter is not an instance of `IApplication`.
 
         Returns
         -------
         None
-            This is a constructor method and does not return a value.
+            This constructor does not return any value.
         """
-        # Validate that the provided app parameter is an IApplication instance
+
+        # Ensure the provided app is a valid IApplication instance
         if not isinstance(app, IApplication):
             raise OrionisTestConfigException(
                 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'))
+        # Store the application instance for later use
+        self.__app: IApplication = app
 
-        # Resolve the unit test service from the application container
+        # Retrieve the unit test service from the application container
         self.__unit_test: IUnitTest = app.make(IUnitTest)
 
-        # 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=app.path('tests'),                # Base 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
-        )
-
-        # Initialize the logger service for logging command execution details
-        self.__logger: ILogger = app.make(ILogger)
-
-    def handle(self) -> IUnitTest:
+    def handle(self) -> dict:
         """
-        Execute the unit test suite and handle any exceptions that occur during testing.
+        Executes the unit test suite and logs a summary of the results.
+
+        This method serves as the main entry point for running unit tests via the test kernel.
+        It invokes the unit test service, collects the results, and logs a detailed summary
+        including the number of tests, passed, failed, errors, skipped, total execution time,
+        and success rate. If no output is returned, no summary is logged.
 
-        This method serves as the main entry point for running tests through the test kernel.
-        It executes the unit test suite via the injected unit test service and provides
-        comprehensive error handling for both expected test failures and unexpected errors.
-        The method ensures graceful termination of the application in case of any failures.
+        Parameters
+        ----------
+        None
 
         Returns
         -------
-        IUnitTest
-            The unit test service instance after successful test execution. This allows
-            for potential chaining of operations or access to test results.
+        dict
+            A dictionary containing the test results summary with keys such as
+            'total_tests', 'passed', 'failed', 'errors', 'skipped', 'total_time',
+            'success_rate', and 'timestamp'. If no tests are run, returns None.
         """
 
-        # Log the start of test execution
-        ouput = self.__unit_test.run()
+        # Run the unit test suite and collect the output summary
+        output = self.__unit_test.run()
 
-        if ouput is not None:
+        # Only log detailed report if output is available
+        if output is not None:
+            # Extract report details from output dictionary
+            total_tests = output.get("total_tests", 0)
+            passed = output.get("passed", 0)
+            failed = output.get("failed", 0)
+            errors = output.get("errors", 0)
+            skipped = output.get("skipped", 0)
+            total_time = output.get("total_time", 0)
+            success_rate = output.get("success_rate", 0)
+            timestamp = output.get("timestamp", 0)
 
-            # Extract report details from output
-            total_tests = ouput.get("total_tests")
-            passed = ouput.get("passed")
-            failed = ouput.get("failed")
-            errors = ouput.get("errors")
-            skipped = ouput.get("skipped")
-            total_time = ouput.get("total_time")
-            success_rate = ouput.get("success_rate")
-            timestamp = ouput.get("timestamp")
+            # Resolve the logger service from the application container
+            self.__logger: ILogger = self.__app.make(ILogger)
 
             # Log test execution completion with detailed summary
             self.__logger.info(
@@ -109,5 +94,5 @@ class TestKernel(ITestKernel):
                 f"Time: {total_time:.2f}s, Success rate: {success_rate:.2f}%"
             )
 
-        # Report the test results to the console
-        return ouput
+        # Return the test results summary dictionary (or None if no output)
+        return output

orionis/test/validators/__init__.py

@@ -8,7 +8,6 @@ from .pattern import ValidPattern
 from .persistent_driver import ValidPersistentDriver
 from .persistent import ValidPersistent
 from .print_result import ValidPrintResult
-from .tags import ValidTags
 from .throw_exception import ValidThrowException
 from .verbosity import ValidVerbosity
 from .web_report import ValidWebReport
@@ -25,7 +24,6 @@ __all__ = [
     'ValidPersistentDriver',
     'ValidPersistent',
     'ValidPrintResult',
-    'ValidTags',
     'ValidThrowException',
     'ValidVerbosity',
     'ValidWebReport',

{orionis-0.587.0.dist-info → orionis-0.589.0.dist-info}/METADATA

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

{orionis-0.587.0.dist-info → orionis-0.589.0.dist-info}/RECORD

@@ -103,7 +103,7 @@ orionis/failure/contracts/handler.py,sha256=AeJfkJfD3hTkOIYAtADq6GnQfq-qWgDfUc7b
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=1zD-awcuAyEtlR-L7V7ZIfPSF4GpXkf-neL5sXul7dc,1240
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=dXij7Rr49gESNtmTsnD6AikCF_z0Bio6Py9B7XVo1uY,80821
+orionis/foundation/application.py,sha256=_pws-r2QSTTvIonmt9bEBUwOpDvPQkAMNi3IsUpNY8E,82664
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=btqvryeIf9lLNQ9fBff7bJMrfraEY8qrWi4y_5YAR0Q,9681
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -191,13 +191,13 @@ orionis/foundation/config/session/helpers/__init__.py,sha256=47DEQpj8HBSa-_TImW-
 orionis/foundation/config/session/helpers/secret_key.py,sha256=yafjzQ9KVQdXzCQCMthpgizlNCo5F5UTLtAnInipUMk,447
 orionis/foundation/config/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/testing/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/config/testing/entities/testing.py,sha256=N4BXbd5XWc2-_Rjj8fcLe73QV-JD3dDkdaJJ9a72RkM,13165
+orionis/foundation/config/testing/entities/testing.py,sha256=bXT1VMXvZQc2rs2x0s3PNVuHSaoDYLBUq7LfK1BcZYs,12204
 orionis/foundation/config/testing/enums/__init__.py,sha256=aFh5kBxlh5kqHK-9W7qgdykF5-qou5SVRzorRBazqYw,196
 orionis/foundation/config/testing/enums/drivers.py,sha256=mwv47FcKDXEOxydQXAGtkdIY9S6qCAW1cD22oCFy3xw,355
 orionis/foundation/config/testing/enums/mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/foundation/config/testing/enums/verbosity.py,sha256=Z-FQ6C3rxbRwP8HoVibbgRMGcsen2SwTuEy3wnjdIhc,486
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/contracts/application.py,sha256=WKJmbPjCpeGN1cs7IsUcW0zHS_IJNs8H2jvBEWuwdS4,45808
+orionis/foundation/contracts/application.py,sha256=rtvnjAHbPh3fBb7seZWiAc9zF2pxg3w36Q33_keAOcg,46832
 orionis/foundation/contracts/config.py,sha256=mCyA43f0n_e-CEL0f-sWWgE-M7GicS_aEtC_TNbn_yc,802
 orionis/foundation/exceptions/__init__.py,sha256=ufomZK6am2-QAaj9peXW549xy_qflcbwj0ECuZz-1Kc,263
 orionis/foundation/exceptions/application.py,sha256=mr2lVimUEwdYBYQP4PNdVtJ-E39XjPCJXyI-8SRCqtI,205
@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=irwkjMiq-HpsbJxAOnhjji
 orionis/foundation/providers/testing_provider.py,sha256=2akFnabtH_cV_7z_2cCL7u8cPCGvCJAmlhMcnlCrc4c,3742
 orionis/foundation/providers/workers_provider.py,sha256=P_YtJuPNrdJAQJkAqI11KI0c6GSB9NqIuuCKpRytE0g,3937
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=qcJ8jxWsQbSmNp14qxgK_FnyryQUlLRRUXiL-hhvvu4,4109
+orionis/metadata/framework.py,sha256=txjk_25DYSonM4bVEfG0F3hPxtu46pq9X86ix4aIOyQ,4109
 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
@@ -359,7 +359,7 @@ orionis/support/standard/exceptions/standard.py,sha256=BM0VHLRYD7SzoMJkaA7BxY528
 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=4IXZ1WvSsf_CnHKq_IrEAybFQDJ005KwdPpe6yCNoX4,5254
+orionis/test/kernel.py,sha256=6yvS0vQBuZ5M2wH2DzTMSRA-judzCK1fnnzkmLfw49w,3970
 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
@@ -370,9 +370,9 @@ 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=getqaBoadQT_wh_V6aTQvm0yx9IgbVrE9EEOD8b031g,8031
+orionis/test/contracts/unit_test.py,sha256=hOuMgm1JVk3ERLrpMnDhShMWCJCJBdgOsY-U6kPaO0k,2335
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=PcYkIAN8ZgBb1JnuPDMPZHUFB3T7kiy5e8LvwhXUVF0,66094
+orionis/test/core/unit_test.py,sha256=mge6EZvfSeZKxSGo6k0-5putfvEByRF-IDAFx-9aSNY,64908
 orionis/test/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/entities/result.py,sha256=eZ6UIqGmFW8FZ9x8PB_MZbLAc-SAuUyi4FUcMYIZzGo,4777
 orionis/test/enums/__init__.py,sha256=M3imAgMvKFTKg55FbtVoY3zxj7QRY9AfaUWxiSZVvn4,66
@@ -388,7 +388,7 @@ orionis/test/output/dumper.py,sha256=qJDyVvl3MO0Uinr6z9TYYdDTqHNwwM0PcoDNNkTpAnA
 orionis/test/output/printer.py,sha256=Ho8jyhnJsvnJ5zdHbXyvY29kDa1zp4FsCswjt9XSeJ4,23903
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/records/logs.py,sha256=7XIdzDmQpb2HLUoAUWVj8UKiQDOnCkLD7ttro-Lv5UY,14223
-orionis/test/validators/__init__.py,sha256=RpuZFsrmxzLjRERyJ2fcZIQ27xuq2DedDlao2zmFE_U,991
+orionis/test/validators/__init__.py,sha256=2e862DM9aRnPajv2nxMujewe9dZ-1PyCamJKDcF-hGc,944
 orionis/test/validators/base_path.py,sha256=wAn5_HG0vQ5GH7wDKriO33Ijl1L1F3882BH67oraJnQ,1477
 orionis/test/validators/execution_mode.py,sha256=YnrQlnIaoPtM0xjW7jJ2170m1aHwAPPIZBjSVe9g2QM,1693
 orionis/test/validators/fail_fast.py,sha256=Z54GSQ2KxYeLy2gZwo51sYYMXH-6mj1w09okhI1MWOQ,850
@@ -399,7 +399,6 @@ orionis/test/validators/pattern.py,sha256=NYc_qsjd0Y1J0tmioW7nmlBVowbzkhGA17e4Ad
 orionis/test/validators/persistent.py,sha256=8y6rkseAG4yobbw9AFvVjKlMl2HL_w5i6rH9LNNYZAU,851
 orionis/test/validators/persistent_driver.py,sha256=9t832vIZyBAdIyKn-nZ-_nKs0Oxf2uvmR7K9ncWdRpw,1545
 orionis/test/validators/print_result.py,sha256=heUVid49clGfk9-glzVX5NGz69bKqMr0yx2dJnG9rD4,902
-orionis/test/validators/tags.py,sha256=Qv-p8XFyAjY7OI861s52eADGf3LqzOWYfKt4L1cpo4Q,1118
 orionis/test/validators/throw_exception.py,sha256=PLtM94BArQf11VJhxfBHJSHARZSia-Q8ePixctU2JwQ,893
 orionis/test/validators/verbosity.py,sha256=rADzM82cPcJ2_6crszpobJuwb5WihWNQf6i4M_yrCpw,1785
 orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNusHqc02R8,853
@@ -407,8 +406,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=1FJHFBRHbwI5FV90F9-cMUmT10xrA5tc2bY1ysTzD-8,4094
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.587.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.587.0.dist-info/METADATA,sha256=CPf_MW5xRqv5XSDB60fd1FfPsNgBlreqeJQKrUPw16k,4801
-orionis-0.587.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.587.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.587.0.dist-info/RECORD,,
+orionis-0.589.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.589.0.dist-info/METADATA,sha256=1tRDA0nH_HAgPvPbBNK0ZywbkcihrZRHkLU-pxDRHPE,4801
+orionis-0.589.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.589.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.589.0.dist-info/RECORD,,

orionis/test/validators/tags.py

@@ -1,36 +0,0 @@
-from orionis.test.exceptions import OrionisTestValueError
-
-class __ValidTags:
-
-    def __call__(self, tags):
-        """
-        Validates that the input is a non-empty list of non-empty strings.
-
-        Parameters
-        ----------
-        tags : Any
-            The value to validate as a list of non-empty strings.
-
-        Returns
-        -------
-        list or None
-            The validated and stripped list of tags if valid, otherwise None if input is None.
-
-        Raises
-        ------
-        OrionisTestValueError
-            If the input is not a non-empty list of non-empty strings.
-        """
-        if tags is not None:
-
-            if (not isinstance(tags, list) or not tags or not all(isinstance(tag, str) and tag.strip() for tag in tags)):
-                raise OrionisTestValueError(
-                    f"Invalid tags: Expected a non-empty list of non-empty strings, got '{tags}' ({type(tags).__name__})."
-                )
-
-            return [str(tag).strip() for tag in tags]
-
-        return None
-
-# Exported singleton instance
-ValidTags = __ValidTags()