2 stable releases

1.0.1 Jan 10, 2024
1.0.0 Feb 24, 2023

#7 in #tld

Download history 13/week @ 2024-11-13 19/week @ 2024-11-20 1/week @ 2024-11-27 6/week @ 2024-12-04 40/week @ 2024-12-11 10/week @ 2024-12-18 24/week @ 2025-01-01 37/week @ 2025-01-08 10/week @ 2025-01-22 45/week @ 2025-01-29 48/week @ 2025-02-05 30/week @ 2025-02-19 48/week @ 2025-02-26

135 downloads per month

MIT license

45KB
437 lines

dns_name

Robust domain name parsing using the Public Suffix List

This library allows you to easily and accurately parse any given domain name.

let list = List::from_path("suffix-list.txt").unwrap();

let domain = list.parse_dns_name("www.example.com")?;
assert_eq!(domain.name(), "www.example.com");
assert_eq!(domain.rname(), "moc.elpmaxe.www");
assert_eq!(domain.root(), Some("example.com"));
assert_eq!(domain.suffix(), Some("com"));
assert_eq!(domain.registrable(), Some("example"));

// 2-level TLD
let domain = list.parse_dns_name("wWw.BlUeCaTnEtWoRkS.Uk.CoM.")?;
assert_eq!(domain.name(), "www.bluecatnetworks.uk.com.");
assert_eq!(domain.rname(), ".moc.ku.skrowtentaceulb.www");
assert_eq!(domain.root(), Some("bluecatnetworks.uk.com."));
assert_eq!(domain.suffix(), Some("uk.com."));
assert_eq!(domain.registrable(), Some("bluecatnetworks"));

// the root name
let domain = list.parse_dns_name(".")?;
assert_eq!(domain.name(), ".");
assert_eq!(domain.rname(), ".");
assert_eq!(domain.root(), None);
assert_eq!(domain.suffix(), None);
assert_eq!(domain.registrable(), None);

Dependencies

~7MB
~125K SLoC