Project Chimera
Меню

Исходники

131 строк · 6 КиБ

code/crates/chl-gog/src/covers.rs

1//! Обложки игр GOG: скачиваются один раз и живут в кэше.
2//!
3//! Устройство один в один с [`chl_epic::covers`] — тот же кэш-каталог,
4//! тот же приём с временным файлом и переименованием, тот же порог на
5//! подозрительно короткий ответ. Разница только в источнике: у GOG адрес
6//! обложки — просто `//images.gog-statics.com/...` без протокола, поэтому
7//! перед скачиванием ему нужно дописать `https:`.
8//!
9//! Живой баг 2026-09-09: голого хэша (без протокола, но и без расширения)
10//! этому CDN мало — `.../<hash>` отвечает 404, а `.../<hash>.jpg` тем же
11//! самым файлом уже 200. GOG отдаёт адрес в `gameDetails`, рассчитанный на
12//! то, что расширение допишет верстальщик HTML где-то ещё; для отдельного
13//! HTTP-запроса недостаточно дописать только протокол.
14
15use std::io::Read;
16use std::path::{Path, PathBuf};
17
18use anyhow::{Context, Result, bail};
19
20/// Куда положить обложку игры. Имя файла — идентификатор товара GOG, а не
21/// название: названия бывают с косыми чертами и кавычками.
22pub fn path_for(cache_dir: &Path, product_id: &str) -> PathBuf {
23 let safe: String = product_id
24 .chars()
25 .map(|c| if c.is_ascii_alphanumeric() { c } else { '_' })
26 .collect();
27 cache_dir.join(format!("{safe}.jpg"))
28}
29
30/// Дополняет адрес до того, что реально отдаёт CDN: протокол (GOG шлёт
31/// `//images.gog-statics.com/...` без него, рассчитывая на подстановку в
32/// HTML как есть) и расширение (проверено вживую 2026-09-09: без него CDN
33/// отвечает 404, `.jpg` в конце — тот же файл с 200).
34fn absolute(url: &str) -> String {
35 let with_protocol = if let Some(rest) = url.strip_prefix("//") {
36 format!("https://{rest}")
37 } else {
38 url.to_string()
39 };
40 if with_protocol.ends_with(".jpg") || with_protocol.ends_with(".png") {
41 with_protocol
42 } else {
43 format!("{with_protocol}.jpg")
44 }
45}
46
47/// Скачивает обложку, если её ещё нет. Возвращает путь к файлу.
48pub fn fetch(cache_dir: &Path, product_id: &str, url: &str) -> Result<PathBuf> {
49 let target = path_for(cache_dir, product_id);
50 if target.is_file() {
51 return Ok(target);
52 }
53 std::fs::create_dir_all(cache_dir)
54 .with_context(|| format!("не создаётся {}", cache_dir.display()))?;
55
56 let mut response =
57 crate::api_agent().get(absolute(url)).call().context("обложка не скачивается")?;
58 let mut bytes = Vec::new();
59 response
60 .body_mut()
61 .as_reader()
62 .take(8 * 1024 * 1024)
63 .read_to_end(&mut bytes)
64 .context("обрыв загрузки обложки")?;
65
66 if bytes.len() < 1024 {
67 bail!("вместо обложки пришло {} байт", bytes.len());
68 }
69
70 let partial = target.with_extension("часть");
71 std::fs::write(&partial, &bytes).with_context(|| format!("не пишется {}", partial.display()))?;
72 std::fs::rename(&partial, &target)?;
73 Ok(target)
74}
75
76#[cfg(test)]
77mod tests {
78 use super::*;
79
80 #[test]
81 fn имя_файла_выводится_из_идентификатора() {
82 let d = Path::new("/кэш");
83 assert_eq!(path_for(d, "1207658930"), d.join("1207658930.jpg"));
84 assert_eq!(path_for(d, "a/b c:d"), d.join("a_b_c_d.jpg"));
85 }
86
87 #[test]
88 fn адрес_без_протокола_дополняется() {
89 assert_eq!(absolute("//images.gog-statics.com/x.jpg"), "https://images.gog-statics.com/x.jpg");
90 assert_eq!(absolute("https://example.com/x.jpg"), "https://example.com/x.jpg");
91 }
92
93 /// Живой баг 2026-09-09: `gameDetails` реально отдаёт голый хэш без
94 /// расширения — `//images-1.gog-statics.com/9f71...31f4`, без `.jpg`.
95 /// Без дополнения этот адрес отвечает 404, с `.jpg` — тот же файл 200
96 /// (проверено вручную на всех шести играх библиотеки).
97 #[test]
98 fn голый_хэш_без_расширения_дополняется_jpg() {
99 assert_eq!(
100 absolute("//images-1.gog-statics.com/9f7189be4eca2ccd8bfb83e11bd3d8dc130d08199a97767a640a98435dad31f4"),
101 "https://images-1.gog-statics.com/9f7189be4eca2ccd8bfb83e11bd3d8dc130d08199a97767a640a98435dad31f4.jpg"
102 );
103 }
104
105 #[test]
106 fn готовая_обложка_не_перекачивается() {
107 let d = std::env::temp_dir().join("chl-test-gog-covers");
108 std::fs::remove_dir_all(&d).ok();
109 std::fs::create_dir_all(&d).unwrap();
110 let p = path_for(&d, "1207658930");
111 std::fs::write(&p, "уже скачано").unwrap();
112 let got = fetch(&d, "1207658930", "http://127.0.0.1:1/нет").unwrap();
113 assert_eq!(got, p);
114 std::fs::remove_dir_all(&d).ok();
115 }
116}
117
118#[cfg(test)]
119mod temp_verify {
120 #[test]
121 #[ignore]
122 fn real_fetch_after_fix() {
123 let cache = std::env::temp_dir().join("chl-gog-cover-verify");
124 std::fs::remove_dir_all(&cache).ok();
125 let url = "//images-1.gog-statics.com/9f7189be4eca2ccd8bfb83e11bd3d8dc130d08199a97767a640a98435dad31f4";
126 let p = super::fetch(&cache, "2016844216", url).unwrap();
127 println!("saved to: {}", p.display());
128 println!("size: {}", std::fs::metadata(&p).unwrap().len());
129 }
130}
131