Struct Client 

pub struct Client<R: Runtime> { /* private fields */ }

HTTP client with connection pooling, TLS, and automatic redirect handling.

Implementations

impl<R: Runtime> Client<R>

pub fn builder() -> ClientBuilder<R>

Create a new ClientBuilder with default settings.

pub fn new() -> Self

Create a new client with default settings.

pub fn with_rustls() -> Self

Create a client with rustls TLS using WebPKI root certificates.

pub fn with_native_roots() -> Self

Create a client with rustls TLS using the system’s native root certificates.

pub fn with_http3() -> Self

Create a client configured for HTTP/3 with rustls.

pub fn with_alt_svc_h3() -> Self

Create a client that upgrades to HTTP/3 via Alt-Svc discovery.

pub fn get(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a GET request to the given URL.

pub fn head(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a HEAD request to the given URL.

pub fn post(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a POST request to the given URL.

pub fn put(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a PUT request to the given URL.

pub fn patch(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a PATCH request to the given URL.

pub fn delete(&self, uri: &str) -> Result<RequestBuilder<'_, R>, Error>

Start a DELETE request to the given URL.

pub fn request( &self, method: Method, uri: &str, ) -> Result<RequestBuilder<'_, R>, Error>

Start a request with the given method and URL.

pub fn chunk_download(&self, url: &str) -> ChunkDownload<R>

Start a parallel chunk download for the given URL.

pub fn forward<B>(&self, request: Request<B>) -> ForwardBuilder<'_, R, B>

where B: Body<Data = Bytes> + Send + 'static, B::Error: Into<Box<dyn Error + Send + Sync>>,

Forward an incoming HTTP request to an upstream server.

This is the entry point for proxy/gateway use cases. The forwarded request bypasses all client middleware (redirects, cookies, cache, decompression) and streams the body directly to the upstream.

pub fn bandwidth_limiter(&self) -> Option<&BandwidthLimiter>

Returns the bandwidth limiter if one was configured via ClientBuilder::max_download_speed.

Trait Implementations

impl<R: Runtime> Clone for Client<R>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<R: Runtime> Debug for Client<R>

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

Formats the value using the given formatter.

impl<R: Runtime> Default for Client<R>

fn default() -> Self

Returns the “default value” for a type.