Struct Link

pub struct Link(pub(crate) String);

A normalized URL used as the redirect destination. This ensures that the link is a valid absolute HTTP(S) URL.

The resulting Link is guaranteed to have an http or https scheme, be an absolute URL, not have a password, and be properly percent encoded. Note that this doesn’t aim to make invalid URLs valid (e.g. by percent encoding non-ascii characters), but may normalize the provided URL (e.g. by decoding percent-encoded non-reserved characters or by lowercasing the host). Link should not be used to create a new, valid, properly encoded URL from user input, only to verify one, as it doesn’t provide much useful feedback or help with encoding an almost valid URL, nor does it do much useful guesswork.

Tuple Fields

0: String

Implementations

impl Link

pub(crate) const VALID_SCHEMES: &'static [&'static str]

Valid Link URL schemes

pub fn new(url: &str) -> Result<Self, LinkError>

Create a new Link, checking the provided string.

Errors

This returns an error if the passed url is invalid (LinkError::Invalid), has a password (LinkError::Unsafe), has an invalid scheme (LinkError::Scheme, valid schemes are http and https), or is not absolute (LinkError::Relative).

pub const fn new_unchecked(url: String) -> Self

Create a new Link without performing any checks.

Safety

This makes no guarantees about the contents of the Link, the validity of the link must be ensured some other way before calling this.

pub fn into_string(self) -> String

Returns the string this Link wraps, consuming self.

Trait Implementations

impl Clone for Link

fn clone(&self) -> Link

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Link

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Link

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Link

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

Formats the value using the given formatter.

impl From<Link> for String

fn from(link: Link) -> Self

Converts to this type from the input type.

impl FromRedis for Link

fn from_value(value: RedisValue) -> Result<Self, RedisError>

impl FromStr for Link

type Err = LinkError

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self, Self::Err>

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

impl Hash for Link

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

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 Link

fn cmp(&self, other: &Link) -> 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 for Link

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

fn partial_cmp(&self, other: &Link) -> 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 Link

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl TryFrom<&String> for Link

type Error = LinkError

The type returned in the event of a conversion error.

fn try_from(string: &String) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&str> for Link

type Error = LinkError

The type returned in the event of a conversion error.

fn try_from(string: &str) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<String> for Link

type Error = LinkError

The type returned in the event of a conversion error.

fn try_from(string: String) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for Link

impl StructuralPartialEq for Link