99 строк · 5 КиБ
code/crates/chl-core/src/local_art.rs
| 1 | //! Обложка, которая уже лежит в файлах самой игры. |
| 2 | //! |
| 3 | //! У игр без магазинного источника (добавленных вручную через «выбрать |
| 4 | //! .exe») нет ни `steam_appid`, ни какой-либо другой привязки — только путь |
| 5 | //! к исполняемому файлу. Но разработчики часто кладут иконку или обложку |
| 6 | //! прямо рядом с ним (`icon.png`, `cover.jpg` и подобное — здесь встречаются |
| 7 | //! самые частые названия у GOG/portable-сборок и просто у самих игр). Это |
| 8 | //! бесплатный и мгновенный источник — сеть не нужна, поэтому его стоит |
| 9 | //! проверять раньше сетевых источников (`chl_covers::fetch_cover_auto`), а |
| 10 | //! не после них. |
| 11 | //! |
| 12 | //! Ищем только в каталоге самого exe, без рекурсии по подпапкам: игра может |
| 13 | //! содержать тысячи файлов, обход всего дерева ради одной картинки был бы |
| 14 | //! и медленным, и с большей вероятностью подхватил бы случайный скриншот |
| 15 | //! или текстуру из ассетов вместо настоящей обложки. |
| 16 | |
| 17 | use std::path::{Path, PathBuf}; |
| 18 | |
| 19 | /// Имена файлов, которые стоит поискать, в порядке предпочтения — сверху |
| 20 | /// более специфичные (явно «обложка»/«постер»), снизу общие иконки. |
| 21 | const CANDIDATES: &[&str] = &[ |
| 22 | "cover.jpg", |
| 23 | "cover.png", |
| 24 | "boxart.jpg", |
| 25 | "boxart.png", |
| 26 | "header.jpg", |
| 27 | "header.png", |
| 28 | "folder.jpg", |
| 29 | "folder.png", |
| 30 | "icon.png", |
| 31 | "icon.jpg", |
| 32 | "icon.ico", |
| 33 | ]; |
| 34 | |
| 35 | /// Ищет обложку в каталоге, где лежит исполняемый файл игры. |
| 36 | /// |
| 37 | /// Сравнение имён без учёта регистра — так же, как и остальной поиск файлов |
| 38 | /// игры в этом лаунчере (см. `library::resolve_ci`): часть игр ставится |
| 39 | /// Wine-инсталляторами, которые сохраняют файлы в любом регистре. |
| 40 | pub fn find(exe_dir: &Path) -> Option<PathBuf> { |
| 41 | let entries = std::fs::read_dir(exe_dir).ok()?; |
| 42 | let files: Vec<(String, PathBuf)> = entries |
| 43 | .flatten() |
| 44 | .filter(|e| e.path().is_file()) |
| 45 | .filter_map(|e| Some((e.file_name().to_str()?.to_lowercase(), e.path()))) |
| 46 | .collect(); |
| 47 | |
| 48 | for candidate in CANDIDATES { |
| 49 | if let Some((_, path)) = files.iter().find(|(name, _)| name == candidate) { |
| 50 | return Some(path.clone()); |
| 51 | } |
| 52 | } |
| 53 | None |
| 54 | } |
| 55 | |
| 56 | #[cfg(test)] |
| 57 | mod tests { |
| 58 | use super::*; |
| 59 | |
| 60 | fn scratch_dir(name: &str) -> PathBuf { |
| 61 | let d = std::env::temp_dir().join(format!("chl-test-local-art-{name}")); |
| 62 | let _ = std::fs::remove_dir_all(&d); |
| 63 | std::fs::create_dir_all(&d).unwrap(); |
| 64 | d |
| 65 | } |
| 66 | |
| 67 | #[test] |
| 68 | fn находит_обложку_по_известному_имени() { |
| 69 | let dir = scratch_dir("известное-имя"); |
| 70 | std::fs::write(dir.join("game.exe"), b"").unwrap(); |
| 71 | std::fs::write(dir.join("Cover.JPG"), b"fake").unwrap(); |
| 72 | let found = find(&dir).unwrap(); |
| 73 | assert_eq!(found.file_name().unwrap(), "Cover.JPG"); |
| 74 | } |
| 75 | |
| 76 | #[test] |
| 77 | fn при_нескольких_кандидатах_побеждает_более_специфичный() { |
| 78 | let dir = scratch_dir("приоритет"); |
| 79 | std::fs::write(dir.join("icon.png"), b"fake").unwrap(); |
| 80 | std::fs::write(dir.join("cover.jpg"), b"fake").unwrap(); |
| 81 | let found = find(&dir).unwrap(); |
| 82 | assert_eq!(found.file_name().unwrap(), "cover.jpg"); |
| 83 | } |
| 84 | |
| 85 | #[test] |
| 86 | fn пустой_каталог_честно_молчит() { |
| 87 | let dir = scratch_dir("пусто"); |
| 88 | assert!(find(&dir).is_none()); |
| 89 | } |
| 90 | |
| 91 | #[test] |
| 92 | fn не_заходит_в_подкаталоги() { |
| 93 | let dir = scratch_dir("без-рекурсии"); |
| 94 | std::fs::create_dir(dir.join("assets")).unwrap(); |
| 95 | std::fs::write(dir.join("assets").join("cover.jpg"), b"fake").unwrap(); |
| 96 | assert!(find(&dir).is_none()); |
| 97 | } |
| 98 | } |
| 99 |