Struct HttpKindBuilder 

pub struct HttpKindBuilder { /* private fields */ }

Configures HttpKind.

Implementations

impl HttpKindBuilder

pub fn http_client(self, client: Arc<dyn HttpClient>) -> Self

Injects the HTTP transport.

pub fn coalesce_in_flight(self, enabled: bool) -> Self

Enables or disables optional in-flight request coalescing. It is disabled by default.

pub fn session_pool(self, options: SessionPoolOptions) -> Self

Enables sessions with the supplied pool options.

pub fn shared_session_pool(self, pool: Arc<SessionPool>) -> Self

Uses an existing session pool without managing its persistence lifecycle.

With a shared pool, the component that owns the sharing (for example, the Phase 6 smart kind) attaches persistence exactly once. Otherwise, two kinds would double-restore and double-persist the same pool.

pub fn disable_sessions(self) -> Self

Disables session selection, cookie persistence, and session rotation.

pub fn proxy(self, proxy: ProxyConfiguration) -> Self

Sets the default proxy bucket.

pub fn proxy_buckets(self, proxies: ProxyBuckets) -> Self

Replaces all logical proxy buckets.

pub fn proxy_strategy<S: ProxyStrategy>(self, strategy: S) -> Self

Sets the policy that selects a proxy bucket per attempt.

pub fn user_agents<I, U>(self, user_agents: I) -> Self

where I: IntoIterator<Item = U>, U: Into<String>,

Replaces the rotating User-Agent set.

pub fn retry_status_codes(self, codes: impl IntoIterator<Item = u16>) -> Self

Replaces the exact status codes classified as ordinary retries.

pub fn retry_server_errors(self, enabled: bool) -> Self

Controls whether every 5xx response is retried.

pub fn session_status_codes(self, codes: impl IntoIterator<Item = u16>) -> Self

Replaces statuses that trigger the retry_on_blocked session-rotation behavior.

The default is 401 and 403. An empty list disables status-driven session rotation.

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

Sets the HTTP request deadline corresponding to §20.5’s navigation_timeout option.

pub fn max_redirects(self, maximum: u32) -> Self

Sets the maximum number of redirects followed for one request.

pub fn detect_anti_bot(self, detector: Arc<dyn AntiBotDetector>) -> Self

Enables response inspection with a caller-supplied anti-bot detector.

pub fn detect_anti_bot_default(self) -> Self

Opts into the default anti-bot detector.

Detection is off by default so SmartKind promotion and default crawls are unaffected.

pub fn header_generator(self, enabled: bool) -> Self

Enables or disables deterministic browser-like request headers.

pub fn snapshot_errors_on_failure(self, enabled: bool) -> Self

Enables or disables response-body snapshots when handlers fail.

pub fn pre_navigation_hook<F>(self, hook: F) -> Self

where F: for<'a> Fn(HttpPreHookCtx<'a>) -> BoxFuture<'a, Result<(), CrawlError>> + Send + Sync + 'static,

Registers an HTTP hook that runs immediately before navigation.

pub fn post_navigation_hook<F>(self, hook: F) -> Self

where F: for<'a> Fn(HttpPostHookCtx<'a>) -> BoxFuture<'a, Result<(), CrawlError>> + Send + Sync + 'static,

Registers an HTTP hook that runs after navigation.

pub fn build(self) -> Result<HttpKind, HttpClientError>

Builds the kind, constructing a typed-error ReqwestClient when none was injected.

Trait Implementations

impl Default for HttpKindBuilder

fn default() -> Self

Returns the “default value” for a type.