glossa 0.0.6

Generates an array based on the similarity between the current locale and all available locales.
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

use lang_id::{LangID, sys_locale};
pub use testutils::new_once_lock;

/// Retrieves system locale with platform-specific implementations.
///
/// If you don't need to modify the system's language during program execution,
/// you can use [get_static_locale()]. Since the [get_static_locale()] supports
/// locale caching, it's more efficient than [retrieve_locale()].
///
/// ## Example
///
/// ```
/// use glossa::sys::retrieve_locale;
///
/// let current_locale = retrieve_locale();
/// // assert_eq!(current_locale.to_string(), "en-US");
/// ```
pub fn retrieve_locale() -> LangID {
  match () {
    #[cfg(not(target_os = "macos"))]
    () => sys_locale::retrieve_sys_or_env_lang(),
    #[cfg(target_os = "macos")]
    () => sys_locale::retrieve_env_lang_or_sys_locale(),
  }
}

/// Gets the system's primary locale(language identifier) with thread-safe
/// initialization.
///
/// > It supports caching the locale.
/// >
/// > In essence, [get_static_locale()] persists the result of
/// > [retrieve_locale()]
/// > as a static variable.
///
/// Implements platform-specific detection strategies:
/// - macOS: Prioritizes environment variables before system settings
/// - Other OS: Uses system locale APIs with environment fallback
pub fn get_static_locale() -> &'static LangID {
  new_once_lock!(LANG: LangID);
  LANG.get_or_init(retrieve_locale)
}

#[cfg(test)]
mod tests {
  use testutils::dbg_ref;

  use super::*;
  use crate::{LocaleContext, fallback::dbg_shared::init_logger};

  #[ignore]
  #[test]
  fn test_get_or_init_posix_language_chain() {
    init_logger(true);
    // unsafe {
    //   std::env::set_var("LANG", "POSIX.UTF-8");
    // };
    dbg_ref!(get_static_locale());

    let all_locales = {
      use lang_id::consts::*;
      [
        lang_id_en(),
        lang_id_zh(),
        lang_id_ar(),
        lang_id_de(),
        lang_id_ru(),
        lang_id_es_419(),
      ]
    };

    let ctx = LocaleContext::default().with_all_locales(all_locales);

    let chain = ctx.get_or_try_init_chain();

    dbg!(chain);
  }
}