Struct ContextLabel 

pub struct ContextLabel { /* private fields */ }

A validated, versioned context label of the form <namespace>/<record-type>/v<N>.

Used as the SHA3-512 domain separator for content_hash. Each consuming application picks its own namespace and record-type segments; the grammar is deliberately small and strict so labels are unambiguous across tenants and versions:

• exactly three /-separated, non-empty segments,
• the third segment is v followed by one or more ASCII digits (no leading zero unless the version is literally 0),
• all characters are printable ASCII excluding / within a segment.

use metamorphic_log::leaf::ContextLabel;

// Any application defines its own namespace/record-type/version.
let label = ContextLabel::parse("acme/user-keys/v1").unwrap();
assert_eq!(label.as_str(), "acme/user-keys/v1");
assert_eq!(label.namespace(), "acme");
assert_eq!(label.record_type(), "user-keys");
assert_eq!(label.version(), 1);

assert!(ContextLabel::parse("missing/version").is_err());
assert!(ContextLabel::parse("a/b/v01").is_err()); // no leading zeros

Implementations

impl ContextLabel

pub fn parse(label: &str) -> Result<Self>

Parse and validate a <namespace>/<record-type>/v<N> label.

Errors

Returns Error::MalformedLeaf if the label does not match the grammar.

pub fn as_str(&self) -> &str

The full label string, e.g. "acme/user-keys/v1".

pub fn namespace(&self) -> &str

The namespace segment, e.g. "acme".

pub fn record_type(&self) -> &str

The record-type segment, e.g. "user-keys".

pub fn version(&self) -> u64

The numeric version N, e.g. 1.

Trait Implementations

impl Clone for ContextLabel

fn clone(&self) -> ContextLabel

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ContextLabel

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

Formats the value using the given formatter.

impl Eq for ContextLabel

impl Hash for ContextLabel

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 ContextLabel

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