Struct SubsystemIdentifier 

pub struct SubsystemIdentifier { /* private fields */ }

A fully qualified, canonical identifier for a uniquely addressable subsystem within the overall system.

SubsystemIdentifier is meant to represent a unique identifier for any “subsystem” in a Saluki-based data plane such that it is already sanitized, normalized, and ready to be used in the various registries and areas where unique names are required: health registry, resource account, supervision trees, and more.

Segments are sanitized as they are added, and any segment that sanitizes to an empty string is dropped. A SubsystemIdentifier therefore never contains an empty segment, and its rendered form never has a leading, trailing, or doubled separator.

Implementations

impl SubsystemIdentifier

pub fn from_segments<I, S>(segments: I) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Creates a SubsystemIdentifier from a number of segments.

Each segment is sanitized/normalized independently, and any segment that sanitizes to an empty string is dropped.

pub fn from_dotted(dotted: &str) -> Self

Creates a SubsystemIdentifier from a single dotted string, treating each period as a segment separator.

The input is split on ., then each segment is sanitized/normalized independently (matching from_segments) and empty segments are dropped. This is the correct constructor when the caller already holds an assembled, dotted name (for example topology.primary.sources.in); passing such a string to from_segments as a lone segment would instead collapse the periods into underscores.

pub fn child<S: AsRef<str>>(self, segment: S) -> Self

Consumes the identifier and returns a new one with the given segment appended.

The segment is sanitized/normalized first; if it sanitizes to empty, the identifier is returned unchanged.

pub fn is_ancestor_of(&self, other: &SubsystemIdentifier) -> bool

Returns true if other is a strict descendant of this identifier.

A descendant has this identifier as a complete leading run of segments and at least one additional segment. For example, env_provider.workload is an ancestor of env_provider.workload.remote_agent but not of env_provider.workloads (segments are compared whole, not as string prefixes), nor of env_provider.workload itself (the match must be strict).

Trait Implementations

impl Clone for SubsystemIdentifier

fn clone(&self) -> SubsystemIdentifier

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SubsystemIdentifier

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

Formats the value using the given formatter.

impl Display for SubsystemIdentifier

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

Formats the value using the given formatter.

impl Hash for SubsystemIdentifier

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for SubsystemIdentifier

fn eq(&self, other: &SubsystemIdentifier) -> 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 Eq for SubsystemIdentifier

impl StructuralPartialEq for SubsystemIdentifier