Struct HttpTransportBuilder 

pub struct HttpTransportBuilder { /* private fields */ }

Builds an HttpTransport.

Header values are validated when HttpTransportBuilder::build is called, so a chain of setters stays a chain and does not thread a Result through every step.

Implementations

impl HttpTransportBuilder

pub fn new(url: impl AsRef<str>) -> Self

A builder for an agent at url.

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

Adds a header to every request — an API key, a tenant id, a trace header.

pub fn headers<K, V>(self, headers: impl IntoIterator<Item = (K, V)>) -> Self

where K: Into<String>, V: Into<String>,

Adds several headers.

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

Bounds the whole run: connecting, headers, and streaming the body.

An agent that thinks for longer than this has its stream cut off, so a long-running agent wants HttpTransportBuilder::connect_timeout instead.

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

Bounds only connection setup, leaving the stream itself unbounded.

pub fn client(self, client: Client) -> Self

Uses a caller-supplied client, for proxies, custom TLS roots, or a connection pool shared with the rest of an application.

pub fn build(self) -> Result<HttpTransport>

Builds the transport.

Errors

Error::Config when the URL, a header name, or a header value is not valid, or when the HTTP client cannot be built.

Trait Implementations

impl Clone for HttpTransportBuilder

fn clone(&self) -> HttpTransportBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for HttpTransportBuilder

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

Formats the value using the given formatter.