Project Chimera
Меню

Исходники

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
17use std::path::{Path, PathBuf};
18
19/// Имена файлов, которые стоит поискать, в порядке предпочтения — сверху
20/// более специфичные (явно «обложка»/«постер»), снизу общие иконки.
21const 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-инсталляторами, которые сохраняют файлы в любом регистре.
40pub 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)]
57mod 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