Frame objects represent execution frames. They may occur in traceback objects (see type-traceback).
Special read-only attributes:
- f_back is to the previous stack frame (towards the caller), or None if this is the bottom stack frame.
- f_code is the code object being executed in this frame.
- f_locals is the dictionary used to look up local variables.
- f_globals is used for global variables.
- f_builtins is used for built-in (intrinsic) names.
- f_restricted is a flag indicating whether the function is executing in restricted execution mode.
- f_lasti gives the precise instruction (this is an index into the bytecode string of the code object).
Special writable attributes:
- f_trace, if not None, is a function called at the start of each source code line (this is used by the debugger).
- f_exc_type, f_exc_value, f_exc_traceback represent the last exception raised in the parent frame provided another exception was ever raised in the current frame (in all other cases they are None).
- f_lineno is the current line number of the frame — writing to this from within a trace function jumps to the given line (only for the bottom-most frame). A debugger can implement a Jump command (aka Set Next Statement) by writing to f_lineno.