cargo-port 0.1.2

A TUI for inspecting and managing Rust projects
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

//! Per-user themes directory path for cargo-port.
//!
//! The framework owns theme types, registry assembly, the directory
//! watch, the resolver, and the OS appearance poller. The app owns
//! the on-disk location: `dirs::config_dir() / "cargo-port" / "themes"`.

#[cfg(test)]
use std::cell::RefCell;
use std::path::PathBuf;

use crate::constants::APP_NAME;

const THEMES_DIRNAME: &str = "themes";

/// Compute the per-user themes directory:
/// `dirs::config_dir() / "cargo-port" / "themes"`.
///
/// Returns `None` on platforms where the OS config dir can't be
/// resolved (extremely rare; same conservative behavior as
/// [`crate::config::config_path`]). Tests can override via
/// `set_themes_dir_override_for_test`.
#[must_use]
pub(crate) fn themes_dir() -> Option<PathBuf> {
    #[cfg(test)]
    if let Some(path) = THEMES_DIR_OVERRIDE.with(|slot| slot.borrow().clone()) {
        return Some(path);
    }
    dirs::config_dir().map(|d| d.join(APP_NAME).join(THEMES_DIRNAME))
}

#[cfg(test)]
thread_local! {
    static THEMES_DIR_OVERRIDE: RefCell<Option<PathBuf>> = const {
        RefCell::new(None)
    };
}

/// Test-only override for the themes directory.
#[cfg(test)]
pub(crate) struct ThemesDirOverrideGuard {
    previous: Option<PathBuf>,
}

#[cfg(test)]
impl Drop for ThemesDirOverrideGuard {
    fn drop(&mut self) {
        let previous = self.previous.take();
        THEMES_DIR_OVERRIDE.with(|slot| {
            *slot.borrow_mut() = previous;
        });
    }
}

/// Point [`themes_dir`] at `path` for the duration of the returned
/// guard. Tests use this to point the scan at a temp directory.
#[cfg(test)]
pub(crate) fn set_themes_dir_override_for_test(path: PathBuf) -> ThemesDirOverrideGuard {
    let previous = THEMES_DIR_OVERRIDE.with(|slot| slot.replace(Some(path)));
    ThemesDirOverrideGuard { previous }
}

#[cfg(test)]
#[allow(
    clippy::expect_used,
    clippy::unwrap_used,
    reason = "tests should panic on unexpected values"
)]
mod tests {
    use super::*;

    #[test]
    fn themes_dir_override_routes_through_themes_dir() {
        let dir = std::env::temp_dir().join(format!(
            "cargo_port_themes_override_route_{}",
            std::process::id()
        ));
        let _guard = set_themes_dir_override_for_test(dir.clone());
        let resolved = themes_dir().expect("override returns Some");
        assert_eq!(resolved, dir);
    }
}