Enum ParseError 

pub enum ParseError {
    Empty,
    UnsupportedScheme(String),
    InvalidUrl(ParseError),
    MissingHost,
    MissingBucket,
    MissingContainer,
    MissingAccount,
    InvalidBucket(String),
    InvalidAccount(String),
    InvalidContainer(String),
    CleartextHttpForbidden {
        host: String,
    },
    UnknownAddressing(String),
    InvalidFlagValue {
        name: String,
        value: String,
    },
    UnknownFlag(String),
    UnknownEngine(String),
    InvalidAwsS3Endpoint {
        host: String,
    },
    BundleUriPresignTtlTooLarge {
        value: u64,
        max: u64,
    },
}

Errors produced by parse.

Variants

Empty

Input was empty or whitespace-only.

UnsupportedScheme(String)

Scheme is not one of the four accepted values.

InvalidUrl(ParseError)

The body after the backend prefix could not be parsed as a URL.

MissingHost

URL is missing a host component.

MissingBucket

S3 path-style URL is missing the first path segment (the bucket).

MissingContainer

Azure virtual-hosted URL is missing the first path segment (the container) — or path-style is missing the second path segment.

MissingAccount

Azure path-style URL is missing the first path segment (the account).

InvalidBucket(String)

Bucket name does not match the S3 charset rules in §3.5.

InvalidAccount(String)

Storage-account name does not match the Azure rules in §3.5.

InvalidContainer(String)

Container name does not match the Azure rules in §3.5.

CleartextHttpForbidden

Cleartext *+http:// against a non-loopback host without the override env var.

Fields

host: String

The non-loopback host that triggered the rejection.

UnknownAddressing(String)

?addressing= value other than path or virtual.

InvalidFlagValue

A known flag had a value outside its accepted set.

Fields

name: String

Flag name.

value: String

Offending value.

UnknownFlag(String)

A query parameter is not part of the documented flag set.

UnknownEngine(String)

?engine= value is not a recognised engine name.

InvalidAwsS3Endpoint

An amazonaws.com hostname that cannot be a valid S3 endpoint.

Valid patterns are:

• virtual-hosted: <bucket>.s3[.<region>].amazonaws.com
• path-style: s3[.<region>|-<region>].amazonaws.com

Fields

host: String

The offending hostname.

BundleUriPresignTtlTooLarge

?bundle_uri_presign_ttl=<seconds> exceeded [MAX_BUNDLE_URI_PRESIGN_TTL_SECONDS] (7 days). Rejecting at the URL boundary prevents a degenerate value from reaching the AWS SDK (which rejects > 7 days anyway) or the Azure SAS builder (which previously panicked on u64::MAX). Issue #219.

Fields

value: u64

The offending value.

max: u64

The maximum accepted value ([MAX_BUNDLE_URI_PRESIGN_TTL_SECONDS]).

Trait Implementations

impl Debug for ParseError

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

Formats the value using the given formatter.

impl Display for ParseError

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

Formats the value using the given formatter.

impl Error for ParseError

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 From<ParseError> for ParseError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl From<ParseError> for RemoteError

fn from(source: ParseError) -> Self

Converts to this type from the input type.

impl PartialEq for ParseError

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

impl StructuralPartialEq for ParseError