Crate addr

Robust domain name parsing using the Public Suffix List

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

Examples

use addr::{dns, domain, Error};
use core::convert::TryFrom;

// You can find out the root domain
// or extension of any given domain name
let domain = domain::Name::try_from("www.example.com")?;
assert_eq!(domain.root(), "example.com");
assert_eq!(domain.suffix(), "com");

let punycode = idna::domain_to_ascii("www.食狮.中国")
  .map_err(|_| Error::InvalidDomain)?;
let domain = domain::Name::try_from(punycode.as_str())?;
assert_eq!(domain.root(), "xn--85x722f.xn--fiqs8s");
assert_eq!(domain.suffix(), "xn--fiqs8s");

let domain = domain::Name::try_from("www.xn--85x722f.xn--55qx5d.cn")?;
assert_eq!(domain.root(), "xn--85x722f.xn--55qx5d.cn");
assert_eq!(domain.suffix(), "xn--55qx5d.cn");

let domain = domain::Name::try_from("a.b.example.uk.com")?;
assert_eq!(domain.root(), "example.uk.com");
assert_eq!(domain.suffix(), "uk.com");

let name = dns::Name::try_from("_tcp.example.com.")?;
assert_eq!(name.root(), "example.com.");
assert_eq!(name.suffix(), "com.");

// In any case if the domain's suffix is in the list
// then this is definately a registrable domain name
assert!(domain.suffix_is_known());

Modules

dns
domain

Enums

Error

Type Definitions

Result