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

extern crate addr;

use addr::{DomainName, DnsName, Email};

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

let domain: DomainName = "www.食狮.中国".parse()?;
assert_eq!(domain.root(), "食狮.中国.");
assert_eq!(domain.root().suffix(), "中国.");

let domain: DomainName = "www.xn--85x722f.xn--55qx5d.cn".parse()?;
assert_eq!(domain.root(), "公司.cn.");
assert_eq!(domain.root().suffix(), "cn.");

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

let name: DnsName = "_tcp.example.com.".parse()?;
assert_eq!(name.root(), "example.com.");
assert_eq!(name.root().suffix(), "com.");

let email: Email = "чебурашка@ящик-с-апельсинами.рф".parse()?;
assert_eq!(email.user(), "чебурашка");
assert_eq!(email.host(), "ящик-с-апельсинами.рф.");

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

Re-exports

pub use errors::Result;

pub use errors::Error;

Modules

errors

Errors returned by this library

Structs

DnsName	Holds information about a particular DNS name
DomainName
Email

Enums

Host	Holds information about a particular host