Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for configuring Truthlinked API client

Provides a fluent interface for configuring all client options including timeouts, retries, logging, custom headers, and security settings.

Example

use truthlinked_sdk::ClientBuilder;
use std::time::Duration;
 
let client = ClientBuilder::new("https://api.truthlinked.org", "tl_free_...")
    .timeout(Duration::from_secs(60))
    .retries(5)
    .user_agent("MyApp/1.0")
    .header("X-Request-ID", "12345")?
    .enable_logging()
    .build()?;

Implementations

impl ClientBuilder

pub fn new(base_url: impl Into<String>, license_key: impl Into<String>) -> Self

Create a new client builder

Arguments

• base_url - API base URL (must be HTTPS)
• license_key - Your Truthlinked license key

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

Set request timeout

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

Set connection timeout

pub fn retry_config(self, config: RetryConfig) -> Self

Set retry configuration

pub fn retries(self, max_attempts: u32) -> Self

Set number of retry attempts (convenience method)

pub fn logging_config(self, config: LoggingConfig) -> Self

Set logging configuration

pub fn enable_logging(self) -> Self

Enable development logging (convenience method)

pub fn disable_logging(self) -> Self

Disable all logging (convenience method)

pub fn header( self, name: impl AsRef<str>, value: impl AsRef<str>, ) -> Result<Self>

Add custom header

pub fn user_agent(self, user_agent: impl Into<String>) -> Self

Set User-Agent header

pub fn proxy(self, proxy_url: impl Into<String>) -> Self

Set HTTP proxy URL

pub fn pool_config( self, max_idle_per_host: usize, idle_timeout: Duration, ) -> Self

Set connection pool configuration

pub fn gzip(self, enable: bool) -> Self

Enable/disable gzip compression

pub fn brotli(self, enable: bool) -> Self

Enable/disable brotli compression

pub fn certificate_pin(self, pin: impl Into<String>) -> Self

Add certificate pin for enhanced security

Arguments

• pin - SHA256 hash of the certificate’s public key (base64 encoded)

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

Build the configured client

impl ClientBuilder

Convenience methods for common configurations

pub fn production( base_url: impl Into<String>, license_key: impl Into<String>, ) -> Self

Production configuration with minimal logging and conservative timeouts

pub fn development( base_url: impl Into<String>, license_key: impl Into<String>, ) -> Self

Development configuration with verbose logging and shorter timeouts

pub fn testing( base_url: impl Into<String>, license_key: impl Into<String>, ) -> Self

Testing configuration with no retries and no logging

Trait Implementations

impl Debug for ClientBuilder

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

Formats the value using the given formatter.