Struct Client 

pub struct Client { /* private fields */ }

A resilient HTTP client with retry, timeout, and typed JSON support.

Implementations

impl Client

pub fn new() -> Self

Create a new client with default settings.

pub fn builder() -> ClientBuilder

Start building a client with custom settings.

pub fn from_parts(inner: ClientWithMiddleware, base_url: Option<String>) -> Self

Construct a Client from a pre-built ClientWithMiddleware and an optional base URL.

This is useful when you need to attach custom middleware (e.g. a circuit breaker from an external registry) that fetch_kit’s builder does not natively support. Use Client::with_middleware to append further middleware to the chain after construction.

pub fn with_middleware(self, middleware: impl Middleware) -> Self

Append a middleware inside the existing chain (closest to the transport) and return the new client.

This is a composition point for already-built clients. When building from scratch, prefer ClientBuilder::with_middleware, which registers middleware outermost.

pub fn get(&self, url: impl Into<String>) -> RequestBuilder<'_>

Create a RequestBuilder for a GET request.

pub fn post(&self, url: impl Into<String>) -> RequestBuilder<'_>

Create a RequestBuilder for a POST request.

pub fn put(&self, url: impl Into<String>) -> RequestBuilder<'_>

Create a RequestBuilder for a PUT request.

pub fn delete(&self, url: impl Into<String>) -> RequestBuilder<'_>

Create a RequestBuilder for a DELETE request.

pub async fn get_json<T: DeserializeOwned>( &self, url: &str, ) -> Result<T, FetchError>

Perform a GET request and deserialize the JSON response (requires the json feature).

pub async fn post_json<B: Serialize, T: DeserializeOwned>( &self, url: &str, body: &B, ) -> Result<T, FetchError>

Perform a POST request with a JSON body and deserialize the JSON response (requires the json feature).

pub async fn fetch_with_fallback<T: DeserializeOwned>( &self, primary_url: &str, fallback_url: &str, ) -> Result<T, FetchError>

Fetch from primary_url; on failure, fall back to fallback_url (requires the json feature).

pub fn inner(&self) -> &ClientWithMiddleware

Access the inner middleware::ClientWithMiddleware.

The returned client shares this client’s connection pool and middleware chain; use middleware::ClientWithMiddleware::with_middleware (or Client::with_middleware) to compose further middleware onto it.

Trait Implementations

impl Clone for Client

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Client

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

Formats the value using the given formatter.

impl Default for Client

fn default() -> Self

Returns the “default value” for a type.