Struct FileRecorder 

pub struct FileRecorder { /* private fields */ }

Available on crate features http and std only.

Recorder that creates one file per recording session.

Live HTTP bodies are captured into private per-exchange temporary files. Completed entries are then copied into the destination HAR by one writer, so concurrent streams cannot interleave and body memory remains bounded.

Implementations

impl FileRecorder

pub fn new(dir: PathBuf, prefix: String) -> FileRecorder

Create a recorder for the given directory and filename prefix.

Construction does not require an active Tokio runtime. The recorder’s worker starts lazily when its first asynchronous operation is polled.

pub fn try_new_at( path: impl AsRef<Path>, ) -> Result<FileRecorder, Box<dyn Error + Sync + Send>>

Create a recorder that writes to one exact file path.

The parent directory is created when recording starts. Starting a new recording after Recorder::stop_record replaces the same file.

pub fn try_new_at_with_log_meta_info( path: impl AsRef<Path>, log_meta_info: LogMetaInfo, ) -> Result<FileRecorder, Box<dyn Error + Sync + Send>>

Create an exact-path recorder with explicit HAR log metadata.

pub fn new_with_log_meta_info( dir: PathBuf, prefix: String, log_meta_info: LogMetaInfo, ) -> FileRecorder

Create a recorder with explicit HAR log metadata.

Construction does not require an active Tokio runtime. The recorder’s worker starts lazily when its first asynchronous operation is polled.

Trait Implementations

impl Clone for FileRecorder

fn clone(&self) -> FileRecorder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileRecorder

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

Formats the value using the given formatter.

impl Default for FileRecorder

fn default() -> FileRecorder

Returns the “default value” for a type.

impl Recorder for FileRecorder

async fn record(&self, log: Log) -> Option<Extensions>

Record an already materialized HAR log.

async fn stop_record(&self)

Finish the active recording before this future resolves.

impl StreamingRecorder for FileRecorder

type Session = FileRecorderSession

Per-exchange recording handle.

async fn start_http_recording( &self, request: HttpRequestCapture, ) -> Option<<FileRecorder as StreamingRecorder>::Session>

Start capturing an HTTP exchange.