dotstate 0.3.4

A modern, secure, and user-friendly dotfile manager built with Rust
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
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135

//! Syntax theme selection utilities for syntax highlighting.
//!
//! This module provides a unified way to select syntax themes based on
//! the current UI theme type, avoiding duplication across the codebase.

use crate::styles::ThemeType;
use syntect::highlighting::{Theme, ThemeSet};

/// Get the appropriate syntax highlighting theme based on the current UI theme.
///
/// This function selects a syntax theme that matches the current UI theme type
/// (light, dark, or no-color mode). It tries preferred themes in order and
/// falls back to any available theme if none of the preferred ones are found.
///
/// # Arguments
///
/// * `theme_set` - The syntect `ThemeSet` containing available themes
/// * `theme_type` - The current UI theme type (Light, Dark, or `NoColor`)
///
/// # Returns
///
/// A reference to the selected syntax highlighting theme.
///
/// # Panics
///
/// Panics if no syntect themes are available at all (should never happen
/// with default themes loaded).
#[must_use]
pub fn get_syntax_theme(theme_set: &ThemeSet, theme_type: ThemeType) -> &Theme {
    let preferred_names = match theme_type {
        ThemeType::Light
        | ThemeType::SolarizedLight
        | ThemeType::GruvboxLight
        | ThemeType::CatppuccinLatte
        | ThemeType::TokyoNightLight => {
            vec!["base16-ocean.light", "Solarized (light)", "GitHub"]
        }
        ThemeType::SolarizedDark => vec!["Solarized (dark)", "base16-ocean.dark"],
        ThemeType::GruvboxDark => vec!["base16-eighties.dark", "base16-ocean.dark"],
        ThemeType::CatppuccinMocha => vec!["base16-mocha.dark", "base16-ocean.dark"],
        ThemeType::TokyoNightDark => vec!["base16-ocean.dark", "base16-eighties.dark"],
        ThemeType::Dark | ThemeType::NoColor | ThemeType::Midnight => vec![
            "base16-ocean.dark",
            "base16-eighties.dark",
            "base16-mocha.dark",
            "InspiredGitHub",
        ],
    };

    for name in &preferred_names {
        if let Some(theme) = theme_set.themes.get(*name) {
            return theme;
        }
    }

    theme_set
        .themes
        .values()
        .next()
        .expect("No syntect themes available")
}

/// Get the syntax theme using the current global UI theme.
///
/// This is a convenience function that automatically retrieves the current
/// UI theme type from the global theme settings.
///
/// # Arguments
///
/// * `theme_set` - The syntect `ThemeSet` containing available themes
///
/// # Returns
///
/// A reference to the selected syntax highlighting theme.
#[must_use]
pub fn get_current_syntax_theme(theme_set: &ThemeSet) -> &Theme {
    use crate::styles::theme as ui_theme;
    let theme_type = ui_theme().theme_type;
    get_syntax_theme(theme_set, theme_type)
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_get_syntax_theme_dark() {
        let theme_set = ThemeSet::load_defaults();
        let theme = get_syntax_theme(&theme_set, ThemeType::Dark);
        // Should not panic and return a valid theme
        assert!(!theme
            .name
            .as_ref()
            .is_none_or(std::string::String::is_empty));
    }

    #[test]
    fn test_get_syntax_theme_light() {
        let theme_set = ThemeSet::load_defaults();
        let theme = get_syntax_theme(&theme_set, ThemeType::Light);
        // Should not panic and return a valid theme
        assert!(!theme
            .name
            .as_ref()
            .is_none_or(std::string::String::is_empty));
    }

    #[test]
    fn test_get_syntax_theme_nocolor() {
        let theme_set = ThemeSet::load_defaults();
        let theme = get_syntax_theme(&theme_set, ThemeType::NoColor);
        // NoColor should fall back to dark theme preferences
        assert!(!theme
            .name
            .as_ref()
            .is_none_or(std::string::String::is_empty));
    }

    #[test]
    fn test_get_syntax_theme_solarized() {
        let theme_set = ThemeSet::load_defaults();

        let theme_dark = get_syntax_theme(&theme_set, ThemeType::SolarizedDark);
        assert!(!theme_dark
            .name
            .as_ref()
            .is_none_or(std::string::String::is_empty));

        let theme_light = get_syntax_theme(&theme_set, ThemeType::SolarizedLight);
        assert!(!theme_light
            .name
            .as_ref()
            .is_none_or(std::string::String::is_empty));
    }
}