Struct SHA1Name 

pub struct SHA1Name { /* private fields */ }

Represents a content-addressable identifier in an Entity Resource Name (ERN).

SHA1Name uses the UUID v5 algorithm (based on SHA1 hash) to generate deterministic, content-addressable identifiers. Unlike EntityRoot which generates different IDs for the same input (incorporating timestamps), SHA1Name will always generate the same ID for the same input content.

This makes SHA1Name ideal for:

• Content-addressable resources where the same content should have the same identifier
• Deterministic resource naming where reproducibility is important
• Scenarios where you want to avoid duplicate resources with the same content

Implementations

impl SHA1Name

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 other operations.

Example

let name1 = SHA1Name::new("document-content".to_string())?;
let name2 = SHA1Name::new("document-content".to_string())?;

// Same content produces the same ID
assert_eq!(name1.name(), name2.name());

pub fn as_str(&self) -> &str

Returns the string representation of this identifier.

Example

let name = SHA1Name::new("document-content".to_string())?;
let id_str = name.as_str();

// The string will be a deterministic ID based on the content
println!("SHA1 ID: {}", id_str);

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

Creates a new SHA1Name with the given value.

This method generates a deterministic, content-addressable identifier using the UUID v5 algorithm based on SHA1 hash. Unlike EntityRoot, the same input value will always produce the same ID, making it suitable for content-addressable resources.

Arguments

• value - The string value to use for generating the SHA1 hash

Validation Rules

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

Returns

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

Example

let name1 = SHA1Name::new("document-content".to_string())?;
let name2 = SHA1Name::new("document-content".to_string())?;

// Same content produces the same ID
assert_eq!(name1.to_string(), name2.to_string());

Trait Implementations

impl AsRef<MagicTypeId> for SHA1Name

fn as_ref(&self) -> &MagicTypeId

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

impl Clone for SHA1Name

fn clone(&self) -> SHA1Name

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SHA1Name

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

Formats the value using the given formatter.

impl Default for SHA1Name

fn default() -> SHA1Name

Returns the “default value” for a type.

impl Display for SHA1Name

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

Formats the value using the given formatter.

impl ErnComponent for SHA1Name

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<MagicTypeId> for SHA1Name

fn from(value: MagicTypeId) -> Self

Converts to this type from the input type.

impl From<SHA1Name> for MagicTypeId

fn from(value: SHA1Name) -> Self

Converts to this type from the input type.

impl FromStr for SHA1Name

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

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

Creates a SHA1Name from a string.

This method generates a deterministic, content-addressable identifier using the UUID v5 algorithm based on SHA1 hash. The same input string will always produce the same ID.

Arguments

• s - The string value to use for generating the SHA1 hash

Returns

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

Example

let name1 = SHA1Name::from_str("document-content")?;
let name2 = SHA1Name::new("document-content".to_string())?;

// FromStr and new() produce the same result for the same input
assert_eq!(name1.to_string(), name2.to_string());

type Err = ErnError

The associated error which can be returned from parsing.

impl Hash for SHA1Name

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 SHA1Name

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

fn partial_cmp(&self, other: &SHA1Name) -> 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 SHA1Name

impl StructuralPartialEq for SHA1Name