opaline 0.2.0

A token-based theme engine for Ratatui TUI applications
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

use std::env;
use std::fmt::Write;
use std::fs;
use std::path::Path;

fn main() {
    println!("cargo::rerun-if-changed=src/builtins/");

    let builtins_dir = Path::new("src/builtins");
    let mut themes: Vec<(String, String)> = Vec::new(); // (file_stem, display_name)

    if let Ok(entries) = fs::read_dir(builtins_dir) {
        for entry in entries.flatten() {
            let path = entry.path();
            if path.extension().is_some_and(|e| e == "toml") {
                let stem = path
                    .file_stem()
                    .expect("file has stem")
                    .to_str()
                    .expect("valid UTF-8")
                    .to_string();

                // Extract display name from [meta] section via simple string parsing
                let contents = fs::read_to_string(&path).expect("readable TOML");
                let display_name = extract_meta_name(&contents).unwrap_or_else(|| stem.clone());

                themes.push((stem, display_name));
            }
        }
    }

    themes.sort_by(|a, b| a.0.cmp(&b.0));

    let out_dir = env::var("OUT_DIR").expect("OUT_DIR set");
    let dest = Path::new(&out_dir).join("builtins_generated.rs");

    let mut code = String::new();

    // include_str! constants
    for (stem, _) in &themes {
        let const_name = stem.replace('-', "_").to_uppercase();
        writeln!(
            code,
            "const {const_name}_TOML: &str = include_str!(concat!(env!(\"CARGO_MANIFEST_DIR\"), \"/src/builtins/{stem}.toml\"));"
        ).expect("write to String");
    }

    // Static name registry: &[(&str, &str)] — (kebab-id, display-name)
    writeln!(
        code,
        "\n/// Auto-generated list of (kebab-id, display-name) for all builtin themes."
    )
    .expect("write to String");
    writeln!(code, "const GENERATED_BUILTIN_NAMES: &[(&str, &str)] = &[").expect("write to String");
    for (stem, display) in &themes {
        let id = stem.replace('_', "-");
        let escaped = display.replace('\\', "\\\\").replace('"', "\\\"");
        writeln!(code, "    (\"{id}\", \"{escaped}\"),").expect("write to String");
    }
    writeln!(code, "];").expect("write to String");

    // load_toml match
    writeln!(code, "\n/// Auto-generated TOML lookup by kebab-case ID.").expect("write to String");
    writeln!(
        code,
        "fn generated_load_toml(id: &str) -> Option<&'static str> {{\n    match id {{"
    )
    .expect("write to String");
    for (stem, _) in &themes {
        let id = stem.replace('_', "-");
        let const_name = stem.replace('-', "_").to_uppercase();
        writeln!(code, "        \"{id}\" => Some({const_name}_TOML),").expect("write to String");
    }
    writeln!(code, "        _ => None,").expect("write to String");
    writeln!(code, "    }}\n}}").expect("write to String");

    // Count
    writeln!(
        code,
        "\n/// Number of auto-discovered builtin themes.\nconst GENERATED_BUILTIN_COUNT: usize = {};",
        themes.len()
    ).expect("write to String");

    fs::write(dest, code).expect("write generated code");
}

/// Extract the `name` field from the `[meta]` section using simple string parsing.
/// No TOML crate needed — just looks for `name = "..."` after `[meta]`.
fn extract_meta_name(toml: &str) -> Option<String> {
    let mut in_meta = false;
    for line in toml.lines() {
        let trimmed = line.trim();
        if trimmed == "[meta]" {
            in_meta = true;
            continue;
        }
        if trimmed.starts_with('[') && trimmed != "[meta]" {
            in_meta = false;
            continue;
        }
        if in_meta && trimmed.starts_with("name") {
            // Parse: name = "Display Name"
            if let Some(value) = trimmed.split('=').nth(1) {
                let value = value.trim().trim_matches('"');
                return Some(value.to_string());
            }
        }
    }
    None
}