Struct surf_vcr::VcrMiddleware

pub struct VcrMiddleware { /* fields omitted */ }

Record and playback HTTP sessions.

This middleware must be registered to the client after any other middleware that modifies the HTTP request, or those modifications will not be recorded and replayed.

use surf_vcr::{VcrMiddleware, VcrMode};

let vcr = VcrMiddleware::new(
    VcrMode::Replay,
    "test-sessions/session-recording.yml"
).await?;

let mut client = surf::Client::new()
    .with(some_other_middleware)
    .with(vcr);

// And then make your requests:
let req = surf::get("https://example.com")
    .header("X-my-header", "stuff");

let resp = client.send(req).await?;

Implementations

impl VcrMiddleware

pub async fn new<P>(mode: VcrMode, recording: P) -> Result<Self, VcrError> where
    P: Into<PathBuf>, 

pub fn with_modify_request<F>(self, modifier: F) -> Self where
    F: Fn(&mut VcrRequest) + Send + Sync + 'static, 

Register a modifier function to alter requests before saving to disk.

pub fn with_modify_response<F>(self, modifier: F) -> Self where
    F: Fn(&mut VcrResponse) + Send + Sync + 'static, 

Register a modifier function to alter responses before saving to disk.

Trait Implementations

impl Middleware for VcrMiddleware

fn handle<'life0, 'life1, 'async_trait>(
    &'life0 self,
    req: Request,
    client: Client,
    next: Next<'life1>
) -> Pin<Box<dyn Future<Output = Result<Response>> + Send + 'async_trait>> where
    'life0: 'async_trait,
    'life1: 'async_trait,
    Self: 'async_trait, 

Asynchronously handle the request, and return a response.