Struct WideEvent 

pub struct WideEvent<K: Key> { /* private fields */ }

A wide event — a structured log record that accumulates fields throughout a request/task lifecycle and is emitted as a single JSON line on completion.

Fields are stored in an array indexed by K::as_index() — O(1) lookup with no linear scan. Up to INLINE_CAP (24) Option<Value> slots are inline on the stack; zero heap allocation in the common case. Log entries are stored in a separate SmallVec with inline capacity of 16.

The Serialize impl emits all user entries in enum-variant order, then the "log" key (if any log entries have been accumulated). The "log" key is never declared by the user — it appears automatically.

This type is not constructed directly by users. The wide_log! macro generates a WideLogGuard that owns a WideEvent and manages the thread-local/task-local pointer via current().

Implementations

impl<K: Key> WideEvent<K>

pub fn add_path<V: Into<Value<K>>>(&mut self, path: &[K], value: V)

Set a value at a nested path. Traverses/creates intermediate objects.

pub fn inc_path(&mut self, path: &[K])

pub fn dec_path(&mut self, path: &[K])

pub fn add_n_path(&mut self, path: &[K], n: i64)

pub fn append_log_entry(&mut self, level: &'static str, message: &str)

pub fn append_log_entry_static( &mut self, level: &'static str, message: &'static str, )

Append a log entry with a &'static str message — zero-copy.

pub fn to_json(&self) -> Result<String, Error>

pub fn serialize_to<W: Write>(&self, w: &mut W) -> Result<(), Error>

Serialize directly to a writer, bypassing serde entirely. Uses itoa/ryu for zero-allocation number formatting.

Trait Implementations

impl<K: Clone + Key> Clone for WideEvent<K>

fn clone(&self) -> WideEvent<K>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<K: Key> Debug for WideEvent<K>

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

Formats the value using the given formatter.

impl<K: Key> Default for WideEvent<K>

fn default() -> Self

Returns the “default value” for a type.

impl<K: Key> Serialize for WideEvent<K>

fn serialize<S: Serializer>(&self, serializer: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.