Struct ImageHandler 

pub struct ImageHandler { /* private fields */ }

Handles image drag-and-drop events and file operations.

Implementations

impl ImageHandler

pub fn new(config: ImageConfig) -> Self

Create a new image handler with the given configuration.

pub fn with_default_config() -> ImageResult<Self>

Create a new image handler with default configuration.

pub fn read_image(&self, path: &Path) -> ImageResult<ImageMetadata>

Read an image file and validate it.

Arguments

• path - Path to the image file

Returns

Image metadata if successful, error otherwise

Requirements

• Req 1.2: Read file using ricecoder-files integration
• Req 1.3: Validate format (PNG, JPG, GIF, WebP)
• Req 1.5: Report error with format details
• Security: Sanitize file paths to prevent directory traversal

pub fn validate_format(&self, format: ImageFormat) -> ImageResult<()>

Validate image format is supported.

Arguments

• format - The image format to validate

Returns

Ok if format is supported, error with supported formats list otherwise

Requirements

• Req 1.3: Validate format (PNG, JPG, GIF, WebP)
• Req 4.5: Report error with supported formats list

pub fn handle_dropped_files( &self, paths: &[PathBuf], ) -> (Vec<ImageMetadata>, Vec<ImageError>)

Handle multiple files from a drag-and-drop event.

Arguments

• paths - Paths to the dropped files

Returns

Vector of successfully read images and any errors encountered

Requirements

• Req 1.1: Handle multiple files in single drag-and-drop

pub fn config(&self) -> &ImageConfig

Get the configuration.

pub fn extract_paths_from_event(event_data: &str) -> Vec<PathBuf>

Extract file paths from a drag-and-drop event.

Arguments

• event_data - Raw event data from the terminal (typically file paths)

Returns

Vector of file paths extracted from the event

Requirements

• Req 1.1: Create interface for receiving drag-and-drop events from ricecoder-tui
• Req 1.1: Implement file path extraction from events

pub fn check_file_accessible(path: &Path) -> ImageResult<()>

Check if a file exists and is readable.

Arguments

• path - Path to check

Returns

Ok if file exists and is readable, error otherwise

Requirements

• Req 1.1: Implement file existence and permission checks

pub fn process_drag_drop_event( &self, event_data: &str, ) -> (Vec<ImageMetadata>, Vec<ImageError>)

Process a drag-and-drop event with multiple files.

Arguments

• event_data - Raw event data from the terminal

Returns

Tuple of (successfully processed images, errors encountered)

Requirements

• Req 1.1: Handle multiple files in single drag-and-drop
• Req 1.1: Implement file existence and permission checks