Enum ReachabilitySource 

#[non_exhaustive]
pub enum ReachabilitySource {
    Probe,
    Session,
    Unknown,
}

WHICH producer emitted a StreamFrame::Reachability (#150). The two say different things about the world and license different user-facing statements, and until API 1.30 the frame carried no way to tell them apart.

Advisory attribution, never an authz input: it says where an observation CAME FROM, never who a peer is.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Probe

A probe completed — a fresh throwaway dial (status/subscribe refreshing a stale entry). It describes that dial and nothing else: a Probe frame saying Relay does NOT mean any live connection is relayed.

Session

A live session’s selected path changed under it (#92 item 2). This is a claim about the link a peer’s traffic is actually on — the frame an embedder wants when warning that a call which WAS direct silently is not any more.

Unknown

The daemon did not say (api_minor < 30), or it named a producer this client predates.

The DEFAULT, deliberately — see StreamFrame::Reachability. Like PeerPath::Unknown it means “we do not know” and must never be collapsed into either confident case.

Trait Implementations

impl Clone for ReachabilitySource

fn clone(&self) -> ReachabilitySource

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ReachabilitySource

impl Debug for ReachabilitySource

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

Formats the value using the given formatter.

impl Default for ReachabilitySource

fn default() -> ReachabilitySource

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ReachabilitySource

Hand-written so an unrecognized producer lands on ReachabilitySource::Unknown instead of failing the whole frame. PeerPath gets this from #[serde(other)], which serde allows only on an internally/adjacently tagged enum; this one is a plain string, so it is spelled out. The stakes are the same as there: without it, adding a third producer later would break every Reachability frame an older pinned client reads, not just the new field.

It accepts ANY input, not just an unrecognized string — null, a number, an object all read as Unknown. #[serde(default)] covers an ABSENT key and nothing else, so without this a proxy or non-Rust daemon that normalizes optional fields to null would fail every reachability frame while this module’s doc promised the field could not break a parse. A degraded attribution is the fail-safe: Unknown already means “we do not know”, which is exactly true of a value we could not read.

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl Eq for ReachabilitySource

impl PartialEq for ReachabilitySource

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ReachabilitySource

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ReachabilitySource