Struct FetcherSession 

pub struct FetcherSession { /* private fields */ }

Session-based async HTTP fetcher that reuses a persistent client with cookie storage.

Unlike Fetcher, this struct maintains a single wreq client across requests, which means cookies set by one response are automatically sent with subsequent requests. This is essential for login flows, CSRF-protected forms, and any multi-step interaction where server-side session state matters.

Lifecycle: create with new(), call open() to start the session, make requests, then call close() (or just drop it).

Implementations

impl FetcherSession

pub fn new(config: FetcherConfig) -> Self

Creates a new session with the given configuration. The session is not yet active – you must call open() before making requests.

pub fn with_rotator(self, rotator: ProxyRotator) -> Self

Attaches a proxy rotator to the session. Must be called before open() since the proxy is configured on the underlying client.

pub fn with_parser_config(self, parser_config: ParserConfig) -> Self

Sets the parser configuration for the session. Controls how responses from this session parse and interpret HTML.

pub fn open(&mut self) -> Result<()>

Opens the session by creating the underlying HTTP client with a cookie store. Returns an error if the session is already active. After this call, you can make requests with get(), post(), etc.

pub fn close(&mut self)

Closes the session and drops the underlying HTTP client. All cookies and connection state are discarded. The session can be re-opened with open().

pub fn is_active(&self) -> bool

Returns true if the session is currently active (i.e., open() has been called and close() has not).

pub async fn get( &self, url: &str, req: Option<RequestConfig>, ) -> Result<Response>

Sends an HTTP GET request using the session client. Cookies from prior responses are automatically included. Returns an error if the session is not active.

pub async fn post( &self, url: &str, req: Option<RequestConfig>, ) -> Result<Response>

Sends an HTTP POST request using the session client. Use RequestConfig::json or RequestConfig::data to attach a body.

pub async fn put( &self, url: &str, req: Option<RequestConfig>, ) -> Result<Response>

Sends an HTTP PUT request using the session client. Use RequestConfig::json or RequestConfig::data to attach a body.

pub async fn delete( &self, url: &str, req: Option<RequestConfig>, ) -> Result<Response>

Sends an HTTP DELETE request using the session client.

Trait Implementations

impl Drop for FetcherSession

fn drop(&mut self)

Executes the destructor for this type.