TraceStep (Class)

One pause of a traced execution: an executed source statement, with the variables that were in scope when it was reached. What the CLI debugger shows on each step, recorded instead of printed.

function_name property

function_name: Optional[str]

The function the statement belongs to (after inlining); None outside any mapped function.

line property

line: Optional[int]

1-based source line of the statement. None when no source mapping exists (e.g. generated dispatch code).

A covenant transition also pauses once on a span the engine leaves unset, which reads as line 1 — the CLI debugger highlights that line at the same pause, so the step is recorded rather than dropped.

statement property

statement: Optional[str]

The statement's source text (the active line, trimmed).

variables property

variables: list[DebugVariable]

The variables in scope when the statement was reached — before it executes, so a local it defines appears from the following step on.

__repr__

__repr__() -> str

The detailed string representation.

RETURNS	DESCRIPTION
str	The TraceStep as a repr string. TYPE: str