// Copyright: Ankitects Pty Ltd and contributors // License: GNU AGPL, version 3 or later; http://www.gnu.org/licenses/agpl.html use crate::collection::Collection; use crate::err::{AnkiError, DBErrorKind, Result}; use crate::i18n::{tr_args, tr_strs, TR}; use crate::latex::extract_latex_expanding_clozes; use crate::log::debug; use crate::media::database::MediaDatabaseContext; use crate::media::files::{ data_for_file, filename_if_normalized, normalize_nfc_filename, trash_folder, MEDIA_SYNC_FILESIZE_LIMIT, }; use crate::notes::Note; use crate::text::{normalize_to_nfc, MediaRef}; use crate::{media::MediaManager, text::extract_media_refs}; use lazy_static::lazy_static; use regex::Regex; use std::collections::{HashMap, HashSet}; use std::path::Path; use std::{borrow::Cow, fs, io}; 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.i18n; // top summary area if output.trash_count > 0 { let megs = (output.trash_bytes as f32) / 1024.0 / 1024.0; buf += &i.trn( TR::MediaCheckTrashCount, tr_args!["count"=>output.trash_count, "megs"=>megs], ); buf.push('\n'); } buf += &i.trn( TR::MediaCheckMissingCount, tr_args!["count"=>output.missing.len()], ); buf.push('\n'); buf += &i.trn( TR::MediaCheckUnusedCount, tr_args!["count"=>output.unused.len()], ); buf.push('\n'); if !output.renamed.is_empty() { buf += &i.trn( TR::MediaCheckRenamedCount, tr_args!["count"=>output.renamed.len()], ); buf.push('\n'); } if !output.oversize.is_empty() { buf += &i.trn( TR::MediaCheckOversizeCount, tr_args!["count"=>output.oversize.len()], ); buf.push('\n'); } if !output.dirs.is_empty() { buf += &i.trn( TR::MediaCheckSubfolderCount, tr_args!["count"=>output.dirs.len()], ); buf.push('\n'); } buf.push('\n'); if !output.renamed.is_empty() { buf += &i.tr(TR::MediaCheckRenamedHeader); buf.push('\n'); for (old, new) in &output.renamed { buf += &i.trn(TR::MediaCheckRenamedFile, tr_strs!["old"=>old,"new"=>new]); buf.push('\n'); } buf.push('\n') } if !output.oversize.is_empty() { output.oversize.sort(); buf += &i.tr(TR::MediaCheckOversizeHeader); buf.push('\n'); for fname in &output.oversize { buf += &i.trn(TR::MediaCheckOversizeFile, tr_strs!["filename"=>fname]); buf.push('\n'); } buf.push('\n') } if !output.dirs.is_empty() { output.dirs.sort(); buf += &i.tr(TR::MediaCheckSubfolderHeader); buf.push('\n'); for fname in &output.dirs { buf += &i.trn(TR::MediaCheckSubfolderFile, tr_strs!["filename"=>fname]); buf.push('\n'); } buf.push('\n') } if !output.missing.is_empty() { output.missing.sort(); buf += &i.tr(TR::MediaCheckMissingHeader); buf.push('\n'); for fname in &output.missing { buf += &i.trn(TR::MediaCheckMissingFile, tr_strs!["filename"=>fname]); buf.push('\n'); } buf.push('\n') } if !output.unused.is_empty() { output.unused.sort(); buf += &i.tr(TR::MediaCheckUnusedHeader); buf.push('\n'); for fname in &output.unused { buf += &i.trn(TR::MediaCheckUnusedFile, tr_strs!["filename"=>fname]); 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 note_types = 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 = note_types .get(¬e.notetype_id) .ok_or_else(|| AnkiError::DBError { info: "missing note type".to_string(), kind: 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 super::normalize_and_maybe_rename_files; use crate::collection::{open_collection, Collection}; use crate::err::Result; use crate::i18n::I18n; use crate::log; use crate::media::check::{MediaCheckOutput, MediaChecker}; use crate::media::files::trash_folder; use crate::media::MediaManager; use std::path::Path; use std::{collections::HashMap, fs, io}; use tempfile::{tempdir, TempDir}; 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 i18n = I18n::new(&["zz"], "dummy", log.clone()); let col = open_collection(col_path, media_dir, media_db, false, i18n, 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(None, |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(None, |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(None, |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(None, |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(None, |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")); } }