Enum UrlSafetyError 

#[non_exhaustive]
pub enum UrlSafetyError {
    InvalidUrl,
    LimitExceeded {
        limit: UrlSafetyLimit,
        actual: usize,
        max: usize,
    },
    Rejected {
        status: u16,
    },
    Transient {
        retry_after: Option<Duration>,
    },
    Provider(String),
}

URL-safety failures, mapped by the adapter from provider responses.

No variant carries the checked URL. It names the caller’s next step, and an error string is one format! away from a log line. The one variant carrying provider text is sanitized in Display, the way MailError’s and PushError’s are (issue #235): Display runs it through crate::logging::scrub_text, so every tracing field, problem detail and report line that renders the error gets the sanitized text. Debug still shows the raw string for tests.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidUrl

The input does not parse as a URL, or its scheme is not http or https: nothing was sent anywhere. The offending text is deliberately not carried.

LimitExceeded

A local ceiling was crossed and the provider was never called.

Fields

limit: UrlSafetyLimit

actual: usize

max: usize

Rejected

The provider refused the request (a 4xx); not retryable without a change. The status only — never the URL that drew it.

Fields

status: u16

Transient

Retryable (a 5xx, a 429, a transport error); wait out retry_after when the provider named one.

Fields

retry_after: Option<Duration>

Provider(String)

The provider failed on its side, in its own (scrubbed) words.

Implementations

impl UrlSafetyError

pub fn retry_after(&self) -> Option<Duration>

The provider-named back-off, where there was one.

Trait Implementations

impl Clone for UrlSafetyError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UrlSafetyError

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

Formats the value using the given formatter.

impl Display for UrlSafetyError

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

Formats the value using the given formatter.

impl Eq for UrlSafetyError

impl Error for UrlSafetyError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for UrlSafetyError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for UrlSafetyError