Struct RestoreFileCommand 

pub struct RestoreFileCommand {
    pub source_adapipe_path: PathBuf,
    pub target_path: PathBuf,
    pub overwrite: bool,
    pub create_directories: bool,
    pub validate_permissions: bool,
}

Command to restore a file from .adapipe format.

This command encapsulates all the information needed to restore a file from the pipeline’s compressed and processed format back to its original form. It follows the Command pattern and supports the builder pattern for flexible configuration.

Command Properties

• Immutable: Once created, the command cannot be modified (except through builder methods)
• Self-Contained: Contains all information needed for execution
• Validatable: Can be validated before execution
• Auditable: Provides clear operation tracking

Usage Examples

Basic File Restoration

Advanced Configuration

Batch Processing Setup

Validation

Commands should be validated before execution to ensure:

• Source file exists and is readable
• Target directory is writable
• Sufficient disk space is available
• Permissions allow the operation

Error Handling

Command execution can fail for various reasons:

• Source file not found or corrupted
• Insufficient permissions
• Disk space exhausted
• Target file already exists (when overwrite is false)
• Invalid .adapipe format

Performance Considerations

• Large files may require streaming restoration
• Multiple commands can be processed concurrently
• Progress tracking may be needed for long operations
• Memory usage scales with file size and concurrency

Fields

source_adapipe_path: PathBuf

Path to the .adapipe file to restore from

target_path: PathBuf

Target directory or file path for restoration

overwrite: bool

Whether to overwrite existing files

create_directories: bool

Whether to create missing directories

validate_permissions: bool

Whether to validate permissions before restoration

Implementations

impl RestoreFileCommand

pub fn new(source_adapipe_path: PathBuf, target_path: PathBuf) -> Self

pub fn with_overwrite(self, overwrite: bool) -> Self

pub fn with_create_directories(self, create_directories: bool) -> Self

pub fn with_permission_validation(self, validate: bool) -> Self

Trait Implementations

impl Clone for RestoreFileCommand

fn clone(&self) -> RestoreFileCommand

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RestoreFileCommand

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

Formats the value using the given formatter.