Struct Domain 

pub struct Domain(/* private fields */);

A domain.

Remarks

The validation of domains created by this type is very shallow. Proper validation is offloaded to other services such as DNS resolvers.

Implementations

impl Domain

pub const fn from_static(s: &'static str) -> Domain

Creates a domain at compile time.

This function requires the static string to be a valid domain

Panics

This function panics at compile time when the static string is not a valid domain.

pub fn example() -> Domain

Creates the example `Domain.

pub fn tld_private() -> Domain

Create an new apex Domain (TLD) meant for loopback purposes.

As proposed in https://itp.cdn.icann.org/en/files/security-and-stability-advisory-committee-ssac-reports/sac-113-en.pdf.

In specific this means that it will match on any domain with the TLD .internal.

pub fn tld_localhost() -> Domain

Creates the localhost Domain.

pub fn into_host(self) -> Host

Consumes the domain as a host.

pub fn is_fqdn(&self) -> bool

Returns true if this domain is a Fully Qualified Domain Name.

pub fn is_wildcard(&self) -> bool

Returns true if this domain is a wildcard domain.

pub fn is_tld(&self) -> bool

Returns true if this domain is Top-Level Domain (TLD).

Note that we consider a country-level TLD (ccTLD) such as org.uk also a TLD. That is we consider any ccTLD also TLD. While not technically correct, in practice it is at least for the purposes that we are aware of a non-meaningful distinction to make.

Example

use rama_net::address::Domain;

assert!(Domain::from_static("com").is_tld());
assert!(Domain::from_static(".com").is_tld());
assert!(Domain::from_static("co.uk").is_tld());

assert!(!Domain::from_static("example.com").is_tld());
assert!(!Domain::from_static("example.co.uk").is_tld());

pub fn is_sld(&self) -> bool

Returns true if this domain is Second-Level Domain (SLD).

Example

use rama_net::address::Domain;

assert!(!Domain::from_static("com").is_sld());
assert!(!Domain::from_static(".com").is_sld());
assert!(!Domain::from_static("co.uk").is_sld());
assert!(!Domain::from_static(".co.uk").is_sld());

assert!(Domain::from_static(".example.com").is_sld());
assert!(Domain::from_static(".example.co.uk").is_sld());

assert!(!Domain::from_static("foo.example.com").is_sld());
assert!(!Domain::from_static("foo.example.co.uk").is_sld());

pub fn as_wildcard_parent(&self) -> Option<Domain>

Returns the parent of this wildcard domain, in case it is indeed a wildcast domain, otherwise None is returned.

Use Self::is_wildcard if you just wish to check it is is a wildcard domain, as it is cheaper to use.

pub fn try_as_sub(&self, sub: impl AsDomainRef) -> Result<Domain, OpaqueError>

Try to create a subdomain from the current Domain with the given subdomain prefixed to it

pub fn try_as_wildcard(&self) -> Result<Domain, OpaqueError>

Promote this Domain to a wildcard.

E.g. turn example.com in *.example.com.

This can fail, e.g. because the domain becomes too long.

pub fn strip_sub(&self, prefix: impl AsDomainRef) -> Option<Domain>

Try to strip the subdomain (prefix) from the current domain.

pub fn is_sub_of(&self, other: &Domain) -> bool

Returns true if this Domain is a parent of the other.

Note that a Domain is a sub of itself.

pub fn is_parent_of(&self, other: &Domain) -> bool

Returns true if this Domain is a subdomain of the other.

Note that a Domain is a sub of itself.

pub fn have_same_registrable_domain(&self, other: &Domain) -> bool

Compare the registrable domain

Example

use rama_net::address::Domain;

assert!(Domain::from_static("www.example.com")
    .have_same_registrable_domain(&Domain::from_static("example.com")));

assert!(Domain::from_static("example.com")
    .have_same_registrable_domain(&Domain::from_static("www.example.com")));

assert!(Domain::from_static("a.example.com")
    .have_same_registrable_domain(&Domain::from_static("b.example.com")));

assert!(Domain::from_static("example.com")
    .have_same_registrable_domain(&Domain::from_static("example.com")));

pub fn suffix(&self) -> Option<&str>

Get the public suffix of the domain

Example

use rama_net::address::Domain;

assert_eq!(Some("com"), Domain::from_static("www.example.com").suffix());
assert_eq!(Some("co.uk"), Domain::from_static("site.co.uk").suffix());

pub fn len(&self) -> usize

Gets the length of domain

pub fn as_str(&self) -> &str

Gets the domain name as reference.

Trait Implementations

impl AsDomainRef for Domain

fn as_wildcard_parent(&self) -> Option<Domain>

impl AsRef<str> for Domain

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

impl Clone for Domain

fn clone(&self) -> Domain

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Domain

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Domain

fn deserialize<D>( deserializer: D, ) -> Result<Domain, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Domain

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl From<Domain> for ForwardedAuthority

fn from(value: Domain) -> ForwardedAuthority

Converts to this type from the input type.

impl From<Domain> for Host

fn from(domain: Domain) -> Host

Converts to this type from the input type.

impl From<Domain> for NodeId

fn from(domain: Domain) -> NodeId

Converts to this type from the input type.

impl FromStr for Domain

type Err = OpaqueError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Domain, <Domain as FromStr>::Err>

Parses a string s to return a value of this type.

impl Hash for Domain

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl Ord for Domain

fn cmp(&self, other: &Domain) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq<&str> for Domain

fn eq(&self, other: &&str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Domain> for &str

fn eq(&self, other: &Domain) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Domain> for String

fn eq(&self, other: &Domain) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<Domain> for str

fn eq(&self, other: &Domain) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<String> for Domain

fn eq(&self, other: &String) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq<str> for Domain

fn eq(&self, other: &str) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialEq for Domain

fn eq(&self, other: &Domain) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd<&str> for Domain

fn partial_cmp(&self, other: &&str) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Domain> for &str

fn partial_cmp(&self, other: &Domain) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Domain> for String

fn partial_cmp(&self, other: &Domain) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<Domain> for str

fn partial_cmp(&self, other: &Domain) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<String> for Domain

fn partial_cmp(&self, other: &String) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd<str> for Domain

fn partial_cmp(&self, other: &str) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl PartialOrd for Domain

fn partial_cmp(&self, other: &Domain) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Domain

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<'a> TryFrom<&'a [u8]> for Domain

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( name: &'a [u8], ) -> Result<Domain, <Domain as TryFrom<&'a [u8]>>::Error>

Performs the conversion.

impl TryFrom<String> for Domain

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from(name: String) -> Result<Domain, <Domain as TryFrom<String>>::Error>

Performs the conversion.

impl TryFrom<Vec<u8>> for Domain

type Error = OpaqueError

The type returned in the event of a conversion error.

fn try_from( name: Vec<u8>, ) -> Result<Domain, <Domain as TryFrom<Vec<u8>>>::Error>

Performs the conversion.

impl Eq for Domain

impl IntoDomain for Domain