Robust domain name parsing and RFC compliant email address validation

Build Status Latest Version Docs

This library uses Mozilla's Public Suffix List to reliably parse domain names and email addresses in Rust. It will reliably check if a domain has valid syntax whether or not it is an internationalised domain name (IDN). It also checks the length restrictions for each label, total number of labels and full length of domain name.

You can supply your own list by setting the environment variable PSL_URL or PSL_PATH. You can also use the plural forms of those environment variables with the values separated by commas. The first successful list retrieved will be used. If you don't supply your own list, one will be downloaded for you from the official site during the build. If you are only interested in a few TLDs, you can pass them in as PSL_TLD or PSL_TLDS.

Examples

```rust extern crate addr;

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

fn main() -> Result<()> { // You can find out the root domain // or extension of any given domain name let domain: DomainName = "www.example.com".parse().unwrap(); asserteq!(domain.root(), "example.com"); asserteq!(domain.root().suffix(), "com");

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

let domain: DomainName = "www.xn--85x722f.xn--55qx5d.cn".parse()?;
assert_eq!(domain.root(), "xn--85x722f.xn--55qx5d.cn");
assert_eq!(domain.root().suffix(), "xn--55qx5d.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(), "xn-----8kcayoeblonkwzf2jqc1b.xn--p1ai");

// 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());

} ```

Use Cases

For those who work with domain names the use cases of this library are plenty. publicsuffix.org/learn lists quite a few. For the sake of brevity, I'm not going to repeat them here. I work for a domain registrar so we make good use of this library. Here are some of the ways this library can be used:-