use_bond/
bond_endpoint.rs

1use std::fmt;
2
3use crate::BondValidationError;
4
5/// A validated atom endpoint reference for a bond.
6#[derive(Clone, Debug, Eq, Hash, Ord, PartialEq, PartialOrd)]
7pub struct BondEndpoint(String);
8
9impl BondEndpoint {
10    /// Creates a bond endpoint label.
11    ///
12    /// # Errors
13    ///
14    /// Returns [`BondValidationError::EmptyEndpointLabel`] when `label` is empty after trimming.
15    pub fn new(label: &str) -> Result<Self, BondValidationError> {
16        let trimmed = label.trim();
17        if trimmed.is_empty() {
18            Err(BondValidationError::EmptyEndpointLabel)
19        } else {
20            Ok(Self(trimmed.to_owned()))
21        }
22    }
23
24    /// Returns the endpoint label text.
25    #[must_use]
26    pub fn as_str(&self) -> &str {
27        &self.0
28    }
29
30    /// Consumes the endpoint and returns the owned label.
31    #[must_use]
32    pub fn into_string(self) -> String {
33        self.0
34    }
35}
36
37impl AsRef<str> for BondEndpoint {
38    fn as_ref(&self) -> &str {
39        self.as_str()
40    }
41}
42
43impl TryFrom<&str> for BondEndpoint {
44    type Error = BondValidationError;
45
46    fn try_from(value: &str) -> Result<Self, Self::Error> {
47        Self::new(value)
48    }
49}
50
51impl fmt::Display for BondEndpoint {
52    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
53        formatter.write_str(self.as_str())
54    }
55}
use_bond/bond_endpoint.rs

use_bond/
bond_endpoint.rs
