Struct PerMessageFileWriter 

pub struct PerMessageFileWriter { /* private fields */ }

Available on crate features http and std only.

Writes every captured request and response to an independent file.

Independent files allow bodies to stream concurrently without frame interleaving or cross-message backpressure. Generated filenames use only portable ASCII characters and are bounded to 160 bytes, comfortably below the commonly supported 255-byte component limit. The caller-provided destination can still be rejected by the operating system when the complete path exceeds a platform-specific path limit. Raw URIs are never included because they can contain secrets, path separators, platform-specific characters, or unbounded input. Request and response files captured for the same HTTP exchange contain the same UUID, regardless of request/response writer layer order.

Files are created without overwriting existing paths. On Unix, newly created files receive owner-only read/write permissions before the process umask is applied. The destination directory is canonicalized and every file open is confined to it.

Implementations

impl PerMessageFileWriter

pub async fn try_new( directory: impl Into<PathBuf>, prefix: impl AsRef<str>, ) -> Result<PerMessageFileWriter, Error>

Create a per-message file writer, creating directory when necessary.

prefix must be 1 to 32 ASCII letters, digits, -, or _. This deliberately conservative alphabet is valid in filenames on Unix, Windows, and common removable filesystems.

pub fn with_request_mode(self, mode: Option<WriterMode>) -> PerMessageFileWriter

Set how request files are written.

pub fn with_response_mode( self, mode: Option<WriterMode>, ) -> PerMessageFileWriter

Set how response files are written.

pub fn directory(&self) -> &Path

Return the canonical destination directory.

pub fn prefix(&self) -> &str

Return the portable filename prefix.

pub const fn request_mode(&self) -> Option<WriterMode>

Return the configured request writer mode.

pub const fn response_mode(&self) -> Option<WriterMode>

Return the configured response writer mode.

Trait Implementations

impl Clone for PerMessageFileWriter

fn clone(&self) -> PerMessageFileWriter

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PerMessageFileWriter

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

Formats the value using the given formatter.

impl RequestWriter for PerMessageFileWriter

async fn write_request(&self, request: Request)

Write the HTTP request while its body is streaming.

impl ResponseWriter for PerMessageFileWriter

async fn write_response(&self, response: Response)

Write the HTTP response while its body is streaming.