Struct Client 

pub struct Client { /* private fields */ }

Traced outbound HTTP client with automatic retries and test-mock support.

Extracted from AppState via Axum’s extractor machinery — declare it as a handler parameter to get a pre-configured instance that respects [http.client] config and, in test builds, intercepts requests against any registered mocks.

use autumn_web::prelude::*;
use autumn_web::http::Client;

#[get("/ping-upstream")]
async fn ping(client: Client) -> AutumnResult<&'static str> {
    client.get("https://api.example.com/health").send().await?;
    Ok("ok")
}

You can also construct a standalone client outside of a handler:

use autumn_web::http::Client;

let client = Client::new();

Implementations

impl Client

pub fn new() -> Self

Create a new client with default settings (30 s timeout, 3 retries on idempotent methods).

pub fn with_timeout(timeout: Duration) -> Self

Create a client with a custom per-request timeout.

Panics

Panics if the underlying TLS backend cannot be initialised (should not happen with the default rustls-tls feature).

pub fn from_config(config: &HttpClientConfig) -> Self

Create a client from [http.client] framework configuration.

Panics

Panics if the underlying TLS backend cannot be initialised (should not happen with the default rustls-tls feature).

pub fn named(&self, alias: &str) -> Self

Return a clone of this client scoped to the named alias.

When a [http.client.base_urls] entry exists for the alias the client will prepend that URL to all relative paths. Mocks registered for the alias via TestApp::http_mock will match requests made through this named client.

pub fn with_base_url(&self, base_url: impl Into<String>) -> Self

Set (or override) the base URL prepended to relative request paths.

pub fn get(&self, url: impl AsRef<str>) -> RequestBuilder

Build a GET request.

pub fn post(&self, url: impl AsRef<str>) -> RequestBuilder

Build a POST request.

pub fn put(&self, url: impl AsRef<str>) -> RequestBuilder

Build a PUT request.

pub fn patch(&self, url: impl AsRef<str>) -> RequestBuilder

Build a PATCH request.

pub fn delete(&self, url: impl AsRef<str>) -> RequestBuilder

Build a DELETE request.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Client

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.

impl FromRequestParts<AppState> for Client

type Rejection = Infallible

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( _parts: &mut Parts, state: &AppState, ) -> Result<Self, Infallible>

Perform the extraction.