Struct LogicalWriter 

pub struct LogicalWriter { /* private fields */ }

Builds an L01/Lx01 catalog and file hashes while accepting file streams.

Uses the general writer’s temporary spools and publication transaction. This is not checkpoint-resumable acquisition. Input errors or cancellation poison the builder so partial files cannot be published by finish.

Implementations

impl LogicalWriter

pub fn create(path: impl AsRef<Path>, options: WriteOptions) -> Result<Self>

Creates a logical writer. Select Ewf1Logical or Ewf2Logical explicitly. Caller-authored catalogs and auxiliary file tables are rejected; this builder owns those. The root has identifier 1 and an empty name.

pub fn create_sequential( path: impl AsRef<Path>, options: SequentialOptions, ) -> Result<Self>

Creates bounded sequential Lx01 output. source_size is the sum of all file payload lengths. Catalog metadata remains in memory; one encoded segment is retained as payload scratch. No checkpoint resume.

pub fn add_directory( &mut self, parent: u64, metadata: LogicalEntryMetadata, ) -> Result<u64>

Adds a directory beneath an existing directory and returns its identifier. Duplicate names are permitted: identifiers disambiguate them.

pub fn add_file( &mut self, parent: u64, metadata: LogicalEntryMetadata, size: u64, input: &mut impl Read, ) -> Result<u64>

Reads exactly size bytes, assigns extents, and computes MD5/SHA1. Trailing input bytes are left unread, allowing bounded source streams. Callers own snapshot consistency and source metadata collection.

pub fn add_file_with_progress( &mut self, parent: u64, metadata: LogicalEntryMetadata, size: u64, input: &mut impl Read, progress: impl FnMut(LogicalWriteProgress) -> ControlFlow<()>, ) -> Result<u64>

Adds a file with cooperative cancellation between input/output buffers. Cancellation or an I/O error requires discarding this builder.

pub fn finish(self) -> Result<WriteResult>

Publishes the completed image with the EWF writer’s normal durability rules.