Enum AddressNames 

pub enum AddressNames {
    Unknown,
    Known(BTreeSet<String>),
}

What an inventory knows about one address.

Variants

Unknown

The inventory holds no record of this address at all.

Distinct from Known with an empty set, which is “recorded, and entitled to nothing” — the two produce different refusals, and an operator reading a 403 should be able to tell them apart.

Known(BTreeSet<String>)

The names it associates with the address, already normalized.

Implementations

impl AddressNames

pub fn known() -> Self

A known address with no names yet; add them with Self::insert.

pub fn insert(&mut self, value: &str)

Adds a name, normalizing it and ignoring an empty one.

An unset NetBox dns_name comes back as "" rather than as absent, so the empty check is load-bearing rather than defensive. Does nothing on Self::Unknown.

pub fn is_known(&self) -> bool

Whether the inventory holds a record of the address.

pub fn names(&self) -> &BTreeSet<String>

The names, or an empty set for an unknown address.

Trait Implementations

impl Clone for AddressNames

fn clone(&self) -> AddressNames

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AddressNames

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

Formats the value using the given formatter.

impl Eq for AddressNames

impl PartialEq for AddressNames

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for AddressNames