orionis 0.293.0__py3-none-any.whl → 0.295.0__py3-none-any.whl

orionis/foundation/config/testing/entities/testing.py

@@ -145,6 +145,15 @@ class Testing:
         }
     )
 
+    web_report: bool = field(
+        default=False,
+        metadata={
+            "description": "Whether to generate a web report for the test results. Default is False.",
+            "required": True,
+            "default": False
+        }
+    )
+
     def __post_init__(self):
         """
         Post-initialization validation for the testing configuration entity.
@@ -245,14 +254,19 @@ class Testing:
                 f"Invalid type for 'persistent': {type(self.persistent).__name__}. It must be a boolean (True or False)."
             )
 
-        if not isinstance(self.persistent_driver, str):
-            raise OrionisIntegrityException(
-                f"Invalid type for 'persistent_driver': {type(self.persistent_driver).__name__}. It must be a string."
-            )
+        if self.persistent:
+            if not isinstance(self.persistent_driver, str):
+                raise OrionisIntegrityException(
+                    f"Invalid type for 'persistent_driver': {type(self.persistent_driver).__name__}. It must be a string."
+                )
+            if self.persistent_driver not in ['sqlite', 'json']:
+                raise OrionisIntegrityException(
+                    f"Invalid value for 'persistent_driver': {self.persistent_driver}. It must be one of: ['sqlite', 'json']."
+                )
 
-        if self.persistent_driver not in ['sqlite', 'json']:
+        if not isinstance(self.web_report, bool):
             raise OrionisIntegrityException(
-                f"Invalid value for 'persistent_driver': {self.persistent_driver}. It must be one of: ['sqlite', 'json']."
+                f"Invalid type for 'web_report': {type(self.web_report).__name__}. It must be a boolean (True or False)."
             )
 
     def toDict(self) -> dict:

orionis/metadata/framework.py

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

orionis/test/suites/test_suite.py

@@ -80,6 +80,7 @@ class TestSuite(ITestSuite):
             throw_exception=config.throw_exception,
             persistent=config.persistent,
             persistent_driver=config.persistent_driver,
+            web_report=config.web_report
         )
 
         # Extract configuration values

orionis/test/suites/test_unit.py

@@ -16,17 +16,17 @@ from rich.live import Live
 from rich.panel import Panel
 from rich.syntax import Syntax
 from rich.table import Table
+from rich.text import Text
 from orionis.console.output.console import Console
 from orionis.test.entities.test_result import TestResult
 from orionis.test.enums.test_mode import ExecutionMode
 from orionis.test.enums.test_status import TestStatus
-from orionis.test.exceptions.test_persistence_error import OrionisTestPersistenceError
 from orionis.test.exceptions.test_failure_exception import OrionisTestFailureException
+from orionis.test.exceptions.test_persistence_error import OrionisTestPersistenceError
 from orionis.test.exceptions.test_value_error import OrionisTestValueError
 from orionis.test.logs.history import TestHistory
 from orionis.test.suites.contracts.test_unit import IUnitTest
 from orionis.test.view.render import TestingResultRender
-from rich.text import Text
 
 class UnitTest(IUnitTest):
     """
@@ -131,7 +131,9 @@ class UnitTest(IUnitTest):
         self.throw_exception: bool = False
         self.persistent: bool = False
         self.persistent_driver: str = 'sqlite'
+        self.web_report: bool = False
         self.base_path: str = "tests"
+        self.withliveconsole: bool = True
 
     def configure(
             self,
@@ -142,7 +144,8 @@ class UnitTest(IUnitTest):
             print_result: bool = None,
             throw_exception: bool = False,
             persistent: bool = False,
-            persistent_driver: str = 'sqlite'
+            persistent_driver: str = 'sqlite',
+            web_report: bool = False
         ) -> 'UnitTest':
         """
         Configures the UnitTest instance with the specified parameters.
@@ -197,6 +200,9 @@ class UnitTest(IUnitTest):
         if persistent_driver is not None:
             self.persistent_driver = persistent_driver
 
+        if web_report is not None:
+            self.web_report = web_report
+
         return self
 
     def discoverTestsInFolder(
@@ -387,17 +393,27 @@ class UnitTest(IUnitTest):
         OrionisTestFailureException
             If `throw_exception` is True and there are test failures or errors.
         """
+
+        # Check if required print_result and throw_exception
         if print_result is not None:
             self.print_result = print_result
         if throw_exception is not None:
             self.throw_exception = throw_exception
 
+        # Dynamically determine if live console should be enabled based on test code usage
+        self._withLiveConsole()
+
+        # Start the timer and print the start message
         self.start_time = time.time()
         self._startMessage()
 
-        # Elegant "running" message using Rich Panel
+        # Prepare the running message based on whether live console is enabled
+        message = "[bold yellow]⏳ Running tests...[/bold yellow]\n"
+        message += "[dim]This may take a few seconds. Please wait...[/dim]" if self.withliveconsole else "[dim]Please wait, results will appear below...[/dim]"
+
+        # Panel for running message
         running_panel = Panel(
-            "[bold yellow]⏳ Running tests...[/bold yellow]\n[dim]This may take a few seconds. Please wait...[/dim]",
+            message,
             border_style="yellow",
             title="In Progress",
             title_align="left",
@@ -405,18 +421,18 @@ class UnitTest(IUnitTest):
             padding=(1, 2)
         )
 
-        # Print the panel and keep a reference to the live display
-        with Live(running_panel, console=self.rich_console, refresh_per_second=4, transient=True):
-
-            # Setup output capture
-            output_buffer = io.StringIO()
-            error_buffer = io.StringIO()
+        # Elegant "running" message using Rich Panel
+        if self.withliveconsole:
+            with Live(running_panel, console=self.rich_console, refresh_per_second=4, transient=True):
+                result, output_buffer, error_buffer = self._runSuite()
+        else:
+            self.rich_console.print(running_panel)
+            result, output_buffer, error_buffer = self._runSuite()
 
-            # Execute tests based on selected mode
-            if self.execution_mode == ExecutionMode.PARALLEL.value:
-                result = self._runTestsInParallel(output_buffer, error_buffer)
-            else:
-                result = self._runTestsSequentially(output_buffer, error_buffer)
+        # Capture and display the output and error buffers only if not empty
+        output_content = output_buffer.getvalue()
+        if output_content.strip():
+            print(output_buffer.getvalue())
 
         # Process results
         execution_time = time.time() - self.start_time
@@ -433,6 +449,80 @@ class UnitTest(IUnitTest):
         # Return the summary of the test results
         return summary
 
+    def _withLiveConsole(self) -> None:
+        """
+        Determines if the live console should be used based on the presence of debug or dump calls in the test code.
+
+        Returns
+        -------
+        bool
+            True if the live console should be used, False otherwise.
+        """
+        if self.withliveconsole:
+
+            try:
+
+                # Flatten the test suite to get all test cases
+                for test_case in self._flattenTestSuite(self.suite):
+
+                    # Get the source code of the test case class
+                    source = inspect.getsource(test_case.__class__)
+
+                    # Only match if the keyword is not inside a comment
+                    for keyword in ('self.dd', 'self.dump'):
+
+                        # Find all lines containing the keyword
+                        for line in source.splitlines():
+                            if keyword in line:
+
+                                # Remove leading/trailing whitespace
+                                stripped = line.strip()
+
+                                # Ignore lines that start with '#' (comments)
+                                if not stripped.startswith('#') and not re.match(r'^\s*#', line):
+                                    self.withliveconsole = False
+                                    break
+
+                        # If we found a keyword, no need to check further
+                        if not self.withliveconsole:
+                            break
+
+                    # If we found a keyword in any test case, no need to check further
+                    if not self.withliveconsole:
+                        break
+
+            except Exception:
+                pass
+
+    def _runSuite(self):
+        """
+        Run the test suite according to the selected execution mode (parallel or sequential),
+        capturing standard output and error streams during execution.
+
+        Returns
+        -------
+        tuple
+            result : unittest.TestResult
+            The result object from the test execution.
+            output_buffer : io.StringIO
+            Captured standard output during test execution.
+            error_buffer : io.StringIO
+            Captured standard error during test execution.
+        """
+
+        # Setup output capture
+        output_buffer = io.StringIO()
+        error_buffer = io.StringIO()
+
+        # Execute tests based on selected mode
+        if self.execution_mode == ExecutionMode.PARALLEL.value:
+            result = self._runTestsInParallel(output_buffer, error_buffer)
+        else:
+            result = self._runTestsSequentially(output_buffer, error_buffer)
+
+        # Return the result along with captured output and error streams
+        return result, output_buffer, error_buffer
+
     def _runTestsSequentially(self, output_buffer: io.StringIO, error_buffer: io.StringIO) -> unittest.TestResult:
         """
         Executes the test suite sequentially, capturing the output and error streams.
@@ -760,13 +850,16 @@ class UnitTest(IUnitTest):
             self._persistTestResults(report)
 
         # Handle Web Report Rendering
-        path = self._webReport(report)
+        if self.web_report:
+
+            # Generate the web report and get the path
+            path = self._webReport(report)
 
-        # Elegant invitation to view the results, with underlined path
-        invite_text = Text("Test results saved. ", style="green")
-        invite_text.append("View report: ", style="bold green")
-        invite_text.append(str(path), style="underline blue")
-        self.rich_console.print(invite_text)
+            # Elegant invitation to view the results, with underlined path
+            invite_text = Text("Test results saved. ", style="green")
+            invite_text.append("View report: ", style="bold green")
+            invite_text.append(str(path), style="underline blue")
+            self.rich_console.print(invite_text)
 
         # Return the summary
         return {

{orionis-0.293.0.dist-info → orionis-0.295.0.dist-info}/METADATA

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

{orionis-0.293.0.dist-info → orionis-0.295.0.dist-info}/RECORD

@@ -222,11 +222,11 @@ orionis/foundation/config/session/enums/same_site_policy.py,sha256=Oo05CJ-5keJWz
 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=m_i9jZlOXs_AzNKNNf0a3ByS7jDGaRz_2FO1ScV577Q,11293
+orionis/foundation/config/testing/entities/testing.py,sha256=AuhPU9O15Aeqs8jQVHWJwamgrrcvmC4ThsJ31jyrWic,11849
 orionis/foundation/config/testing/enums/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/testing/enums/test_mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=QmC-g5i6UhTE0QWIF78bMyfW6Dm4d4521_PuYknYoGQ,4960
+orionis/metadata/framework.py,sha256=klmDRFqvLc8HnxhUeqOIpWsQhC1a4vZm3oDq2LUAxQs,4960
 orionis/metadata/package.py,sha256=tqLfBRo-w1j_GN4xvzUNFyweWYFS-qhSgAEc-AmCH1M,5452
 orionis/patterns/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/patterns/singleton/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -344,14 +344,14 @@ orionis/test/output/dumper.py,sha256=y-6du3n1IU2Cd2MFbMuEiLcpMqEOqENkuAXwMMhcsEI
 orionis/test/output/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/output/contracts/dumper.py,sha256=5OqGc4GEXCXX76sCX185giQMyKwwZvlOv3I7tTwV2fQ,1324
 orionis/test/suites/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/suites/test_suite.py,sha256=fdVmC56PJfWDuYeekY7oN-04AEHMqxwLI5mZNJAuOZI,5261
-orionis/test/suites/test_unit.py,sha256=JAla82Uc2OEvvBTE8oI8BT0hxeb03FJB1bdKU7G2xlA,51293
+orionis/test/suites/test_suite.py,sha256=nJhToYdvHFETSNqunk-_i6Pe716842eaFKDBhChjigA,5303
+orionis/test/suites/test_unit.py,sha256=dnLEEeBnGkE7DRM2XXJPtxHw25JLzP9ZtcGImmBNBM4,54916
 orionis/test/suites/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/suites/contracts/test_suite.py,sha256=eluzYwkNBbKjxYStj_tHN_Fm3YDPpGQdqMu5eiluh-E,1059
 orionis/test/suites/contracts/test_unit.py,sha256=l1LQllODyvcSByXMl1lGrUkoLsXbBHZZLWZI4A-mlQg,5881
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=jXZkbITBknbUwm_mD8bcTiwLDvsFkrO9qrf0ZgPwqxc,4903
-orionis-0.293.0.dist-info/licenses/LICENCE,sha256=-_4cF2EBKuYVS_SQpy1uapq0oJPUU1vl_RUWSy2jJTo,1111
+orionis-0.295.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=byd_lI6tVDgGPEIrr7PLZbBu0UoZOymmdmyA_4u-QUw,601
@@ -455,8 +455,8 @@ tests/support/inspection/fakes/fake_reflection_instance_with_abstract.py,sha256=
 tests/testing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/test_testing_result.py,sha256=MrGK3ZimedL0b5Ydu69Dg8Iul017AzLTm7VPxpXlpfU,4315
 tests/testing/test_testing_unit.py,sha256=A6QkiOkP7GPC1Szh_GqsrV7GxjWjK8cIwFez6YfrzmM,7683
-orionis-0.293.0.dist-info/METADATA,sha256=VYamMjDShBXxI6Quu-380uo1bp772T2nDaTlWcmJdwI,4772
-orionis-0.293.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
-orionis-0.293.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.293.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.293.0.dist-info/RECORD,,
+orionis-0.295.0.dist-info/METADATA,sha256=fPQLKOQTJqwhW2rscOTMOoRqQjcIAfMW3fKU2w1e5Wc,4772
+orionis-0.295.0.dist-info/WHEEL,sha256=Nw36Djuh_5VDukK0H78QzOX-_FQEo6V37m3nkm96gtU,91
+orionis-0.295.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.295.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.295.0.dist-info/RECORD,,