Struct PendingRequest 

pub struct PendingRequest { /* private fields */ }

A request being built.

Implementations

impl PendingRequest

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a header.

pub fn bearer(self, token: impl Display) -> Self

Authorization: Bearer ….

pub fn accept_json(self) -> Self

Accept: application/json.

pub fn json<T: Serialize>(self, value: &T) -> Result<Self>

Send value as a JSON body.

Errors

If it will not serialise — reported here rather than at send, so the failure is next to the value that caused it.

pub fn body(self, body: impl Into<Vec<u8>>) -> Self

Send these bytes.

pub fn form(self, fields: &[(&str, &str)]) -> Self

Send a form-encoded body.

pub fn timeout(self, timeout: Duration) -> Self

How long to wait before giving up.

Thirty seconds by default. A request with no timeout is one that can hold a worker forever when the other end stops answering without closing, which is the failure mode that takes a queue down.

pub fn without_timeout(self) -> Self

Wait indefinitely.

Almost never right; see timeout.

pub fn retry(self, attempts: u32, backoff: Backoff) -> Self

Try up to attempts times, waiting per backoff.

Only failures worth repeating are repeated — see is_retryable, and read it before assuming a 422 will be retried, because it will not.

pub fn through(self, transport: Arc<dyn Transport>) -> Self

Send through this transport rather than the installed one.

For a caller holding its own client — a different proxy, a pinned certificate — without changing what the rest of the process does.

pub async fn send(self) -> Result<HttpResponse>

Send it.

Returns Ok for any response that arrived, including a 500 — see HttpResponse::error_for_status. Err means nothing came back at all after every attempt.

Trait Implementations

impl Debug for PendingRequest

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

Formats the value using the given formatter.