Struct EntityRoot 

pub struct EntityRoot { /* private fields */ }

Represents the root component in an Entity Resource Name (ERN).

The root component is a unique identifier for the base resource in the ERN hierarchy. It uses the mti crate’s MagicTypeId with UUID v7 algorithm to generate time-ordered, unique identifiers that enable k-sortability.

When using EntityRoot, each call to create a new root with the same name will generate a different ID, as it incorporates the current timestamp. This makes EntityRoot suitable for resources that should be ordered by creation time.

For content-addressable, deterministic IDs, use SHA1Name instead.

Implementations

impl EntityRoot

pub fn name(&self) -> &MagicTypeId

Returns a reference to the underlying MagicTypeId.

This is useful when you need to access the raw identifier for comparison or sorting operations.

Example

let root1 = EntityRoot::new("resource1".to_string())?;
let root2 = EntityRoot::new("resource2".to_string())?;

// Compare roots by their MagicTypeId
let comparison = root1.name().cmp(root2.name());

pub fn as_str(&self) -> &str

Returns the string representation of this root’s identifier.

Example

let root = EntityRoot::new("profile".to_string())?;
let id_str = root.as_str();

// The string will contain the original name followed by a timestamp-based suffix
assert!(id_str.starts_with("profile_"));

pub fn new(value: String) -> Result<Self, ErnError>

Creates a new EntityRoot with the given value.

This method generates a time-ordered, unique identifier using the UUID v7 algorithm. Each call to this method with the same input value will generate a different ID, as it incorporates the current timestamp. This makes EntityRoot suitable for resources that should be ordered by creation time.

Arguments

• value - The string value to use as the base for the entity root ID

Validation Rules

• Value cannot be empty
• Value must be between 1 and 255 characters

Returns

• Ok(EntityRoot) - If validation passes
• Err(ErnError) - If validation fails

Example

let root = EntityRoot::new("profile".to_string())?;

// The ID will contain the original name followed by a timestamp-based suffix
assert!(root.to_string().starts_with("profile_"));

Trait Implementations

impl AsRef<MagicTypeId> for EntityRoot

fn as_ref(&self) -> &MagicTypeId

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for EntityRoot

fn clone(&self) -> EntityRoot

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for EntityRoot

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

Formats the value using the given formatter.

impl Default for EntityRoot

fn default() -> EntityRoot

Returns the “default value” for a type.

impl Display for EntityRoot

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

Formats the value using the given formatter.

impl ErnComponent for EntityRoot

type NextState = Part

The type of the next component that should follow this one in the ERN structure.

fn prefix() -> &'static str

Returns the prefix string that should appear before this component in an ERN.

impl From<EntityRoot> for MagicTypeId

fn from(value: EntityRoot) -> Self

Converts to this type from the input type.

impl From<MagicTypeId> for EntityRoot

fn from(value: MagicTypeId) -> Self

Converts to this type from the input type.

impl FromStr for EntityRoot

Implementation of FromStr for EntityRoot to create an entity root from a string.

fn from_str(s: &str) -> Result<Self, Self::Err>

Creates an EntityRoot from a string.

This method generates a time-ordered, unique identifier using the UUID v7 algorithm. Each call to this method with the same input string will generate a different ID, as it incorporates the current timestamp.

Arguments

• s - The string value to use as the base for the entity root ID

Returns

• Ok(EntityRoot) - If validation passes
• Err(ErnError) - If validation fails

type Err = ErnError

The associated error which can be returned from parsing.

impl Hash for EntityRoot

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 EntityRoot

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

fn partial_cmp(&self, other: &EntityRoot) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Eq for EntityRoot

impl StructuralPartialEq for EntityRoot