Struct ClientBuilder 

pub struct ClientBuilder { /* private fields */ }

Builder for Client.

Implementations

impl ClientBuilder

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

Per-request timeout (covers connect, headers, and body read).

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

TCP-connect timeout, applied independently of the request timeout.

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

Override the User-Agent header sent on every request.

pub fn follow_redirects(self, follow: bool) -> Self

Toggle automatic redirect following. Defaults to true; disable when using crate::Signal::RedirectAbsent is undesirable for a run.

pub fn min_request_interval(self, interval: Duration) -> Self

Minimum time between consecutive requests to the same host.

Defaults to 100 ms (≈ 10 RPS per host) — enough headroom to avoid rate-limit responses on common OSINT targets while keeping fan-out across many sites fast.

pub fn max_rps(self, rps: NonZeroU32) -> Self

Cap the total request rate across all hosts to rps requests per second. Independent of (and composed with) the per-host interval — useful on a metered connection or behind a shared-quota proxy. Uncapped by default.

pub fn max_retries(self, n: u32) -> Self

Maximum retry attempts after a transient ban response. Defaults to 2 (so up to 3 total tries). Set to 0 to disable retry entirely.

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

Base delay for the first retry. Subsequent retries double until reaching Self::max_backoff_delay. Defaults to 500 ms.

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

Cap on a single backoff delay (pre-jitter). Defaults to 30 s.

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

Route all requests through a proxy. Accepts http://, https://, and socks5:// URLs. For Tor, pass socks5://127.0.0.1:9050.

pub fn rotate_user_agents(self, agents: Vec<String>) -> Self

Rotate the User-Agent header per request, picking uniformly at random from agents. An empty list (the default) keeps the single fixed User-Agent. Useful for reducing trivial fingerprinting.

pub fn enrich(self, enrich: bool) -> Self

Extract profile fields (per crate::Site::extract) from Found pages. Off by default; enables an extra body read for matching sites.

pub fn respect_robots(self, respect: bool) -> Self

Honor each host’s robots.txt: probes to disallowed paths are skipped (reported Uncertain, note robots_disallowed). Off by default. Adds one cached robots.txt fetch per origin.

pub fn browser(self, backend: Arc<dyn BrowserBackend>) -> Self

Attach a browser backend. Sites tagged bot-protected will be routed through it instead of the raw HTTP path, up to the browser_budget cap.

pub const fn browser_budget(self, cap: usize) -> Self

Per-scan cap on how many bot-protected sites are allowed to use the browser backend. Once exhausted, the rest fall back to Uncertain(BrowserBudget). Defaults to DEFAULT_BROWSER_BUDGET.

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

Build a Client.

Trait Implementations

impl Clone for ClientBuilder

fn clone(&self) -> ClientBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientBuilder

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

Formats the value using the given formatter.

impl Default for ClientBuilder

fn default() -> Self

Returns the “default value” for a type.