zccache 1.11.0

Local-first compiler cache for C/C++/Rust/Emscripten
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

//! Compiler family detection from the compiler executable path.

use super::CompilerFamily;

/// Source file extensions we recognize as C/C++.
pub(crate) const SOURCE_EXTENSIONS: &[&str] = &[
    "c", "cc", "cpp", "cxx", "c++", "C", "m", "mm", "i", "ii", "cppm", "ixx",
];

/// File extensions that imply module-interface mode even without `-x c++-module`.
pub(crate) const MODULE_EXTENSIONS: &[&str] = &["cppm", "ixx"];

/// Detect the compiler family from the compiler path.
#[must_use]
pub fn detect_family(compiler: &str) -> CompilerFamily {
    // Split on both `/` and `\` so Windows-style paths work on all platforms.
    let basename = compiler.rsplit(['/', '\\']).next().unwrap_or(compiler);
    let name = match basename.rsplit_once('.') {
        Some((stem, _)) => stem,
        None => basename,
    };
    if name == "rustfmt" || name.starts_with("rustfmt-") {
        CompilerFamily::Rustfmt
    } else if name == "rustc"
        || name.starts_with("rustc-")
        || name == "clippy-driver"
        || name.starts_with("clippy-driver-")
    {
        CompilerFamily::Rustc
    } else if is_clang_cl_name(name) {
        // `clang-cl` speaks MSVC argument syntax. It must be classified as
        // Msvc so the MSVC parser handles `/Fo`, `/c`, etc. Misclassifying
        // it as Clang caused issue #261 (Windows builds with 0 cached / 0
        // cold / 0 non-cacheable despite total > 0).
        CompilerFamily::Msvc
    } else if name.contains("clang") || name == "emcc" || name == "em++" {
        CompilerFamily::Clang
    } else if name.eq_ignore_ascii_case("cl") {
        CompilerFamily::Msvc
    } else {
        CompilerFamily::Gcc
    }
}

/// Whether the executable basename refers to clang-cl (the MSVC-syntax driver).
///
/// Matches `clang-cl`, `clang-cl-17`, `Clang-CL.EXE`, etc. `name` is the
/// stem with any final `.<ext>` already stripped by `detect_family`.
pub(crate) fn is_clang_cl_name(name: &str) -> bool {
    let lower = name.to_ascii_lowercase();
    lower == "clang-cl" || lower.starts_with("clang-cl-")
}

/// Check if a path looks like a C/C++ source file.
pub(crate) fn is_source_file(path: &str) -> bool {
    if let Some(ext) = std::path::Path::new(path)
        .extension()
        .and_then(|e| e.to_str())
    {
        SOURCE_EXTENSIONS.contains(&ext)
    } else {
        false
    }
}