orionis 0.592.0__py3-none-any.whl → 0.593.0__py3-none-any.whl

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

@@ -19,8 +19,6 @@ class Testing(BaseEntity):
         Maximum number of worker threads/processes for parallel execution (default: calculated by Workers).
     fail_fast : bool, optional
         If True, stop execution after the first test failure (default: False).
-    print_result : bool, optional
-        If True, print test results to the console (default: True).
     throw_exception : bool, optional
         If True, raise an exception on test failure (default: False).
     base_path : str, optional
@@ -75,14 +73,6 @@ class Testing(BaseEntity):
         }
     )
 
-    print_result: bool = field(
-        default = True,
-        metadata = {
-            "description": "Whether to print the test results to the console. Default is True.",
-            "default": True
-        }
-    )
-
     throw_exception: bool = field(
         default = False,
         metadata = {
@@ -206,12 +196,6 @@ class Testing(BaseEntity):
                 f"Invalid type for 'fail_fast': {type(self.fail_fast).__name__}. It must be a boolean (True or False)."
             )
 
-        # Validate print_result attribute
-        if not isinstance(self.print_result, bool):
-            raise OrionisIntegrityException(
-                f"Invalid type for 'print_result': {type(self.print_result).__name__}. It must be a boolean (True or False)."
-            )
-
         # Validate throw_exception attribute
         if not isinstance(self.throw_exception, bool):
             raise OrionisIntegrityException(

orionis/metadata/framework.py

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

orionis/test/core/unit_test.py

@@ -1,5 +1,6 @@
 import io
 import json
+import logging
 import os
 import re
 import time
@@ -34,7 +35,6 @@ from orionis.test.validators import (
     ValidPattern,
     ValidPersistentDriver,
     ValidPersistent,
-    ValidPrintResult,
     ValidThrowException,
     ValidVerbosity,
     ValidWebReport,
@@ -96,6 +96,9 @@ class UnitTest(IUnitTest):
         - Output buffers, paths, configuration, modules, and tests are loaded in sequence to prepare the test manager.
         """
 
+        # Suppress overly verbose asyncio logging during test execution
+        logging.getLogger("asyncio").setLevel(logging.ERROR)
+
         # Store the application instance for dependency injection and configuration access
         self.__app: IApplication = app
 
@@ -233,7 +236,7 @@ class UnitTest(IUnitTest):
 
         # Initialize the printer for console output
         self.__printer = TestPrinter(
-            print_result = ValidPrintResult(config.print_result)
+            verbosity=self.__verbosity
         )
 
         # Set the file name pattern for test discovery

orionis/test/output/printer.py

@@ -1,15 +1,15 @@
-import io
 import re
 from datetime import datetime
-from typing import Any, Dict, List, Tuple
 import unittest
+from typing import Any, Dict, List
 from rich.console import Console
 from rich.live import Live
 from rich.panel import Panel
+from rich.progress import Progress, BarColumn, TextColumn, TaskProgressColumn
 from rich.syntax import Syntax
 from rich.table import Table
-from rich.progress import Progress, BarColumn, TextColumn, TaskProgressColumn
 from rich.text import Text
+from orionis.foundation.config.testing.enums.verbosity import VerbosityMode
 from orionis.test.contracts.printer import ITestPrinter
 from orionis.test.entities.result import TestResult
 from orionis.test.enums import TestStatus
@@ -18,37 +18,58 @@ class TestPrinter(ITestPrinter):
 
     def __init__(
         self,
-        print_result: bool = True,
+        verbosity: VerbosityMode | int = VerbosityMode.DETAILED,
         title: str = "🧪 Orionis Framework - Component Test Suite",
         width: int = 75
     ) -> None:
         """
-        Initialize a TestPrinter instance for formatted test output.
+        Initializes a TestPrinter instance for formatted test output using the Rich library.
 
         Parameters
         ----------
         print_result : bool, optional
-            Whether to print test results to the console (default is True).
+            If True, enables printing of test results to the console. If False, suppresses all output.
+        verbosity : VerbosityMode or int, optional
+            Specifies the verbosity level for output. Accepts either a VerbosityMode enum or an integer value.
+            Default is VerbosityMode.DETAILED.
         title : str, optional
-            The title to display in the output panel (default is "🧪 Orionis Framework - Component Test Suite").
+            The title displayed in the output panel. Default is "🧪 Orionis Framework - Component Test Suite".
         width : int, optional
-            The width of the output panel as a percentage of the console width (default is 75).
+            The width of the output panel as a percentage of the console width. Must be between 10 and 100.
+            Default is 75.
 
         Returns
         -------
         None
+            This constructor does not return any value. It initializes the TestPrinter instance.
+
+        Raises
+        ------
+        ValueError
+            If any of the input parameters are of invalid type or out of allowed range.
+
+        Notes
+        -----
+        - The Rich Console instance is created for rendering output.
+        - The verbosity level, panel width, panel title, and print_result flag are validated and set.
         """
         # Create a Rich Console instance for output rendering
         self.__rich_console = Console()
 
-        # Set the panel title for display
-        self.__panel_title: str = title
+        # Validate and set verbosity level
+        if not isinstance(verbosity, (int, VerbosityMode)):
+            raise ValueError("The 'verbosity' parameter must be an integer or VerbosityMode enum.")
+        self.__verbosity: int = verbosity if isinstance(verbosity, int) else verbosity.value
 
-        # Calculate the panel width as a percentage of the console width
+        # Validate and set panel width (must be between 10% and 100% of console width)
+        if not isinstance(width, int) or not (10 <= width <= 100):
+            raise ValueError("The 'width' parameter must be an integer between 10 and 100.")
         self.__panel_width: int = int(self.__rich_console.width * (width / 100))
 
-        # Store the flag indicating whether to print results
-        self.__print_result: bool = print_result
+        # Validate and set panel title
+        if not isinstance(title, str):
+            raise ValueError("The 'title' parameter must be a string.")
+        self.__panel_title: str = title
 
     def print(
         self,
@@ -76,7 +97,7 @@ class TestPrinter(ITestPrinter):
         """
 
         # If printing results is disabled, do not output anything
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Print string values directly
@@ -114,7 +135,7 @@ class TestPrinter(ITestPrinter):
         """
 
         # If printing results is disabled, do not output anything
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Print the specified number of blank lines
@@ -139,7 +160,7 @@ class TestPrinter(ITestPrinter):
         - The message is displayed in a Rich panel with a yellow border and centered title.
         """
         # If printing results is disabled, do not output anything
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Print a styled panel to indicate that no tests were found
@@ -189,7 +210,7 @@ class TestPrinter(ITestPrinter):
         """
 
         # If printing results is disabled, do not output anything
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Format the execution mode text for display
@@ -245,14 +266,17 @@ class TestPrinter(ITestPrinter):
         - The progress bar is suitable for tracking the progress of tasks such as test execution.
         """
 
+        # Flag to disable the progress bar if printing is off or verbosity is silent/minimal
+        disable = self.__verbosity <= VerbosityMode.MINIMAL.value
+
         # Create and return a Rich Progress bar instance with custom columns and settings
         return Progress(
-            TextColumn("[cyan]{task.description}"),  # Task description in cyan
-            BarColumn(),                             # Visual progress bar
-            TaskProgressColumn(),                    # Percentage completion indicator
-            console=self.__rich_console,             # Output to the configured Rich console
-            transient=True,                          # Remove the bar after completion
-            disable=not self.__print_result          # Disable if printing is turned off
+            TextColumn("[cyan]{task.description}"),     # Task description in cyan
+            BarColumn(),                                # Visual progress bar
+            TaskProgressColumn(),                       # Percentage completion indicator
+            console=self.__rich_console,                # Output to the configured Rich console
+            transient=True,                             # Remove the bar after completion
+            disable=disable                             # Disable if printing is off
         )
 
     def finishMessage(
@@ -276,7 +300,7 @@ class TestPrinter(ITestPrinter):
         None
         """
         # If not printing results, return early
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Determine status icon based on failures and errors
@@ -335,7 +359,7 @@ class TestPrinter(ITestPrinter):
             raise ValueError("The 'func' parameter must be a callable (function or method).")
 
         # Only display output if printing results is enabled
-        if self.__print_result:
+        if self.__verbosity != VerbosityMode.SILENT.value:
 
             # If live_console is True, use a live panel for dynamic updates
             if live_console:
@@ -366,6 +390,7 @@ class TestPrinter(ITestPrinter):
                 return func()
 
         else:
+
             # If result printing is disabled, execute the callable without any panel
             return func()
 
@@ -386,7 +411,7 @@ class TestPrinter(ITestPrinter):
         None
         """
         # If not printing results, do not display the link
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Create the base invitation text with a green style
@@ -425,7 +450,7 @@ class TestPrinter(ITestPrinter):
         None
         """
         # If result printing is disabled, do not display the summary table
-        if self.__print_result is False:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Create a Rich Table with headers and styling
@@ -482,7 +507,7 @@ class TestPrinter(ITestPrinter):
         None
         """
         # If result printing is disabled, do not display results
-        if not self.__print_result:
+        if self.__verbosity == VerbosityMode.SILENT.value:
             return
 
         # Print one blank line before the summary
@@ -491,18 +516,17 @@ class TestPrinter(ITestPrinter):
         # Print the summary table of test results
         self.summaryTable(summary)
 
-        # Print failed and errored tests
+        # Get the list of individual test results
         test_details: List[Dict] = summary.get("test_details", [])
+
+        # Iterate through each test result to display failures and errors
         for test in test_details:
 
             # If there are no failures or errors, skip to the next test
             if test["status"] in (TestStatus.FAILED.name, TestStatus.ERRORED.name):
 
                 # Determine the status icon based on the test status
-                if test["status"] == TestStatus.FAILED.name:
-                    status_icon = "❌ FAILED: "
-                else:
-                    status_icon = "💥 ERRORED: "
+                status_icon = "❌ FAILED:" if test["status"] == TestStatus.FAILED.name else "💥 ERRORED:"
 
                 # Print separator line before each test result with class name and method name
                 self.__rich_console.rule(title=f'🧪 {test["class"]}.{test["method"]}()', align="left")
@@ -516,7 +540,6 @@ class TestPrinter(ITestPrinter):
                     _file = last_trace_frame.get('file')
                     _line = last_trace_frame.get('line')
                     _code = last_trace_frame.get('code')
-                    _function = last_trace_frame.get('function')
 
                     # Print the file and line number if available
                     text = Text("📂 ")
@@ -524,43 +547,48 @@ class TestPrinter(ITestPrinter):
                     self.__rich_console.print(text)
 
                     # Print the error message with better formatting
-                    text = Text(status_icon, style="red")
+                    text = Text(f"{status_icon} ", style="red")
                     error_msg = test["error_message"] if test["error_message"] else "Unknown error"
                     text.append(error_msg, style="yellow")
                     self.__rich_console.print(text)
 
-                    # Print the code context (1 line before and 2 lines after the error)
-                    try:
-
-                        # Open the file and read its lines
-                        with open(_file, 'r', encoding='utf-8') as f:
-                            file_lines = f.readlines()
-
-                        # Convert to 0-based index
-                        error_line_num = int(_line) - 1
-                        start_line = max(0, error_line_num - 1)
-                        end_line = min(len(file_lines), error_line_num + 3)
-
-                        # Create a code block with syntax highlighting
-                        code_lines = []
-                        for i in range(start_line, end_line):
-                            line_num = i + 1
-                            line_content = file_lines[i].rstrip()
-                            if line_num == int(_line):
-                                # Highlight the error line
-                                code_lines.append(f"* {line_num:3d} | {line_content}")
-                            else:
-                                code_lines.append(f"  {line_num:3d} | {line_content}")
-
-                        code_block = '\n'.join(code_lines)
-                        syntax = Syntax(code_block, "python", theme="monokai", line_numbers=False)
-                        self.__rich_console.print(syntax)
+                    # If verbosity is detailed, include file path, line number, error message, and traceback
+                    if self.__verbosity == VerbosityMode.DETAILED.value:
 
-                    except (FileNotFoundError, ValueError, IndexError):
+                        try:
 
-                        # Fallback to original behavior if file cannot be read
-                        text = Text(f"{_line} | {_code}", style="dim")
-                        self.__rich_console.print(text)
+                            # Open the file and read its lines
+                            if isinstance(_file, str) and _file:
+                                with open(_file, 'r', encoding='utf-8') as f:
+                                    file_lines = f.readlines()
+                            else:
+                                raise ValueError(f"Invalid file path: {_file}")
+
+                            # Convert to 0-based index
+                            error_line_num = int(_line) - 1
+                            start_line = max(0, error_line_num - 1)
+                            end_line = min(len(file_lines), error_line_num + 3)
+
+                            # Create a code block with syntax highlighting
+                            code_lines = []
+                            for i in range(start_line, end_line):
+                                line_num = i + 1
+                                line_content = file_lines[i].rstrip()
+                                if line_num == int(_line):
+                                    # Highlight the error line
+                                    code_lines.append(f"* {line_num:3d} | {line_content}")
+                                else:
+                                    code_lines.append(f"  {line_num:3d} | {line_content}")
+
+                            code_block = '\n'.join(code_lines)
+                            syntax = Syntax(code_block, "python", theme="monokai", line_numbers=False)
+                            self.__rich_console.print(syntax)
+
+                        except Exception:
+
+                            # Fallback to original behavior if file cannot be read
+                            text = Text(f"{_line} | {_code}", style="dim")
+                            self.__rich_console.print(text)
 
                 else:
 
@@ -570,7 +598,7 @@ class TestPrinter(ITestPrinter):
                     self.__rich_console.print(text)
 
                     # Print the error message with better formatting
-                    text = Text(status_icon, style="bold red")
+                    text = Text(f"{status_icon} ", style="bold red")
                     self.__rich_console.print(text)
 
                     # Print traceback if available
@@ -583,7 +611,8 @@ class TestPrinter(ITestPrinter):
                         self.__rich_console.print(syntax)
 
                 # Print a separator line after each test result
-                self.__rich_console.rule()
+                if self.__verbosity == VerbosityMode.DETAILED.value:
+                    self.__rich_console.rule()
 
                 # Print one blank line after the results
                 self.__rich_console.line(1)
@@ -608,7 +637,7 @@ class TestPrinter(ITestPrinter):
         None
         """
         # If result printing is disabled, do not display results
-        if not self.__print_result:
+        if self.__verbosity < VerbosityMode.DETAILED.value:
             return
 
         # Determine the status icon and label based on the test result

{orionis-0.592.0.dist-info → orionis-0.593.0.dist-info}/METADATA

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

{orionis-0.592.0.dist-info → orionis-0.593.0.dist-info}/RECORD

@@ -191,7 +191,7 @@ 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=bXT1VMXvZQc2rs2x0s3PNVuHSaoDYLBUq7LfK1BcZYs,12204
+orionis/foundation/config/testing/entities/testing.py,sha256=OkgaZ4lCeU3bTUUVHl73PEbdlXjMsI16iuD9Pwkc5vg,11587
 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
@@ -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=ip6JaD0K5V1Nr2jamVLSIj9neaJh7Hg-KeuFaQc4QUw,4109
+orionis/metadata/framework.py,sha256=s6s0dYCwOfjVO09Leal7YLnkxZ0CYqHnEB3e5xJ3E-E,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
@@ -372,7 +372,7 @@ orionis/test/contracts/render.py,sha256=wpDQzUtT0r8KFZ7zPcxWHXQ1EVNKxzA_rZ6ZKUcZ
 orionis/test/contracts/test_result.py,sha256=SNXJ2UerkweYn7uCT0i0HmMGP0XBrL_9KJs-0ZvIYU4,4002
 orionis/test/contracts/unit_test.py,sha256=6DG8rqhBSvTf3lwtmzyO_xci_V-9WxBP6ZibATeQ3Gw,589
 orionis/test/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/test/core/unit_test.py,sha256=rGesBj6cPRCBvfpWPXijK0pqFZ9OqRxcuZbGTAhRq7E,72853
+orionis/test/core/unit_test.py,sha256=U5HT1a6s-Wosz5BC7Pi5cPreRyLzFJWbEoKWw7jdvvY,72957
 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
@@ -385,7 +385,7 @@ orionis/test/exceptions/runtime.py,sha256=h9gQ0pS8tJTmuXNG-GHky8tTqpdz-cNqkntOOl
 orionis/test/exceptions/value.py,sha256=CoqYOkViU_RaKCMNpB82tgEsR3XhI1pw6YQ8sH8CJh4,588
 orionis/test/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/output/dumper.py,sha256=qJDyVvl3MO0Uinr6z9TYYdDTqHNwwM0PcoDNNkTpAnA,5908
-orionis/test/output/printer.py,sha256=tWj0lMYD3LTeJ9q_kzgJpXc9w0qJxDwHwoEl_0SzD-4,27508
+orionis/test/output/printer.py,sha256=M33HhDQBRxB-C-myOqPFSkTvfLyDCc424uVqJg40NYc,29575
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/records/logs.py,sha256=N5MczDDZ8HqyTCLgb4ikzAQzyzl2JhKHNVd-KGzAG20,22081
 orionis/test/validators/__init__.py,sha256=2e862DM9aRnPajv2nxMujewe9dZ-1PyCamJKDcF-hGc,944
@@ -406,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=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.592.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.592.0.dist-info/METADATA,sha256=HNQVi6xUNecxxbdaPr8EeQ-FTrD3nAHZKs_LYP1pi58,4801
-orionis-0.592.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.592.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.592.0.dist-info/RECORD,,
+orionis-0.593.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.593.0.dist-info/METADATA,sha256=O3C-w6zuLT6bsvYt-y-TlgqIw03W_A9EQ17OadTCTdc,4801
+orionis-0.593.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.593.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.593.0.dist-info/RECORD,,