Struct UreqHttpClient 

pub struct UreqHttpClient { /* private fields */ }

Available on crate feature ureq-client only.

HTTP client implementation using ureq for synchronous HTTP requests. Since ureq is blocking, all requests are wrapped in tokio::task::spawn_blocking.

Implementations

impl UreqHttpClient

pub fn new() -> UreqHttpClient

pub fn with_agent(agent: Agent) -> UreqHttpClient

Create a client with a pre-configured ureq::Agent.

This lets you configure proxy support, custom TLS, timeouts, or any other agent-level settings externally.

pub fn with_max_body_bytes(self, max_body_bytes: u64) -> UreqHttpClient

Override the per-response cap for UreqHttpClient::execute and UreqHttpClient::execute_streaming. Set to u64::MAX to disable; a hostile server can then exhaust memory.

Trait Implementations

impl Clone for UreqHttpClient

fn clone(&self) -> UreqHttpClient

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UreqHttpClient

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

Formats the value using the given formatter.

impl Default for UreqHttpClient

fn default() -> UreqHttpClient

Returns the “default value” for a type.

impl HttpClient for UreqHttpClient

fn execute<'life0, 'async_trait>( &'life0 self, request: HttpRequest, ) -> Pin<Box<dyn Future<Output = Result<HttpResponse, Error>> + Send + 'async_trait>>

where 'life0: 'async_trait, UreqHttpClient: 'async_trait,

Executes a given HTTP request and returns the response, non-2xx included.

fn supports_streaming(&self) -> bool

Whether this client supports synchronous streaming downloads.

fn execute_streaming( &self, request: HttpRequest, ) -> Result<StreamingHttpResponse, Error>

Synchronous streaming variant — returns a reader over the response body. Must be called from a blocking context.

fn supports_upload_streaming(&self) -> bool

Whether this client can stream a request body from a reader (upload).

fn execute_upload( &self, request: HttpRequest, body: Box<dyn Read + Send>, content_length: u64, ) -> Result<HttpResponse, Error>

Synchronous streaming upload: send body (exactly content_length bytes) as the request body. Implementations MUST set an explicit Content-Length rather than chunked transfer-encoding. Any body set on request is ignored. Must be called from a blocking context.

fn resource_report(&self) -> Option<HttpResourceReport>

Best-effort per-session footprint of this client: idle connection-pool buffers plus any in-flight download/media buffering the impl can see. None by default; ureq/reqwest-backed clients report what their (limited) introspection allows. Media downloads are a real transient-RAM source, so a coarse estimate is still worth reporting.