Module raw

“Raw” HTTP client APIs.

The conjure_runtime::Client wraps a raw HTTP client, which is used to handle the actual HTTP communication. A default raw client is provided, but this can be overridden if desired.

Behavior

The raw client interacts directly with the http::Request and http::Response types, with a body type implementing the http_body::Body trait rather than using the AsyncBody type. The request’s URI is provided in absolute-form, and all headers have already been set in the header map. The HTTP response should be returned directly, without any interpretation of the status code, handling of redirects, etc.

A raw client is expected to implement Service<Request<RawBody>, Response = Response<B>>, where B implements the http_body::Body trait. The error type returned by the client must implement Into<Box<dyn Error + Sync + Send>> and be safe-loggable.

Some configuration set in the Builder affects the raw client, including the connect timeout, security configuration, and proxy configuration. The default raw client respects these settings, but other implementations will need to handle them on their own.

Structs

BodyError

The error type returned by RawBody.

DefaultRawBody

The body type used by DefaultRawClient.

DefaultRawClient

The default raw client implementation used by conjure_runtime.

DefaultRawClientBuilder

The default raw client builder used by conjure_runtime.

DefaultRawError

The error type used by DefaultRawClient.

RawBody

The request body type passed to the raw HTTP client.

Traits

BuildRawClient

A factory of raw HTTP clients.

Service

An asynchronous function from request to response.