Enum RequestBuildErrorKind 

pub enum RequestBuildErrorKind {
    AuthPasswordRender(RenderError),
    AuthTokenRender(RenderError),
    AuthUsernameRender(RenderError),
    BodyFileStream(Error),
    BodyFormFieldRender {
        field: String,
        error: RenderError,
    },
    BodyMissing {
        previous_request_id: RequestId,
    },
    BodyRender(RenderError),
    BodyStream(RenderError),
    Build(Error),
    CurlInvalidUtf8(Utf8Error),
    HeaderInvalidName {
        header: String,
        error: InvalidHeaderName,
    },
    HeaderInvalidValue {
        header: String,
        error: InvalidHeaderValue,
    },
    HeaderRender {
        header: String,
        error: RenderError,
    },
    Json(JsonTemplateError),
    OverrideFormBody,
    QueryRender {
        parameter: String,
        error: RenderError,
    },
    RecipeUnknown(UnknownRecipeError),
    UrlInvalid {
        url: String,
        error: ParseError,
    },
    UrlRender(RenderError),
}

The various errors that can occur while building a request. This provides the error for RequestBuildError, which then attaches additional context.

Variants

AuthPasswordRender(RenderError)

Error rendering username in Basic auth

AuthTokenRender(RenderError)

Error rendering token in Bearer auth

AuthUsernameRender(RenderError)

Error rendering username in Basic auth

BodyFileStream(Error)

Error streaming directly from a file to a request body (via reqwest)

BodyFormFieldRender

Error rendering a body to bytes/stream

Fields

field: String

error: RenderError

BodyMissing

Attempted to build a new request from a previous request, but the old request doesn’t have a body saved

This happens if:

• Body was larger than HttpEngineConfig::large_body_size
• Body was streamed

Fields

previous_request_id: RequestId

BodyRender(RenderError)

Error rendering a body to bytes/stream

BodyStream(RenderError)

Error while streaming bytes for a body

Build(Error)

Error assembling the final request

CurlInvalidUtf8(Utf8Error)

Attempted to generate a cURL command for a request with non-UTF-8 values, which we don’t support representing in the generated command

HeaderInvalidName

Header name does not meet the HTTP spec

Fields

header: String

error: InvalidHeaderName

HeaderInvalidValue

Header name does not meet the HTTP spec

Fields

header: String

error: InvalidHeaderValue

HeaderRender

Header value does not meet the HTTP spec

Fields

header: String

error: RenderError

Json(JsonTemplateError)

Error parsing JSON override template

OverrideFormBody

Passed a full-body override template for a form body. This is disallowed; instead, overrides are applied by individual field

QueryRender

Error rendering query parameter

Fields

parameter: String

error: RenderError

RecipeUnknown(UnknownRecipeError)

Tried to build a recipe that doesn’t exist

UrlInvalid

URL rendered correctly but the result isn’t a valid URL

Fields

url: String

error: ParseError

UrlRender(RenderError)

Error rendering URL

Trait Implementations

impl Debug for RequestBuildErrorKind

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

Formats the value using the given formatter.

impl Display for RequestBuildErrorKind

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

Formats the value using the given formatter.

impl Error for RequestBuildErrorKind

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<Error> for RequestBuildErrorKind

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<JsonTemplateError> for RequestBuildErrorKind

fn from(source: JsonTemplateError) -> Self

Converts to this type from the input type.

impl From<UnknownRecipeError> for RequestBuildErrorKind

fn from(source: UnknownRecipeError) -> Self

Converts to this type from the input type.