Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for Client.

Configures transport: TLS, timeouts, socket options. Protocol configuration (host, headers, base path) lives on RequestWriter.

Implementations

impl ClientBuilder

pub fn new() -> Self

Create a new builder with defaults.

pub fn tls(self, config: &TlsConfig) -> Self

Set a custom TLS configuration.

If not set, https:// URLs use TlsConfig::new() (system defaults).

pub fn disable_nagle(self) -> Self

Set TCP_NODELAY (disable Nagle’s algorithm).

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

TCP connect timeout.

pub fn read_timeout(self, d: Duration) -> Self

Socket read timeout.

pub fn connect( self, url: &str, ) -> Result<Client<MaybeTls<TcpStream>>, RestError>

Connect to an HTTP(S) endpoint (blocking).

TLS is auto-detected from the URL scheme. When the tls feature is enabled, returns Client<MaybeTls<TcpStream>> — https:// uses MaybeTls::Tls, http:// uses MaybeTls::Plain. Without the tls feature, returns Client<TcpStream> and errors on https://.

pub fn connect_with<S: Read + Write>( self, stream: S, url: &str, ) -> Result<Client<S>, RestError>

Connect using a pre-connected socket.

The stream must already handle TLS if connecting to https://. For example, pass a TlsStream<TcpStream> or MaybeTls<TcpStream>.

pub fn writer_for(url: &str) -> Result<RequestWriter, RestError>

Create a RequestWriter configured for this URL.

Convenience: extracts host and path from the URL to create a writer with the correct Host header and base path.

Trait Implementations

impl Default for ClientBuilder

fn default() -> Self

Returns the “default value” for a type.