53 releases
new 0.11.1 | Jul 25, 2024 |
---|---|
0.10.2 | May 2, 2024 |
0.10.1 | Mar 21, 2024 |
0.9.3 | Dec 28, 2023 |
0.4.2 | Jul 29, 2021 |
#2 in #hostname
105KB
677 lines
Adbyss: Public Suffix
This library contains a single public-facing struct — adbyss_psl::Domain
— used for validating and normalizing Internet hostnames, like "www.domain.com".
It will:
- Validate, normalize, and Puny-encode internationalized/Unicode labels (RFC 3492);
- Validate and normalize the public suffix;
- Ensure conformance with RFC 1123;
- And locate the boundaries of the subdomain (if any), root (required), and suffix (required);
Examples
New instances of Domain
can be initialized using either Domain::new
or TryFrom<&str>
.
use adbyss_psl::Domain;
// These are equivalent and fine:
assert!(Domain::new("www.MyDomain.com").is_some());
assert!(Domain::try_from("www.MyDomain.com").is_ok());
// The following is valid DNS, but invalid as an Internet hostname:
assert!(Domain::new("_acme-challenge.mydomain.com").is_none());
Valid Internet hostnames must be no longer than 253 characters, and contain both root and (valid) suffix components.
Their labels — the bits between the dots — must additionally:
- Be no longer than 63 characters;
- (Ultimately) contain only ASCII letters, digits, and
-
; - Start and end with an alphanumeric character;
Unicode/internationalized labels are allowed, but must be Puny-encodable and not contain any conflicting bidirectionality constraints. Domain
will encode such labels using Punycode when it finds them, ensuring the resulting hostname will always be ASCII-only.
Post-parsing, Domain
gives you access to each individual component, or the whole thing:
use adbyss_psl::Domain;
let dom = Domain::new("www.MyDomain.com").unwrap();
// Pull out the pieces if you're into that sort of thing.
assert_eq!(dom.host(), "www.mydomain.com");
assert_eq!(dom.subdomain(), Some("www"));
assert_eq!(dom.root(), "mydomain");
assert_eq!(dom.suffix(), "com");
assert_eq!(dom.tld(), "mydomain.com");
// If you just want the sanitized host back as an owned value, use
// `Domain::take`:
let owned = dom.take(); // "www.mydomain.com"
Optional Crate Features
serde
: Enables serialization/deserialization support.
License
Copyright © 2024 Blobfolio, LLC <hello@blobfolio.com>
This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.
Dependencies
~4.5MB
~79K SLoC