// Copyright: Ankitects Pty Ltd and contributors // License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html use std::{ borrow::Cow, collections::{HashMap, HashSet}, fs, io, path::Path, }; use lazy_static::lazy_static; use regex::Regex; use crate::{ collection::Collection, error::{AnkiError, DbErrorKind, Result}, latex::extract_latex_expanding_clozes, log::debug, media::{ database::MediaDatabaseContext, files::{ data_for_file, filename_if_normalized, normalize_nfc_filename, trash_folder, MEDIA_SYNC_FILESIZE_LIMIT, }, MediaManager, }, notes::Note, text::{extract_media_refs, normalize_to_nfc, MediaRef}, }; lazy_static! { static ref REMOTE_FILENAME: Regex = Regex::new("(?i)^https?://").unwrap(); } #[derive(Debug, PartialEq, Clone)] pub struct MediaCheckOutput { pub unused: Vec, pub missing: Vec, pub renamed: HashMap, pub dirs: Vec, pub oversize: Vec, pub trash_count: u64, pub trash_bytes: u64, } #[derive(Debug, PartialEq, Default)] struct MediaFolderCheck { files: Vec, renamed: HashMap, dirs: Vec, oversize: Vec, } pub struct MediaChecker<'a, 'b, P> where P: FnMut(usize) -> bool, { ctx: &'a mut Collection, mgr: &'b MediaManager, progress_cb: P, checked: usize, } impl

MediaChecker<'_, '_, P> where P: FnMut(usize) -> bool, { pub(crate) fn new<'a, 'b>( ctx: &'a mut Collection, mgr: &'b MediaManager, progress_cb: P, ) -> MediaChecker<'a, 'b, P> { MediaChecker { ctx, mgr, progress_cb, checked: 0, } } pub fn check(&mut self) -> Result { let mut ctx = self.mgr.dbctx(); let folder_check = self.check_media_folder(&mut ctx)?; let referenced_files = self.check_media_references(&folder_check.renamed)?; let (unused, missing) = find_unused_and_missing(folder_check.files, referenced_files); let (trash_count, trash_bytes) = self.files_in_trash()?; Ok(MediaCheckOutput { unused, missing, renamed: folder_check.renamed, dirs: folder_check.dirs, oversize: folder_check.oversize, trash_count, trash_bytes, }) } pub fn summarize_output(&self, output: &mut MediaCheckOutput) -> String { let mut buf = String::new(); let i = &self.ctx.tr; // top summary area if output.trash_count > 0 { let megs = (output.trash_bytes as f32) / 1024.0 / 1024.0; buf += &i.media_check_trash_count(output.trash_count, megs); buf.push('\n'); } buf += &i.media_check_missing_count(output.missing.len()); buf.push('\n'); buf += &i.media_check_unused_count(output.unused.len()); buf.push('\n'); if !output.renamed.is_empty() { buf += &i.media_check_renamed_count(output.renamed.len()); buf.push('\n'); } if !output.oversize.is_empty() { buf += &i.media_check_oversize_count(output.oversize.len()); buf.push('\n'); } if !output.dirs.is_empty() { buf += &i.media_check_subfolder_count(output.dirs.len()); buf.push('\n'); } buf.push('\n'); if !output.renamed.is_empty() { buf += &i.media_check_renamed_header(); buf.push('\n'); for (old, new) in &output.renamed { buf += &i.media_check_renamed_file(old.as_str(), new.as_str()); buf.push('\n'); } buf.push('\n') } if !output.oversize.is_empty() { output.oversize.sort(); buf += &i.media_check_oversize_header(); buf.push('\n'); for fname in &output.oversize { buf += &i.media_check_oversize_file(fname.as_str()); buf.push('\n'); } buf.push('\n') } if !output.dirs.is_empty() { output.dirs.sort(); buf += &i.media_check_subfolder_header(); buf.push('\n'); for fname in &output.dirs { buf += &i.media_check_subfolder_file(fname.as_str()); buf.push('\n'); } buf.push('\n') } if !output.missing.is_empty() { output.missing.sort(); buf += &i.media_check_missing_header(); buf.push('\n'); for fname in &output.missing { buf += &i.media_check_missing_file(fname.as_str()); buf.push('\n'); } buf.push('\n') } if !output.unused.is_empty() { output.unused.sort(); buf += &i.media_check_unused_header(); buf.push('\n'); for fname in &output.unused { buf += &i.media_check_unused_file(fname.as_str()); buf.push('\n'); } } buf } /// Check all the files in the media folder. /// /// - Renames files with invalid names /// - Notes folders/oversized files /// - Gathers a list of all files fn check_media_folder(&mut self, ctx: &mut MediaDatabaseContext) -> Result { let mut out = MediaFolderCheck::default(); for dentry in self.mgr.media_folder.read_dir()? { let dentry = dentry?; self.checked += 1; if self.checked % 10 == 0 { self.fire_progress_cb()?; } // if the filename is not valid unicode, skip it let fname_os = dentry.file_name(); let disk_fname = match fname_os.to_str() { Some(s) => s, None => continue, }; // skip folders if dentry.file_type()?.is_dir() { out.dirs.push(disk_fname.to_string()); continue; } // ignore large files and zero byte files let metadata = dentry.metadata()?; if metadata.len() > MEDIA_SYNC_FILESIZE_LIMIT as u64 { out.oversize.push(disk_fname.to_string()); continue; } if metadata.len() == 0 { continue; } if let Some(norm_name) = filename_if_normalized(disk_fname) { out.files.push(norm_name.into_owned()); } else { match data_for_file(&self.mgr.media_folder, disk_fname)? { Some(data) => { let norm_name = self.normalize_file(ctx, &disk_fname, data)?; out.renamed .insert(disk_fname.to_string(), norm_name.to_string()); out.files.push(norm_name.into_owned()); } None => { // file not found, caused by the file being removed at this exact instant, // or the path being larger than MAXPATH on Windows continue; } }; } } Ok(out) } /// Write file data to normalized location, moving old file to trash. fn normalize_file<'a>( &mut self, ctx: &mut MediaDatabaseContext, disk_fname: &'a str, data: Vec, ) -> Result> { // add a copy of the file using the correct name let fname = self.mgr.add_file(ctx, disk_fname, &data)?; debug!(self.ctx.log, "renamed"; "from"=>disk_fname, "to"=>&fname.as_ref()); assert_ne!(fname.as_ref(), disk_fname); // remove the original file let path = &self.mgr.media_folder.join(disk_fname); fs::remove_file(path)?; Ok(fname) } fn fire_progress_cb(&mut self) -> Result<()> { if (self.progress_cb)(self.checked) { Ok(()) } else { Err(AnkiError::Interrupted) } } /// Returns the count and total size of the files in the trash folder fn files_in_trash(&mut self) -> Result<(u64, u64)> { let trash = trash_folder(&self.mgr.media_folder)?; let mut total_files = 0; let mut total_bytes = 0; for dentry in trash.read_dir()? { let dentry = dentry?; self.checked += 1; if self.checked % 10 == 0 { self.fire_progress_cb()?; } if dentry.file_name() == ".DS_Store" { continue; } let meta = dentry.metadata()?; total_files += 1; total_bytes += meta.len(); } Ok((total_files, total_bytes)) } pub fn empty_trash(&mut self) -> Result<()> { let trash = trash_folder(&self.mgr.media_folder)?; for dentry in trash.read_dir()? { let dentry = dentry?; self.checked += 1; if self.checked % 10 == 0 { self.fire_progress_cb()?; } fs::remove_file(dentry.path())?; } Ok(()) } pub fn restore_trash(&mut self) -> Result<()> { let trash = trash_folder(&self.mgr.media_folder)?; for dentry in trash.read_dir()? { let dentry = dentry?; self.checked += 1; if self.checked % 10 == 0 { self.fire_progress_cb()?; } let orig_path = self.mgr.media_folder.join(dentry.file_name()); // if the original filename doesn't exist, we can just rename if let Err(e) = fs::metadata(&orig_path) { if e.kind() == io::ErrorKind::NotFound { fs::rename(&dentry.path(), &orig_path)?; } else { return Err(e.into()); } } else { // ensure we don't overwrite different data let fname_os = dentry.file_name(); let fname = fname_os.to_string_lossy(); if let Some(data) = data_for_file(&trash, fname.as_ref())? { let _new_fname = self.mgr .add_file(&mut self.mgr.dbctx(), fname.as_ref(), &data)?; } else { debug!(self.ctx.log, "file disappeared while restoring trash"; "fname"=>fname.as_ref()); } fs::remove_file(dentry.path())?; } } Ok(()) } /// Find all media references in notes, fixing as necessary. fn check_media_references( &mut self, renamed: &HashMap, ) -> Result> { let mut referenced_files = HashSet::new(); let notetypes = self.ctx.get_all_notetypes()?; let mut collection_modified = false; let nids = self.ctx.search_notes("")?; let usn = self.ctx.usn()?; for nid in nids { self.checked += 1; if self.checked % 10 == 0 { self.fire_progress_cb()?; } let mut note = self.ctx.storage.get_note(nid)?.unwrap(); let nt = notetypes.get(¬e.notetype_id).ok_or_else(|| { AnkiError::db_error("missing note type", DbErrorKind::MissingEntity) })?; if fix_and_extract_media_refs( &mut note, &mut referenced_files, renamed, &self.mgr.media_folder, )? { // note was modified, needs saving note.prepare_for_update(nt, false)?; note.set_modified(usn); self.ctx.storage.update_note(¬e)?; collection_modified = true; } // extract latex extract_latex_refs(¬e, &mut referenced_files, nt.config.latex_svg); } if collection_modified { // fixme: need to refactor to use new transaction handling? // self.ctx.storage.commit_trx()?; } Ok(referenced_files) } } /// Returns true if note was modified. fn fix_and_extract_media_refs( note: &mut Note, seen_files: &mut HashSet, renamed: &HashMap, media_folder: &Path, ) -> Result { let mut updated = false; for idx in 0..note.fields().len() { let field = normalize_and_maybe_rename_files( ¬e.fields()[idx], renamed, seen_files, media_folder, ); if let Cow::Owned(field) = field { // field was modified, need to save note.set_field(idx, field)?; updated = true; } } Ok(updated) } /// Convert any filenames that are not in NFC form into NFC, /// and update any files that were renamed on disk. fn normalize_and_maybe_rename_files<'a>( field: &'a str, renamed: &HashMap, seen_files: &mut HashSet, media_folder: &Path, ) -> Cow<'a, str> { let refs = extract_media_refs(field); let mut field: Cow = field.into(); for media_ref in refs { if REMOTE_FILENAME.is_match(media_ref.fname) { // skip remote references continue; } // normalize fname into NFC let mut fname = normalize_to_nfc(&media_ref.fname_decoded); // and look it up to see if it's been renamed if let Some(new_name) = renamed.get(fname.as_ref()) { fname = new_name.to_owned().into(); } // if the filename was in NFC and was not renamed as part of the // media check, it may have already been renamed during a previous // sync. If that's the case and the renamed version exists on disk, // we'll need to update the field to match it. It may be possible // to remove this check in the future once we can be sure all media // files stored on AnkiWeb are in normalized form. if matches!(fname, Cow::Borrowed(_)) { if let Cow::Owned(normname) = normalize_nfc_filename(fname.as_ref().into()) { let path = media_folder.join(&normname); if path.exists() { fname = normname.into(); } } } // update the field if the filename was modified if let Cow::Owned(ref new_name) = fname { field = rename_media_ref_in_field(field.as_ref(), &media_ref, new_name).into(); } // and mark this filename as having been referenced seen_files.insert(fname.into_owned()); } field } fn rename_media_ref_in_field(field: &str, media_ref: &MediaRef, new_name: &str) -> String { let new_name = if matches!(media_ref.fname_decoded, Cow::Owned(_)) { // filename had quoted characters like & - need to re-encode htmlescape::encode_minimal(new_name) } else { new_name.into() }; let updated_tag = media_ref.full_ref.replace(media_ref.fname, &new_name); field.replace(media_ref.full_ref, &updated_tag) } /// Returns (unused, missing) fn find_unused_and_missing( files: Vec, mut references: HashSet, ) -> (Vec, Vec) { let mut unused = vec![]; for file in files { if !file.starts_with('_') && !references.contains(&file) { unused.push(file); } else { references.remove(&file); } } (unused, references.into_iter().collect()) } fn extract_latex_refs(note: &Note, seen_files: &mut HashSet, svg: bool) { for field in note.fields() { let (_, extracted) = extract_latex_expanding_clozes(field, svg); for e in extracted { seen_files.insert(e.fname); } } } #[cfg(test)] pub(crate) mod test { pub(crate) const MEDIACHECK_ANKI2: &[u8] = include_bytes!("../../tests/support/mediacheck.anki2"); use std::{collections::HashMap, fs, io, path::Path}; use tempfile::{tempdir, TempDir}; use super::normalize_and_maybe_rename_files; use crate::{ collection::{open_collection, Collection}, error::Result, i18n::I18n, log, media::{ check::{MediaCheckOutput, MediaChecker}, files::trash_folder, MediaManager, }, }; fn common_setup() -> Result<(TempDir, MediaManager, Collection)> { let dir = tempdir()?; let media_dir = dir.path().join("media"); fs::create_dir(&media_dir)?; let media_db = dir.path().join("media.db"); let col_path = dir.path().join("col.anki2"); fs::write(&col_path, MEDIACHECK_ANKI2)?; let mgr = MediaManager::new(&media_dir, media_db.clone())?; let log = log::terminal(); let tr = I18n::template_only(); let col = open_collection(col_path, media_dir, media_db, false, tr, log)?; Ok((dir, mgr, col)) } #[test] fn media_check() -> Result<()> { let (_dir, mgr, mut col) = common_setup()?; // add some test files fs::write(&mgr.media_folder.join("zerobytes"), "")?; fs::create_dir(&mgr.media_folder.join("folder"))?; fs::write(&mgr.media_folder.join("normal.jpg"), "normal")?; fs::write(&mgr.media_folder.join("foo[.jpg"), "foo")?; fs::write(&mgr.media_folder.join("_under.jpg"), "foo")?; fs::write(&mgr.media_folder.join("unused.jpg"), "foo")?; let progress = |_n| true; let (output, report) = col.transact_no_undo(|ctx| { let mut checker = MediaChecker::new(ctx, &mgr, progress); let output = checker.check()?; let summary = checker.summarize_output(&mut output.clone()); Ok((output, summary)) })?; assert_eq!( output, MediaCheckOutput { unused: vec!["unused.jpg".into()], missing: vec!["ぱぱ.jpg".into()], renamed: vec![("foo[.jpg".into(), "foo.jpg".into())] .into_iter() .collect(), dirs: vec!["folder".to_string()], oversize: vec![], trash_count: 0, trash_bytes: 0 } ); assert!(fs::metadata(&mgr.media_folder.join("foo[.jpg")).is_err()); assert!(fs::metadata(&mgr.media_folder.join("foo.jpg")).is_ok()); assert_eq!( report, "Missing files: 1 Unused files: 1 Renamed files: 1 Subfolders: 1 Some files have been renamed for compatibility: Renamed: foo[.jpg -> foo.jpg Folders inside the media folder are not supported. Folder: folder The following files are referenced by cards, but were not found in the media folder: Missing: ぱぱ.jpg The following files were found in the media folder, but do not appear to be used on any cards: Unused: unused.jpg " ); Ok(()) } fn files_in_dir(dir: &Path) -> Vec { let mut files = fs::read_dir(dir) .unwrap() .map(|dentry| { let dentry = dentry.unwrap(); Ok(dentry.file_name().to_string_lossy().to_string()) }) .collect::>>() .unwrap(); files.sort(); files } #[test] fn trash_handling() -> Result<()> { let (_dir, mgr, mut col) = common_setup()?; let trash_folder = trash_folder(&mgr.media_folder)?; fs::write(trash_folder.join("test.jpg"), "test")?; let progress = |_n| true; col.transact_no_undo(|ctx| { let mut checker = MediaChecker::new(ctx, &mgr, progress); checker.restore_trash() })?; // file should have been moved to media folder assert_eq!(files_in_dir(&trash_folder), Vec::::new()); assert_eq!( files_in_dir(&mgr.media_folder), vec!["test.jpg".to_string()] ); // if we repeat the process, restoring should do the same thing if the contents are equal fs::write(trash_folder.join("test.jpg"), "test")?; col.transact_no_undo(|ctx| { let mut checker = MediaChecker::new(ctx, &mgr, progress); checker.restore_trash() })?; assert_eq!(files_in_dir(&trash_folder), Vec::::new()); assert_eq!( files_in_dir(&mgr.media_folder), vec!["test.jpg".to_string()] ); // but rename if required fs::write(trash_folder.join("test.jpg"), "test2")?; col.transact_no_undo(|ctx| { let mut checker = MediaChecker::new(ctx, &mgr, progress); checker.restore_trash() })?; assert_eq!(files_in_dir(&trash_folder), Vec::::new()); assert_eq!( files_in_dir(&mgr.media_folder), vec![ "test-109f4b3c50d7b0df729d299bc6f8e9ef9066971f.jpg".to_string(), "test.jpg".into() ] ); Ok(()) } #[test] fn unicode_normalization() -> Result<()> { let (_dir, mgr, mut col) = common_setup()?; fs::write(&mgr.media_folder.join("ぱぱ.jpg"), "nfd encoding")?; let progress = |_n| true; let mut output = col.transact_no_undo(|ctx| { let mut checker = MediaChecker::new(ctx, &mgr, progress); checker.check() })?; output.missing.sort(); if cfg!(target_vendor = "apple") { // on a Mac, the file should not have been renamed, but the returned name // should be in NFC format assert_eq!( output, MediaCheckOutput { unused: vec![], missing: vec!["foo[.jpg".into(), "normal.jpg".into()], renamed: Default::default(), dirs: vec![], oversize: vec![], trash_count: 0, trash_bytes: 0 } ); assert!(fs::metadata(&mgr.media_folder.join("ぱぱ.jpg")).is_ok()); } else { // on other platforms, the file should have been renamed to NFC assert_eq!( output, MediaCheckOutput { unused: vec![], missing: vec!["foo[.jpg".into(), "normal.jpg".into()], renamed: vec![("ぱぱ.jpg".into(), "ぱぱ.jpg".into())] .into_iter() .collect(), dirs: vec![], oversize: vec![], trash_count: 0, trash_bytes: 0 } ); assert!(fs::metadata(&mgr.media_folder.join("ぱぱ.jpg")).is_err()); assert!(fs::metadata(&mgr.media_folder.join("ぱぱ.jpg")).is_ok()); } Ok(()) } #[test] fn html_encoding() { let field = "[sound:a & b.mp3]"; let mut seen = Default::default(); normalize_and_maybe_rename_files(field, &HashMap::new(), &mut seen, Path::new("/tmp")); assert!(seen.contains("a & b.mp3")); } }