Enum flawless_http::Error

pub enum Error {
    Status(u16, Response),
    Transport(Transport),
}

A request error.

There are two types of errors that can happen when a request is performed:

1. Status code errors

Every response with a status code >= 400 is considered an error. In this case, the error enum will contain the full Response.

2. Transport protocol errors

This kind of error happens in cases when there is a connection problem (e.g. connection refused) or a response can’t be parsed.

Variants

Status(u16, Response)

A response was successfully received but had status code >= 400. Values are (status_code, Response).

Transport(Transport)

There was an error making the request or receiving the response.

Implementations

impl Error

pub fn kind(&self) -> ErrorKind

Error kind.

If the response status code is >=400, the error will be of kind ErrorKind::StatusCode. All other kinds describe a transport protocol error.

use flawless_http::{get, ErrorKind};

let response = get("http://httpbin.org/status/500").send();
assert_eq!(response.unwrap_err().kind(), ErrorKind::StatusCode);

pub fn message(&self) -> Option<String>

Contains an error message providing more information about the error, if available.

Status code error message:

use flawless_http::get;

let response = get("http://httpbin.org/status/500").send();
assert_eq!(
  response.unwrap_err().message(),
  Some("Server returned status code 500".to_owned())
);

Timeout error message:

use std::time::Duration;
use flawless_http::get;

let response = get("http://httpbin.org/delay/2")
                 .timeout(Duration::from_secs(1))
                 .send();
let err_msg = response.unwrap_err().message().unwrap();
assert!(err_msg.contains("timed out"));

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl From<HttpError> for Error

fn from(value: HttpError) -> Self

Converts to this type from the input type.

impl PartialEq for Error

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for Error

impl StructuralPartialEq for Error