Frame

final class ntoseye.Frame

One recovered stack frame with the register context used for locals.

__getitem__(name: str, /) → int | None

Get a local variable by name.

property index: int

The position of the frame. The innermost frame is 0.

property inline: bool

Whether the frame is a call that the compiler inlined into the physical frame after it. The two frames share the ip, sp, and registers.

property ip: int

The instruction pointer of the frame.

property locals: dict[str, int | None]

The local variables, evaluated in the recovered context of this frame.

property registers: Registers

The registers of the frame: the live register file (writable) for the innermost frame of a running thread, and the recovered subset (read-only) for other frames.

property source: str | None

How ntoseye recovered the frame (unwind data, frame pointer, …).

property sp: int

The stack pointer of the frame.

property symbol: str | None

The symbol at ip, if it resolves to one. For an inline frame, the function that the compiler inlined.

property thread: Thread | None

The thread that owns this stack.

to_dict() → dict[str, Any]