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, renamed files) use Bytes. Large outputs from shell-command file mode use Path to avoid reading multi-GB files into memory. Consumers call write_to() which uses rename() (O(1)) for the Path variant with a copy fallback for cross-device moves.

Variants

Bytes(Vec<u8>)

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

Path(PathBuf)

Reference to a file on disk (shell-command file-mode 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.

Trait Implementations

impl Clone for FileData

fn clone(&self) -> FileData

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: &FileData) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FileData