rustls_letsencrypt/
domain.rs1use 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}