Struct KeyParts 

pub struct KeyParts {
    pub owner: Option<Arc<str>>,
    pub kind: Option<Arc<str>>,
    pub label: Arc<str>,
    pub generation: Option<u64>,
}

A key’s parts, by the grammar every key the tree mints follows:

[<owner>/]<name>[#<generation>]     where <name> is [<kind>:]<label>

golden/tool:add#2 is owner golden, kind tool, label add, generation 2; host/note is owner host, no kind, label note; model:fast is no owner, kind model, label fast. The owner is the text before the first /, the kind the text before the first : of what follows, the generation the digits after the last #; a label holds anything else, so a key whose label contains one of those separators is read as its grammar says, not as its author meant. The string is the wire form; this is how a reader takes it apart without a hand parser of its own.

Fields

owner: Option<Arc<str>>

The program or host the key belongs to (golden, host).

kind: Option<Arc<str>>

The family-shaped prefix of the name (model, tool, retrieve).

label: Arc<str>

The name proper: a model label, a tool name, memory, note.

generation: Option<u64>

The disambiguating generation (#2): the same tool registered again under a fresh key. Only canonical u64 decimal suffixes are generations; leading zeroes and overflow remain literal label text.

Implementations

impl KeyParts

pub fn parse(key: &str) -> Self

Read key by the grammar.

pub fn to_key(&self) -> HandlerKey

The parts as the key they came from (Display writes the same).

Trait Implementations

impl Clone for KeyParts

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for KeyParts

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

Formats the value using the given formatter.

impl Display for KeyParts

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

Formats the value using the given formatter.

impl Eq for KeyParts

impl Hash for KeyParts

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 KeyParts

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for KeyParts