Struct SameHostTracker 

pub struct SameHostTracker { /* private fields */ }

Tracker for all (WriterGuid, ReaderGuid) same-host pairs of the local participant. Thread-safe via an inner mutex.

The API is deliberately minimal: register_pending, mark_bound, mark_failed, lookup. More complex operations (iteration, cleanup-on-drop) are left to the caller.

Implementations

impl SameHostTracker

pub fn new() -> Self

New empty tracker.

pub fn register_pending(&self, writer: Guid, reader: Guid)

Registers a pair in the Pending state. Idempotent — an existing entry is not overwritten (so that a Bound state is not accidentally reset).

pub fn mark_bound( &self, writer: Guid, reader: Guid, transport: Arc<dyn Any + Send + Sync>, role: Role, )

Marks a pair as Bound with a transport handle and role. Overwrites any previous state.

pub fn mark_failed(&self, writer: Guid, reader: Guid, reason: &'static str)

Marks a pair as Failed. The caller (hot path) should then choose the UDP fallback.

pub fn lookup(&self, writer: Guid, reader: Guid) -> Option<SameHostState>

Returns a copy of the state for a pair.

pub fn remove(&self, writer: Guid, reader: Guid)

Removes an entry (e.g. when the match is dissolved).

pub fn len(&self) -> usize

Number of currently registered pairs.

pub fn is_empty(&self) -> bool

true if the tracker is empty.

pub fn snapshot(&self) -> Vec<(Guid, Guid, SameHostState)>

Snapshot of all pairs. Mainly for debug/diagnostics.

Trait Implementations

impl Debug for SameHostTracker

Available on crate feature std only.

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

Formats the value using the given formatter.

impl Default for SameHostTracker

Available on crate feature std only.

fn default() -> Self

Returns the “default value” for a type.