Struct Observer 

pub struct Observer { /* private fields */ }

A read-only, cloneable view of a phase and its subtree, usable from any thread. Holding one keeps the job’s records alive.

Implementations

impl Observer

pub fn id(&self) -> NodeId

The observed phase’s identity.

pub fn summary(&self) -> Summary

Read weighted progress without allocating or copying phase names. Walks this subtree; sample at a display cadence, not on every report.

pub fn try_summary(&self) -> Option<Summary>

Read a summary without waiting for a metadata lock. Retry on a later turn.

pub fn name(&self) -> &str

This phase’s stable name; duplicate names are distinguished by id.

pub fn snapshot(&self) -> Snapshot

Take a snapshot now.

Each phase’s metadata is internally consistent; counters in different phases are read one after another, not atomically together. A finished subtree’s snapshot is frozen. This allocates and walks the subtree, so the caller chooses how often to sample.

pub fn try_snapshot(&self) -> Option<Snapshot>

Take a snapshot without waiting for a lock held by another thread.

Returns None if any phase’s metadata is being replaced at that moment; try again on a later UI or event-loop turn. It never spins. Without std, entry into the platform’s critical section is up to its provider; allocation and the tree walk happen outside it.

pub fn is_finished(&self) -> bool

Whether the phase has an outcome, without walking the tree.

pub fn children(&self) -> Vec<Observer>

Observers of this phase’s planned children, in declared order; empty for a leaf. Copies one list of handles, without walking the subtree.

Trait Implementations

impl Clone for Observer

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Observer

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

Formats the value using the given formatter.