glossa 0.0.1-alpha.5

A language localisation library
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

use crate::{assets::OnceCell, map_loader::Map, LangID, MapLoader};
use std::hash::BuildHasher;

impl<S: BuildHasher> MapLoader<S> {
    /// Creates a new "MapLoader" instance with the current system language ID.
    ///
    /// # Example
    ///
    /// ```no_run
    /// use glossa::fallback::FallbackChain;
    /// use crate::assets::localisation::locale_hashmap;
    ///
    /// let loader = glossa::MapLoader::new(locale_hashmap());
    /// let msg = loader.get_or_default("test", "hello");
    /// dbg!(msg);
    /// loader.show_chain();
    /// ```
    pub fn new(map: Map<S>) -> Self {
        Self {
            id: lang_id::sys_lang::current(),
            map,
            chain: OnceCell::new(),
        }
    }

    /// Similar to `new()`, but you need to pass in a specific language ID instead of letting it detect it automatically.
    ///
    /// # Example
    ///
    /// ```no_run
    /// use glossa::{
    ///     assets::lang_id_consts,
    ///     MapLoader,
    /// };
    /// use crate::assets::localisation::locale_hashmap;
    ///
    /// let id = unsafe { lang_id_consts::get_en_gb() };
    /// let loader = MapLoader::with_language_id(id, locale_hashmap());
    /// let msg = loader.get_or_default("test", "hello");
    /// dbg!(msg);
    /// ```
    pub fn with_language_id(id: LangID, map: Map<S>) -> Self {
        Self {
            id,
            map,
            chain: OnceCell::new(),
        }
    }
}

#[cfg(test)]
mod tests {
    use crate::{fallback::FallbackChain, GetText};

    // use super::*;
    #[test]
    fn new_map_loader() {
        use crate::{
            assets::localisation::locale_hashmap, fallback::FallbackChain,
            map_loader::MapLoader,
        };
        let loader = MapLoader::new(locale_hashmap());
        let _err_msg = loader.get("error", "text-not-found");

        loader.show_chain();

        let zh = unsafe { lang_id::consts::get_zh() };
        let map = &loader.get_map().get(&zh);

        map.map(|s| println!("{s:?}"));
    }

    #[test]
    fn from_lang_id_and_map() {
        use crate::{
            assets::{lang_id_consts, localisation::locale_hashmap},
            MapLoader,
        };

        let id = unsafe { lang_id_consts::get_el() };

        let loader = MapLoader::with_language_id(id, locale_hashmap());
        loader.show_chain();
        let msg = loader.get_or_default("test", "not-found");
        println!("{msg}");
    }
    #[test]
    fn new_loader() {
        use crate::assets::localisation::locale_hashmap;

        let loader = crate::MapLoader::new(locale_hashmap());
        loader.show_chain();
        let msg = loader.get_or_default("test", "hello");
        println!("{msg}");
    }
}