Struct CapabilityIdIndex 

pub struct CapabilityIdIndex { /* private fields */ }

Canonical-id and alias index for a capability registry.

Owns the identity bookkeeping every registry needs: which canonical ids exist, which legacy aliases resolve to them, and collision rejection when a new registration would shadow an existing id or alias. Registries keep their own id -> implementation storage and delegate identity questions here so the Framework and the product resolve capability identity the same way.

Implementations

impl CapabilityIdIndex

pub fn new() -> Self

Create an empty index.

pub fn insert( &mut self, canonical: impl Into<String>, aliases: &[&str], ) -> Result<(), CapabilityError>

Insert a canonical id and its aliases, rejecting collisions.

Fails with CapabilityError::Duplicate when the canonical id (or any alias) is already present as a canonical id or alias.

pub fn insert_or_replace( &mut self, canonical: impl Into<String>, aliases: &[&str], )

Insert a canonical id and its aliases, replacing an existing entry with the same canonical id (legacy registry override semantics).

pub fn canonical_of<'a>(&'a self, id: &'a str) -> Option<&'a str>

Resolve an id or alias to its canonical id, if registered.

pub fn contains(&self, id: &str) -> bool

Whether the id is present as a canonical id or alias.

pub fn remove(&mut self, id: &str) -> Option<String>

Remove an id (or alias) and everything resolving to its canonical id.

Returns the removed canonical id, if any.

pub fn canonical_ids(&self) -> impl Iterator<Item = &str>

Iterate the canonical ids in the index.

Trait Implementations

impl Clone for CapabilityIdIndex

fn clone(&self) -> CapabilityIdIndex

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CapabilityIdIndex

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

Formats the value using the given formatter.

impl Default for CapabilityIdIndex

fn default() -> CapabilityIdIndex

Returns the “default value” for a type.