Enum HostDetails 

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

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

impl HostDetails

pub fn parse(host: &str) -> Result<HostDetails, 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  (_)));

pub fn from_ipv4_addr(addr: Ipv4Addr) -> HostDetails

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

pub fn from_ipv6_addr(addr: Ipv6Addr) -> HostDetails

Gets the details of an Ipv6Addr host.

Examples

use better_url::*;

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

pub fn from_ip_addr(addr: IpAddr) -> HostDetails

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

pub fn from_host<T>(host: &Host<T>) -> HostDetails

where T: AsRef<str>,

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

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

Gets the details of a url::Url.

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

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

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

Trait Implementations

impl Clone for HostDetails

fn clone(&self) -> HostDetails

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HostDetails

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for HostDetails

fn deserialize<__D>( __deserializer: __D, ) -> Result<HostDetails, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<DomainDetails> for HostDetails

fn from(value: DomainDetails) -> HostDetails

Converts to this type from the input type.

impl From<Ipv4Details> for HostDetails

fn from(value: Ipv4Details) -> HostDetails

Converts to this type from the input type.

impl From<Ipv6Details> for HostDetails

fn from(value: Ipv6Details) -> HostDetails

Converts to this type from the input type.

impl FromStr for HostDetails

type Err = ParseError

The associated error which can be returned from parsing.

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

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

impl PartialEq for HostDetails

fn eq(&self, other: &HostDetails) -> 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 Serialize for HostDetails

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 TryFrom<HostDetails> for DomainDetails

type Error = HostIsNotDomain

The type returned in the event of a conversion error.

fn try_from( value: HostDetails, ) -> Result<DomainDetails, <DomainDetails as TryFrom<HostDetails>>::Error>

Performs the conversion.

impl TryFrom<HostDetails> for Ipv4Details

type Error = HostIsNotIpv4

The type returned in the event of a conversion error.

fn try_from( value: HostDetails, ) -> Result<Ipv4Details, <Ipv4Details as TryFrom<HostDetails>>::Error>

Performs the conversion.

impl TryFrom<HostDetails> for Ipv6Details

type Error = HostIsNotIpv6

The type returned in the event of a conversion error.

fn try_from( value: HostDetails, ) -> Result<Ipv6Details, <Ipv6Details as TryFrom<HostDetails>>::Error>

Performs the conversion.

impl Copy for HostDetails

impl Eq for HostDetails

impl StructuralPartialEq for HostDetails