Struct Context 

pub struct Context<C> { /* private fields */ }

A request being crawled, with everything needed to handle it.

It holds the Request, a client to fetch it with, a Queue to add the links it leads to, and the crawl’s datasets.

Implementations

impl<C> Context<C>

pub fn new(request: Request, client: C) -> Self

Creates a standalone context, e.g. to test a handler.

It gets an empty queue of its own and no datasets; see with_queue and with_dataset.

pub fn with_queue(self, queue: &Queue) -> Self

Replaces the queue, binding it to the request.

pub fn with_dataset<T, D>(self, dataset: D) -> Self

where T: Send + 'static, D: Dataset<T>,

Registers dataset for items of type T.

pub const fn request(&self) -> &Request

Returns the request.

pub const fn request_mut(&mut self) -> &mut Request

Returns the request mutably, e.g. to add headers before fetching.

pub const fn client(&self) -> &C

Returns the client.

pub const fn client_mut(&mut self) -> &mut C

Returns the client mutably.

pub const fn queue(&self) -> &Queue

Returns the queue for the links this request leads to.

pub fn dataset<T: Send + 'static>(&self) -> Result<Data<T>>

Returns the dataset for items of type T.

Errors

Returns a Dataset error if no dataset is registered for T.

pub fn into_parts(self) -> (Request, C)

Splits the context into its request and client.

pub async fn fetch(self) -> Result<Response>

where C: Client,

Fetches the response for the request.

Links followed through the queue, including clones taken earlier, resolve against the URI the response was served from from then on.

Errors

Returns an error if the client fails to fetch the response.

Trait Implementations

impl<C> Debug for Context<C>

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

Formats the value using the given formatter.