Struct SafeUrl 

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

A URL that has passed scheme + IP-blocklist validation.

Construction via SafeUrl::parse is the only way to satisfy this type; call sites that hold a SafeUrl proved they validated it.

Implementations

impl SafeUrl

pub async fn parse(s: &str, policy: IpPolicy) -> Result<Self, Error>

Parse s, require an http:// or https:// scheme, and reject if the host is a literal blocked IP, or if any IP that the host name resolves to is in the blocked set under policy.

DNS resolution uses tokio::net::lookup_host with the URL’s port (or the scheme’s default port). All resolved addresses are checked; if any resolved address is private, the URL is rejected.

Under IpPolicy::AllowPrivate, no IP check is performed (scheme check still applies).

pub fn as_str(&self) -> &str

Return the URL as a string slice.

pub fn into_url(self) -> Url

Consume this wrapper and return the inner Url.

Trait Implementations

impl Clone for SafeUrl

fn clone(&self) -> SafeUrl

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SafeUrl

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

Formats the value using the given formatter.