source-vmt 0.3.0

Rust parser and manager for Source Engine VMT files, supporting patch inheritance, material proxies, and key interning
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

#[cfg(feature = "intern_keys")]
use std::sync::{Arc, LazyLock};

#[cfg(feature = "intern_keys")]
static KEY_POOL: LazyLock<dashmap::DashSet<Arc<str>>> = LazyLock::new(|| dashmap::DashSet::new());

#[cfg(feature = "intern_keys")]
pub type VmtKey = Arc<str>;

#[cfg(not(feature = "intern_keys"))]
pub type VmtKey = String;

/// Interns a string into a global pool if "intern_keys" is enabled.
/// Converts the key to lowercase for normalized lookups.
pub fn intern_key(s: &str) -> VmtKey {
    #[cfg(feature = "intern_keys")]
    {
        // First try to find the key without allocating a new lowercase string.
        if let Some(existing) = KEY_POOL.get(s) {
            return Arc::clone(&existing);
        }

        let lower = s.to_lowercase();
        // Check again after lowercasing (in case it wasn't lowercase)
        if let Some(existing) = KEY_POOL.get(lower.as_str()) {
            return Arc::clone(&*existing);
        }

        let arc: Arc<str> = Arc::from(lower);
        KEY_POOL.insert(Arc::clone(&arc));
        arc
    }
    #[cfg(not(feature = "intern_keys"))]
    {
        s.to_lowercase()
    }
}