libdebug.snapshots.registers.register_diff_accessor

RegisterDiffAccessor

Class used to access RegisterDiff objects for a thread snapshot.

Source code in libdebug/snapshots/registers/register_diff_accessor.py

class RegisterDiffAccessor:
    """Class used to access RegisterDiff objects for a thread snapshot."""

    def __init__(
        self: RegisterDiffAccessor,
        generic_regs: list[str],
        special_regs: list[str],
        vec_fp_regs: list[str],
    ) -> None:
        """Initializes the RegisterDiffAccessor object.

        Args:
            generic_regs (list[str]): The list of generic registers to include in the repr.
            special_regs (list[str]): The list of special registers to include in the repr.
            vec_fp_regs (list[str]): The list of vector and floating point registers to include in the repr.
        """
        self._generic_regs = generic_regs
        self._special_regs = special_regs
        self._vec_fp_regs = vec_fp_regs

    def __repr__(self: RegisterDiffAccessor) -> str:
        """Return a string representation of the RegisterDiffAccessor object."""
        str_repr = "RegisterDiffAccessor(\n\n"

        # Header with column alignment
        str_repr += "{:<15} {:<20} {:<20}\n".format("Register", "Old Value", "New Value")
        str_repr += "-" * 60 + "\n"

        # Log all integer changes
        for attr_name in self._generic_regs:
            attr = self.__getattribute__(attr_name)

            if attr.has_changed:
                # Format integer values in hexadecimal without zero-padding
                old_value = f"{attr.old_value:<18}" if isinstance(attr.old_value, float) else f"{attr.old_value:<#16x}"
                new_value = f"{attr.new_value:<18}" if isinstance(attr.new_value, float) else f"{attr.new_value:<#16x}"
                # Align output for consistent spacing between old and new values
                str_repr += f"{attr_name:<15} {old_value} {new_value}\n"

        return str_repr

__init__(generic_regs, special_regs, vec_fp_regs)

Initializes the RegisterDiffAccessor object.

Parameters:

Name	Type	Description	Default
generic_regs	list[str]	The list of generic registers to include in the repr.	required
special_regs	list[str]	The list of special registers to include in the repr.	required
vec_fp_regs	list[str]	The list of vector and floating point registers to include in the repr.	required

Source code in libdebug/snapshots/registers/register_diff_accessor.py

def __init__(
    self: RegisterDiffAccessor,
    generic_regs: list[str],
    special_regs: list[str],
    vec_fp_regs: list[str],
) -> None:
    """Initializes the RegisterDiffAccessor object.

    Args:
        generic_regs (list[str]): The list of generic registers to include in the repr.
        special_regs (list[str]): The list of special registers to include in the repr.
        vec_fp_regs (list[str]): The list of vector and floating point registers to include in the repr.
    """
    self._generic_regs = generic_regs
    self._special_regs = special_regs
    self._vec_fp_regs = vec_fp_regs

__repr__()

Return a string representation of the RegisterDiffAccessor object.

Source code in libdebug/snapshots/registers/register_diff_accessor.py

def __repr__(self: RegisterDiffAccessor) -> str:
    """Return a string representation of the RegisterDiffAccessor object."""
    str_repr = "RegisterDiffAccessor(\n\n"

    # Header with column alignment
    str_repr += "{:<15} {:<20} {:<20}\n".format("Register", "Old Value", "New Value")
    str_repr += "-" * 60 + "\n"

    # Log all integer changes
    for attr_name in self._generic_regs:
        attr = self.__getattribute__(attr_name)

        if attr.has_changed:
            # Format integer values in hexadecimal without zero-padding
            old_value = f"{attr.old_value:<18}" if isinstance(attr.old_value, float) else f"{attr.old_value:<#16x}"
            new_value = f"{attr.new_value:<18}" if isinstance(attr.new_value, float) else f"{attr.new_value:<#16x}"
            # Align output for consistent spacing between old and new values
            str_repr += f"{attr_name:<15} {old_value} {new_value}\n"

    return str_repr