Enum FileData 

pub enum FileData {
    Bytes(Vec<u8>),
    Path(PathBuf),
}

File content — either in-memory bytes or a path on disk.

Small outputs (images, CSVs) use Bytes. Files on disk (CLI argument files, file-collect results, shell-run file-mode outputs) use Path to avoid reading multi-GB files into memory. A Path may be the user’s own file: write it out with copy_to(); write_to() moves it.

Variants

Bytes(Vec<u8>)

In-memory file content (images, CSVs, small outputs).

Path(PathBuf)

Reference to a file on disk (CLI inputs, collected files, shell outputs). The file is NOT read into memory until into_bytes() is called.

Implementations

impl FileData

pub fn write_to(&self, dest: &Path) -> Result<(), Error>

Move or write file content to a destination path.

Path variant attempts rename() first (O(1) on same filesystem), falling back to copy+delete for cross-device moves. Bytes variant writes data directly.

pub fn len(&self) -> Result<u64, Error>

Byte length without loading into memory. Bytes returns the vec length. Path reads file metadata.

pub fn is_empty(&self) -> Result<bool, Error>

Whether the file data is empty (zero bytes).

pub fn copy_to(&self, dest: &Path) -> Result<(), Error>

Copy file content to a destination path, preserving the source.

Bytes writes data directly. Path copies the file on disk. Unlike write_to(), the source file is never removed.

pub fn into_bytes(self) -> Result<Vec<u8>, Error>

Load file content into memory. Avoid for large files. Bytes is a no-op move. Path reads the file from disk.

pub fn to_bytes(&self) -> Result<Cow<'_, [u8]>, Error>

Read file content without consuming it: borrowed for Bytes, read from disk for Path. For processors that hold files by reference (batch input) and need the bytes of some of them.

Trait Implementations

impl Clone for FileData

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileData

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

Formats the value using the given formatter.

impl PartialEq for FileData

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for FileData