Frame

final class ntoseye.Frame

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

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

Resolve a local variable by name.

property index: int

The frame’s position, 0 being the innermost.

property ip: int

The frame’s instruction pointer.

property locals: dict[str, int | None]

Local variables evaluated in this frame’s recovered context.

property registers: Registers

The frame’s registers: the live file for the innermost frame of a running thread (writable), otherwise the recovered subset (read-only).

property source: str | None

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

property sp: int

The frame’s stack pointer.

property symbol: str | None

The symbol at ip, if one resolved.

property thread: Thread | None

The thread this stack belongs to.

to_dict() → dict[str, Any]