zendriver-fetcher 0.1.13

Chrome binary downloader for zendriver
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

//! Cache directory layout + path resolution.
//!
//! The on-disk layout matches the Chrome for Testing zip layout:
//!
//! ```text
//! <cache_dir>/
//!   <version>/
//!     chrome-<platform_cft>/
//!       chrome                                            (Linux)
//!       chrome.exe                                        (Windows)
//!       Google Chrome for Testing.app/Contents/MacOS/...  (macOS)
//! ```
//!
//! Per-version dirs are written atomically: download + extract land under
//! a `<version>.tmp/` sibling, then a single rename promotes it.

use std::env;
use std::path::{Path, PathBuf};

use crate::platform::Platform;

/// Default cache root: OS cache dir if available, otherwise the temp dir.
///
/// Always suffixed with `zendriver/chrome` so multiple consumers don't
/// collide at the top level.
pub(crate) fn default_cache_dir() -> PathBuf {
    dirs::cache_dir()
        .unwrap_or_else(env::temp_dir)
        .join("zendriver/chrome")
}

/// Path to the Chrome binary inside the extracted, cached version dir.
///
/// Matches the Chrome for Testing zip layout — see module docs.
pub(crate) fn binary_path(cache_dir: &Path, version: &str, platform: Platform) -> PathBuf {
    cache_dir.join(version).join(binary_subpath(platform))
}

/// Path to the Chrome binary *relative* to the version directory.
///
/// Used by both [`binary_path`] (against the published `<cache>/<version>/`
/// layout) and the fetcher's permission-fix step (against the in-progress
/// `<cache>/<version>.tmp/` staging dir, so the binary is executable
/// *before* it is atomically renamed into place).
pub(crate) fn binary_subpath(platform: Platform) -> PathBuf {
    match platform {
        Platform::LinuxX64 => PathBuf::from("chrome-linux64").join("chrome"),
        Platform::MacX64 => PathBuf::from("chrome-mac-x64")
            .join("Google Chrome for Testing.app")
            .join("Contents")
            .join("MacOS")
            .join("Google Chrome for Testing"),
        Platform::MacArm64 => PathBuf::from("chrome-mac-arm64")
            .join("Google Chrome for Testing.app")
            .join("Contents")
            .join("MacOS")
            .join("Google Chrome for Testing"),
        Platform::Win32 => PathBuf::from("chrome-win32").join("chrome.exe"),
        Platform::Win64 => PathBuf::from("chrome-win64").join("chrome.exe"),
    }
}

#[cfg(test)]
#[allow(clippy::panic, clippy::unwrap_used)]
mod tests {
    use super::*;

    #[test]
    fn default_cache_dir_ends_with_zendriver_chrome() {
        let p = default_cache_dir();
        assert!(
            p.ends_with("zendriver/chrome"),
            "expected suffix zendriver/chrome, got {}",
            p.display()
        );
    }

    #[test]
    fn binary_path_linux_layout() {
        let root = Path::new("/tmp/cache");
        let p = binary_path(root, "120.0.6099.234", Platform::LinuxX64);
        assert_eq!(
            p,
            Path::new("/tmp/cache/120.0.6099.234/chrome-linux64/chrome")
        );
    }

    #[test]
    fn binary_path_mac_arm64_layout() {
        let root = Path::new("/tmp/cache");
        let p = binary_path(root, "120.0.6099.234", Platform::MacArm64);
        assert_eq!(
            p,
            Path::new(
                "/tmp/cache/120.0.6099.234/chrome-mac-arm64/Google Chrome for Testing.app/Contents/MacOS/Google Chrome for Testing"
            )
        );
    }

    #[test]
    fn binary_path_win64_layout() {
        let root = Path::new("/tmp/cache");
        let p = binary_path(root, "120.0.6099.234", Platform::Win64);
        assert_eq!(
            p,
            Path::new("/tmp/cache/120.0.6099.234/chrome-win64/chrome.exe")
        );
    }
}