Struct TraceEvent 

pub struct TraceEvent {
    pub phase: Phase,
    pub reason: Reason,
    pub som: Option<String>,
    pub input: Option<String>,
    pub decision: Option<String>,
    pub source: Option<String>,
}

One trace event.

Optional fields use None rather than empty strings so the canonical JSON output emits null cleanly. Numeric input and output summaries are constrained to i64 to stay deterministic across platforms.

Fields

phase: Phase

Phase in which the event fired.

reason: Reason

Reason describing the decision.

som: Option<String>

Optional SOM path of the node the decision applies to.

input: Option<String>

Optional human-readable input summary (e.g. "available_h=267.3").

decision: Option<String>

Optional human-readable decision summary (e.g. "defer_to_next_page").

source: Option<String>

Optional source-module hint (e.g. "layout::paginate"); cheap to produce and useful when grepping traces.

Implementations

impl TraceEvent

pub fn new(phase: Phase, reason: Reason) -> Self

Construct a minimal event with just phase + reason.

pub fn with_som(self, som: impl Into<String>) -> Self

Builder: set the SOM path.

pub fn with_input(self, input: impl Into<String>) -> Self

Builder: set the input summary.

pub fn with_decision(self, decision: impl Into<String>) -> Self

Builder: set the decision summary.

pub fn with_source(self, source: impl Into<String>) -> Self

Builder: set the source-module hint.

Trait Implementations

impl Clone for TraceEvent

fn clone(&self) -> TraceEvent

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraceEvent

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for TraceEvent

fn eq(&self, other: &TraceEvent) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TraceEvent