Struct MediaScanner 

pub struct MediaScanner { /* private fields */ }

Media scanner that uses the file system manager and database for efficient scanning

Implementations

impl MediaScanner

pub async fn new() -> Result<Self>

Create a new media scanner with platform-specific file system manager

pub fn with_database(database_manager: Arc<dyn DatabaseManager>) -> Self

Create a new media scanner with database manager

pub async fn scan_directory_simple( &self, directory: &Path, ) -> Result<Vec<MediaFile>>

Simple directory scan that returns files without database operations

pub async fn scan_directory_recursively_simple( &self, directory: &Path, ) -> Result<Vec<MediaFile>>

Simple recursive directory scan that returns files without database operations

pub fn with_filesystem_manager( filesystem_manager: Box<dyn FileSystemManager>, database_manager: Arc<dyn DatabaseManager>, ) -> Self

Create a media scanner with a custom file system manager (for testing)

pub async fn scan_directory(&self, directory: &Path) -> Result<ScanResult>

Perform a full scan of a directory, updating the database with new/changed files

pub async fn scan_directories( &self, directories: &[PathBuf], ) -> Result<ScanResult>

Scan multiple directories and return combined results

pub async fn scan_directory_recursive( &self, directory: &Path, ) -> Result<ScanResult>

Perform a recursive scan of a directory and its subdirectories

This method is optimized to avoid N+1 query problems by loading all existing files from the database once at the start, then passing this collection down to each directory scan. This significantly improves performance for large directory structures.

The method also implements batch processing to handle very large directory structures efficiently without blocking the async runtime.

pub fn filesystem_manager(&self) -> &dyn FileSystemManager

Get the file system manager (for testing or advanced usage)