Enum trillium_http::Error

#[non_exhaustive]
pub enum Error {
    Io(Error),
    Url(ParseError),
    UnexpectedUriFormat,
    HeaderMissing(&'static str),
    RequestPathMissing,
    Closed,
    Httparse(Error),
    TryFromIntError(TryFromIntError),
    PartialHead,
    MalformedHeader(&'static str),
    UnsupportedVersion(u8),
    UnrecognizedMethod(String),
    MissingMethod,
    MissingStatusCode,
    UnrecognizedStatusCode(u16),
    MissingVersion,
    EncodingError(Utf8Error),
    UnexpectedHeader(&'static str),
    HeadersTooLong,
}

Concrete errors that occur within trillium’s http implementation

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.

Io(Error)

std::io::Error

Url(ParseError)

url::ParseError

UnexpectedUriFormat

this error describes a malformed request with a path that does not start with / or http:// or https://

HeaderMissing(&'static str)

the relevant http protocol expected this header, but it was not provided

RequestPathMissing

this error describes a request that does not specify a path

Closed

connection was closed

Httparse(Error)

httparse::Error

TryFromIntError(TryFromIntError)

TryFromIntError

PartialHead

an incomplete http head

MalformedHeader(&'static str)

we were unable to parse a header

UnsupportedVersion(u8)

async-h1 doesn’t speak this http version this error is deprecated

UnrecognizedMethod(String)

we were unable to parse this http method

MissingMethod

this request did not have a method

MissingStatusCode

this request did not have a status code

UnrecognizedStatusCode(u16)

we were unable to parse this http method

MissingVersion

this request did not have a version, but we expect one this error is deprecated

EncodingError(Utf8Error)

we expected utf8, but there was an encoding error

UnexpectedHeader(&'static str)

we received a header that does not make sense in context

HeadersTooLong

for security reasons, we do not allow request headers beyond 8kb.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

The lower-level source of this error, if any.

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(source: Error) -> Self

Performs the conversion.

impl From<ParseError> for Error

fn from(source: ParseError) -> Self

Performs the conversion.

impl From<TryFromIntError> for Error

fn from(source: TryFromIntError) -> Self

Performs the conversion.

impl From<Utf8Error> for Error

fn from(source: Utf8Error) -> Self

Performs the conversion.