Enum HostDetails

Source

pub enum HostDetails {
    Domain(DomainDetails),
    Ipv4(Ipv4Details),
    Ipv6(Ipv6Details),
}

Expand description

The details of a BetterUrl’s host.

Variants§

§

Domain(DomainDetails)

Details of a BetterUrl’s domain host.

§

Ipv4(Ipv4Details)

Details of a BetterUrl’s IPv4 host.

§

Ipv6(Ipv6Details)

Details of a BetterUrl’s IPv6 host.

Implementations§

Source §

impl HostDetails

Source

pub fn parse(host: &str) -> Result<Self, ParseError>

Gets the details of a host str.

§Errors

If the call to url::Host::parse returns an error, that error is returned.

§Examples

use better_url::*;

assert!(matches!(HostDetails::parse("example.com").unwrap(), HostDetails::Domain(_)));
assert!(matches!(HostDetails::parse("127.0.0.1"  ).unwrap(), HostDetails::Ipv4  (_)));
assert!(matches!(HostDetails::parse("[::1]"      ).unwrap(), HostDetails::Ipv6  (_)));

Source

pub fn from_ipv4_addr(addr: Ipv4Addr) -> Self

Gets the details of an Ipv4Addr host.

§Examples

use better_url::*;

assert!(matches!(HostDetails::from_ip_addr("127.0.0.1".parse().unwrap()), HostDetails::Ipv4(_)));

Source

pub fn from_ipv6_addr(addr: Ipv6Addr) -> Self

Gets the details of an Ipv6Addr host.

§Examples

use better_url::*;

assert!(matches!(HostDetails::from_ip_addr("::1".parse().unwrap()), HostDetails::Ipv6(_)));

Source

pub fn from_ip_addr(addr: IpAddr) -> Self

Gets the details of an IpAddr host.

§Examples

use better_url::*;

assert!(matches!(HostDetails::from_ip_addr("127.0.0.1".parse().unwrap()), HostDetails::Ipv4(_)));
assert!(matches!(HostDetails::from_ip_addr("::1"      .parse().unwrap()), HostDetails::Ipv6(_)));

Source

pub fn from_host<T: AsRef<str>>(host: &Host<T>) -> Self

Gets the details of a url::Host.

Assumes url::Host::Domain always contains valid domains, which isn’t true, but is true enough to work.

§Examples

use url::Host;
use better_url::*;

assert!(matches!(HostDetails::from_host(&Host::parse("example.com").unwrap()), HostDetails::Domain(_)));
assert!(matches!(HostDetails::from_host(&Host::parse("127.0.0.1"  ).unwrap()), HostDetails::Ipv4  (_)));
assert!(matches!(HostDetails::from_host(&Host::parse("[::1]"      ).unwrap()), HostDetails::Ipv6  (_)));

Source

pub fn from_url(url: &Url) -> Option<Self>

Gets the details of a url::Url.

Source

pub fn domain_details(&self) -> Option<&DomainDetails>

If self is Self::Domain, return it.

§Examples

use better_url::*;

assert!(matches!(HostDetails::parse("example.com").unwrap().domain_details(), Some(_)));
assert!(matches!(HostDetails::parse("127.0.0.1"  ).unwrap().domain_details(), None   ));
assert!(matches!(HostDetails::parse("[::1]"      ).unwrap().domain_details(), None   ));

Source

pub fn ipv4_details(&self) -> Option<&Ipv4Details>

If self is Self::Ipv4, return it.

§Examples

use better_url::*;

assert!(matches!(HostDetails::parse("example.com").unwrap().ipv4_details(), None   ));
assert!(matches!(HostDetails::parse("127.0.0.1"  ).unwrap().ipv4_details(), Some(_)));
assert!(matches!(HostDetails::parse("[::1]"      ).unwrap().ipv4_details(), None   ));

Source

pub fn ipv6_details(&self) -> Option<&Ipv6Details>

If self is Self::Ipv6, return it.

§Examples

use better_url::*;

assert!(matches!(HostDetails::parse("example.com").unwrap().ipv6_details(), None   ));
assert!(matches!(HostDetails::parse("127.0.0.1"  ).unwrap().ipv6_details(), None   ));
assert!(matches!(HostDetails::parse("[::1]"      ).unwrap().ipv6_details(), Some(_)));