Skip to main content

rustls_letsencrypt/
domain.rs

1use std::{fmt, str::FromStr};
2
3use serde::{Deserialize, Serialize};
4
5use crate::{Error, Result};
6
7#[derive(Clone, Eq, Hash, Ord, PartialEq, PartialOrd, Serialize, Deserialize)]
8#[serde(transparent)]
9pub struct DnsName(String);
10
11impl DnsName {
12    pub fn parse(value: impl AsRef<str>) -> Result<Self> {
13        let raw = value.as_ref().trim_end_matches('.');
14        if raw.is_empty() || raw.parse::<std::net::IpAddr>().is_ok() {
15            return Err(Error::InvalidDnsName(value.as_ref().to_owned()));
16        }
17        let ascii = idna::domain_to_ascii(raw)
18            .map_err(|_| Error::InvalidDnsName(value.as_ref().to_owned()))?
19            .to_ascii_lowercase();
20        if ascii.len() > 253
21            || ascii.split('.').any(|label| {
22                label.is_empty()
23                    || label.len() > 63
24                    || label.starts_with('-')
25                    || label.ends_with('-')
26                    || !label.bytes().all(|b| b.is_ascii_alphanumeric() || b == b'-')
27            })
28        {
29            return Err(Error::InvalidDnsName(value.as_ref().to_owned()));
30        }
31        Ok(Self(ascii))
32    }
33
34    #[must_use]
35    pub fn as_str(&self) -> &str {
36        &self.0
37    }
38}
39
40impl fmt::Debug for DnsName {
41    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
42        f.debug_tuple("DnsName").field(&self.0).finish()
43    }
44}
45
46impl fmt::Display for DnsName {
47    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
48        f.write_str(&self.0)
49    }
50}
51
52impl FromStr for DnsName {
53    type Err = Error;
54    fn from_str(s: &str) -> Result<Self> {
55        Self::parse(s)
56    }
57}
58
59#[cfg(test)]
60mod tests {
61    use super::*;
62    #[test] fn normalizes_case_and_dot() { assert_eq!(DnsName::parse("ExAmPle.COM.").unwrap().as_str(), "example.com"); }
63    #[test] fn rejects_ip_and_bad_labels() { assert!(DnsName::parse("127.0.0.1").is_err()); assert!(DnsName::parse("-bad.example").is_err()); }
64}