orionis 0.644.0__py3-none-any.whl → 0.645.0__py3-none-any.whl

orionis/test/output/dumper.py

@@ -1,17 +1,8 @@
-import os
 import sys
-from orionis.console.dumper.debug import Debug
-from orionis.test.exceptions import OrionisTestRuntimeError
+from orionis.console.output.console import Console
 from orionis.test.contracts.dumper import ITestDumper
 
 class TestDumper(ITestDumper):
-    """
-    Utility class for debugging and outputting information during test execution.
-
-    Provides methods to determine if an object is a test case instance, output debugging
-    information using the Debug class, manage standard output and error streams, and
-    capture the caller's file and line number for context.
-    """
 
     def __isTestCaseClass(self, value) -> bool:
         """
@@ -56,67 +47,66 @@ class TestDumper(ITestDumper):
             # If imports fail or any other exception occurs, return False.
             return False
 
-    def dd(self, *args) -> None:
+    def __valuesToDump(self, args: tuple) -> tuple:
         """
-        Output debugging information and halt further execution.
-
-        Captures the caller's file and line number for context. Temporarily redirects
-        standard output and error streams to ensure correct display. If the first argument
-        is a recognized test case instance, it is skipped in the output. Raises a custom
-        runtime error if dumping fails.
+        Filter out test case instances from the provided arguments.
 
         Parameters
         ----------
-        *args : tuple
-            Objects to be dumped.
+        args : tuple
+            A tuple of objects to be filtered.
 
         Returns
         -------
-        None
+        tuple
+            A new tuple containing only the objects that are not instances of recognized
+            test case classes.
         """
 
-        # If no arguments are provided, exit the method early.
-        if not args:
-            return
+        values: tuple = tuple()
+        for arg in args:
+            if not self.__isTestCaseClass(arg):
+                values += (arg,)
 
-        # Save the original stdout and stderr to restore them later
-        original_stdout = sys.stdout
-        original_stderr = sys.stderr
+        return values
 
-        try:
+    def __tracebackInfo(self) -> tuple[str | None, int | None]:
+        """
+        Retrieve the module name and line number of the caller.
 
-            # Redirect stdout and stderr to the system defaults for proper debug output
-            sys.stdout = sys.__stdout__
-            sys.stderr = sys.__stderr__
+        This method inspects the call stack to obtain the module name and line number
+        from which it was called. This information is useful for debugging and logging
+        purposes, as it provides context about where a function was invoked.
 
-            # Retrieve the caller's frame to get file and line number context
-            caller_frame = sys._getframe(1)
-            _file = os.path.abspath(caller_frame.f_code.co_filename)
-            _line = caller_frame.f_lineno
+        Returns
+        -------
+        tuple of (str or None, int or None)
+            A tuple containing the module name as a string and the line number as an integer.
+            If the information cannot be determined due to an error, returns (None, None).
+        """
+
+        try:
 
-            # Initialize the Debug dumper with context information
-            dumper = Debug(f"{_file}:{_line}")
+            # Get the caller's frame from the call stack (1 level up)
+            caller_frame = sys._getframe(2)
 
-            # If the first argument is a test case instance, skip it in the output
-            if self.__isTestCaseClass(args[0]):
-                dumper.dd(*args[1:])
-            else:
-                dumper.dd(*args)
+            # Retrieve the module name from the caller's global variables
+            module = caller_frame.f_globals.get("__name__", None)
 
-        except Exception as e:
+            # Retrieve the line number from the caller's frame
+            line_number = caller_frame.f_lineno
 
-            # Raise a custom runtime error if dumping fails
-            raise OrionisTestRuntimeError(f"An error occurred while dumping debug information: {e}")
+            # Return the module name and line number
+            return (module, line_number)
 
-        finally:
+        except Exception:
 
-            # Restore the original stdout and stderr
-            sys.stdout = original_stdout
-            sys.stderr = original_stderr
+            # If any error occurs while retrieving the frame, return (None, None)
+            return (None, None)
 
-    def dump(self, *args) -> None:
+    def dd(self, *args) -> None:
         """
-        Output debugging information.
+        Output debugging information and halt further execution.
 
         Captures the caller's file and line number for context. Temporarily redirects
         standard output and error streams to ensure correct display. If the first argument
@@ -133,41 +123,49 @@ class TestDumper(ITestDumper):
         None
         """
 
-        # If no arguments are provided, exit the method early.
-        if not args:
-            return
-
-        # Save the original stdout and stderr to restore them later
-        original_stdout = sys.stdout
-        original_stderr = sys.stderr
-
-        try:
-
-            # Redirect stdout and stderr to the system defaults for proper debug output
-            sys.stdout = sys.__stdout__
-            sys.stderr = sys.__stderr__
-
-            # Retrieve the caller's frame to get file and line number context
-            caller_frame = sys._getframe(1)
-            _file = os.path.abspath(caller_frame.f_code.co_filename)
-            _line = caller_frame.f_lineno
+        # Retrieve the caller's module and line number for context
+        module, line = self.__tracebackInfo()
 
-            # Initialize the Debug dumper with context information
-            dumper = Debug(f"{_file}:{_line}")
+        # Filter out test case instances from the arguments
+        Console().dump(
+            *self.__valuesToDump(args),
+            module_path=module,
+            line_number=line,
+            force_exit=True,        # Halt execution after dumping
+            redirect_output=True,   # Redirect stdout/stderr for proper display
+            insert_line=True
+        )
 
-            # If the first argument is a test case instance, skip it in the output
-            if self.__isTestCaseClass(args[0]):
-                dumper.dump(*args[1:])
-            else:
-                dumper.dump(*args)
+    def dump(self, *args) -> None:
+        """
+        Output debugging information without halting execution.
 
-        except Exception as e:
+        This method captures the caller's module and line number to provide context for the output.
+        It filters out any recognized test case instances from the provided arguments to avoid dumping
+        unnecessary or sensitive test case objects. The method then delegates the actual output operation
+        to the internal console, ensuring that standard output and error streams are redirected for
+        correct display. Unlike `dd`, this method does not terminate the program after dumping.
 
-            # Raise a custom runtime error if dumping fails
-            raise OrionisTestRuntimeError(f"An error occurred while dumping debug information: {e}")
+        Parameters
+        ----------
+        *args : tuple
+            Objects to be dumped. Test case instances are automatically filtered out.
 
-        finally:
+        Returns
+        -------
+        None
+            This method does not return any value. It performs output as a side effect.
+        """
 
-            # Restore the original stdout and stderr
-            sys.stdout = original_stdout
-            sys.stderr = original_stderr
+        # Retrieve the caller's module and line number for context
+        module, line = self.__tracebackInfo()
+
+        # Filter out test case instances from the arguments and output the rest
+        Console().dump(
+            *self.__valuesToDump(args),
+            module_path=module,
+            line_number=line,
+            force_exit=False,      # Do not halt execution after dumping
+            redirect_output=True,  # Redirect stdout/stderr for proper display
+            insert_line=True
+        )

{orionis-0.644.0.dist-info → orionis-0.645.0.dist-info}/METADATA

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

{orionis-0.644.0.dist-info → orionis-0.645.0.dist-info}/RECORD

@@ -23,8 +23,8 @@ orionis/console/contracts/base_command.py,sha256=UlDN41Ts0ulxM-B2kgeKNr9_gNv_0LC
 orionis/console/contracts/base_scheduler.py,sha256=RSxEW57MoMU3pXfliIrQw9WuMk95p-xHXi1yACp1qsU,7728
 orionis/console/contracts/cli_request.py,sha256=qIV8ig8PG39LYp1acnUD8GYsNRSHncxIxGjO3B3YsUo,6755
 orionis/console/contracts/command.py,sha256=Wvm62hw2gDIPNmoEUFyhKUERjZ6wnAbI-UDY_5gJE24,3626
-orionis/console/contracts/console.py,sha256=phaQhCLWa81MLzB5ydOSaUfEIdDq7fOjvym8Rmi-arc,11908
-orionis/console/contracts/debug.py,sha256=tEdF3_HJwDAgccXVEk_LGf43Am2ylbcx9i0Qvj3MFyU,1011
+orionis/console/contracts/console.py,sha256=TuoyCLInhp5ztlyJ82rBsw_1Ki3_fOnF_gtaWUxSW1M,14253
+orionis/console/contracts/dumper.py,sha256=qJAEVRaKyfLtxPFgO2Thk-nUYrSlNiEzxN0vDag7DwE,3918
 orionis/console/contracts/event.py,sha256=KQESAycPzBE3xoDTnbYLz_XXg-7dwrybYKbaJjgkCMY,119842
 orionis/console/contracts/executor.py,sha256=JAzK64_5HfIGm3_BwsUv7-ZeC2Y-3mpxOByHaXwuy9A,4278
 orionis/console/contracts/kernel.py,sha256=mh4LlhEYHh3FuGZZQ0GBhD6ZLa5YQvaNj2r01IIHI5Y,826
@@ -34,8 +34,8 @@ orionis/console/contracts/schedule.py,sha256=xtXgp4BPhvhg3YSM4mrIdbyoBdr4OJBi1gB
 orionis/console/contracts/schedule_event_listener.py,sha256=h06qsBxuEMD3KLSyu0JXdUDHlQW19BX9lA09Qrh2QXg,3818
 orionis/console/core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/core/reactor.py,sha256=x_bRFLBq5MiKZdlMG1gZR1GCZgFkUDnG5l_nh2YKiR8,44044
-orionis/console/dumper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/dumper/debug.py,sha256=p8uflSXeDJDrVM9mZY4JMYEus73Z6TsLnQQtgP0QUak,22427
+orionis/console/debug/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+orionis/console/debug/dumper.py,sha256=4AOo9iNRLdU9VTKrsvraQIKCzOzK5JFMqOjAix-Zrus,6245
 orionis/console/dynamic/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/dynamic/progress_bar.py,sha256=58wne7E_QZb_uN9jjqQ_V28Ci19SVNhCQQ4zzXCiOu0,2872
 orionis/console/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -58,7 +58,7 @@ orionis/console/fluent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 orionis/console/fluent/command.py,sha256=0jyhB45LIjDS7nkjNhkkvEXEzdOBmT49qKIooYY_DbI,8261
 orionis/console/fluent/event.py,sha256=RM6Aaz-2MYQg4RWxYdr6oBNaAjNVp9DE_tI5iwl2mAk,166672
 orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/output/console.py,sha256=EtSDWRBW8wk0iJdPfB1mzU49krLJBaSAUdVdVOzzhQ4,17888
+orionis/console/output/console.py,sha256=5j8Cr67dZWvxBpeJS2cOXR1UpjE-rYKAD0o10olPumM,23463
 orionis/console/output/executor.py,sha256=uQjFPOlyZLFj9pcyYPugCqxwJog0AJgK1OcmQH2ELbw,7314
 orionis/console/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/request/cli_request.py,sha256=lO7088xlVK1VP-NhCIgAo7qXGzCW3nXVOJag43fUv20,13207
@@ -206,7 +206,7 @@ orionis/foundation/providers/catch_provider.py,sha256=E8LtH8mKyeAFGS7PZrgT4t-bIk
 orionis/foundation/providers/cli_request_provider.py,sha256=bbCU-wQN49MEXW1CJJCupNmz2FsaNuk24fSJ80k-guo,1313
 orionis/foundation/providers/console_provider.py,sha256=X81VAGT2wt7pbnCOWto2We9V4G9Xoz95t63RwCA9qXo,1499
 orionis/foundation/providers/directory_provider.py,sha256=n-TL0GTDt51sC1c__Q-ZolpldK9mHR3-R15Ob6EhSYY,1280
-orionis/foundation/providers/dumper_provider.py,sha256=AD8ejfSCDciH1jO0xhVQT__rP8XnsOiOgAKsA3h02dA,1472
+orionis/foundation/providers/dumper_provider.py,sha256=pC3rll3E2ZwBxCPUL8yEERtkeOf1Zu3Mfu3F1Gv8KRM,1472
 orionis/foundation/providers/executor_provider.py,sha256=fAD0zMVlznxbCweakQ6XcxVEpZck8bwGfXgjhjI0Tek,1430
 orionis/foundation/providers/inspirational_provider.py,sha256=qiuvzE4sZMFhE2q4-0PLdwKAYoGzmLk1EN0KKzesQBU,1446
 orionis/foundation/providers/logger_provider.py,sha256=EPn3W6Hk1DD03iJckeX1lWjLWg3kA7swhF0O_6VSFAg,1583
@@ -217,7 +217,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=an5KPFMKvms3aFMs99cuOOb4s4oXvBeWR38Bdzycsz8,4089
+orionis/metadata/framework.py,sha256=L0N1XstaoGMEV58t5NpJ9fhvVLtM0N_tkYDqkRBzTuo,4089
 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
@@ -318,7 +318,7 @@ orionis/support/facades/console.pyi,sha256=nWrYF-N5BIHbOSU7lAICb5KKrpzMX0QC7go3e
 orionis/support/facades/directory.py,sha256=85ho4t9APMULBtJ58MPl-rRit9ub48XpYWPzEjLU3_8,946
 orionis/support/facades/directory.pyi,sha256=3WnIpvLMunTgzR5un49XzAkqOKkOtkrVko34SNJVcAY,592
 orionis/support/facades/dumper.py,sha256=oh9L3s-526Lk7l19sRniyCeCzzv-ConqC98FO_oIXsw,900
-orionis/support/facades/dumper.pyi,sha256=SAplVqQgW7cKANqJL6lMu-rfG5sWQaAOZ7MaSkirdvg,508
+orionis/support/facades/dumper.pyi,sha256=ELzP_jY2RKHcQtjwjH56H2-P-ro9U-pSUsR_lBxlTZo,509
 orionis/support/facades/executor.py,sha256=276MKqXsvrW947SvSzEcl8wleAtsjxhVq_r8FcySGH4,1061
 orionis/support/facades/executor.pyi,sha256=JS0h8ddYD62o79yXL5UzeZmPWOXNasyMgXKL8ZCOkBE,547
 orionis/support/facades/inspire.py,sha256=oGPMP_mNEmQRbPx7W-TwvW_xwbn4c04rHzu_ivgVKdw,964
@@ -383,7 +383,7 @@ orionis/test/exceptions/persistence.py,sha256=8Oakaey35DpByLoGnfbwHxFKntxgWaGl49
 orionis/test/exceptions/runtime.py,sha256=h9gQ0pS8tJTmuXNG-GHky8tTqpdz-cNqkntOOlRXZJg,612
 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=_FPetJq96fiWJhN29gMG8Rt6MEEgiyFHC5k95ACNtKY,5906
+orionis/test/output/dumper.py,sha256=x2VbmO1uwAVMrHTTXbxsn1-tMwUviL1zThAgSM8O5Qo,6038
 orionis/test/output/printer.py,sha256=3nevE9nyhMn0n8UpE-Nwsy4d1l3GE0wnBf4fAGPQxf4,29623
 orionis/test/records/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/records/logs.py,sha256=Dtu5HaWa2meblgTUXVAcOFaxkSJ3YxfDRaFoc_nhMCU,22043
@@ -404,8 +404,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.644.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.644.0.dist-info/METADATA,sha256=W6c-hofzs4pavn7cx6JPrhMfGr5ShsVcS6BinVXz3Mo,4772
-orionis-0.644.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.644.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.644.0.dist-info/RECORD,,
+orionis-0.645.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.645.0.dist-info/METADATA,sha256=MXLWEwJdR0UwrfF6UR4RLdF8vXKWL6TKhhkJytiSQhc,4772
+orionis-0.645.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.645.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.645.0.dist-info/RECORD,,

orionis/console/contracts/debug.py

@@ -1,34 +0,0 @@
-from abc import ABC, abstractmethod
-from typing import Any
-
-class IDebug(ABC):
-    """
-    Abstract base class for debugging utilities that provide enhanced output and inspection of Python objects.
-
-    This class defines the interface for dumping and inspecting data in various formats,
-    supporting features such as recursion handling and customizable indentation.
-    """
-
-    @abstractmethod
-    def dd(self, *args: Any) -> None:
-        """
-        Dump the provided arguments to the output and terminate the program.
-
-        Parameters
-        ----------
-        *args : Any
-            Variable length argument list to be dumped and displayed.
-        """
-        pass
-
-    @abstractmethod
-    def dump(self, *args: Any) -> None:
-        """
-        Dump the provided arguments for debugging or logging purposes.
-
-        Parameters
-        ----------
-        *args : Any
-            Variable length argument list to be dumped and displayed.
-        """
-        pass