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
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

use lang_id::error::LangidError;
use thiserror::Error;

use crate::{MiniStr as Key, MiniStr as MapName};

/// `Ok(T)` | `Err(GlossaError)`
pub type GlossaResult<T> = ::core::result::Result<T, GlossaError>;

#[derive(Debug, Error, PartialEq)]
pub enum GlossaError {
  #[error("{msg} (map: '{0}', key: '{1}')", msg = text_not_found())]
  MapTextNotFound(MapName, Key),
  #[error("{msg} (key: '{0}')", msg = text_not_found())]
  TextNotFound(Key),

  #[error("LangID Error: {0}")]
  LangIDError(#[from] LangidError),

  #[error("Failed to parse TinyStr: {0}")]
  ParseTinyStr(#[from] lang_id::error::ParseStrError),
}

impl Default for GlossaError {
  fn default() -> Self {
    LangidError::Unknown.into()
  }
}

impl GlossaError {
  /// Constructor function for TextNotFound error
  pub fn new_text_not_found<K: Into<Key>>(key: K) -> Self {
    Self::TextNotFound(key.into())
  }

  /// Constructor function for MapTextNotFound error
  pub fn new_map_text_not_found<M: Into<MapName>, K: Into<Key>>(
    map: M,
    key: K,
  ) -> Self {
    Self::MapTextNotFound(map.into(), key.into())
  }

  /// Returns `true` if the glossa error is [`LangIDError`].
  ///
  /// [`LangIDError`]: GlossaError::LangIDError
  #[must_use]
  pub fn is_langid_error(&self) -> bool {
    matches!(self, Self::LangIDError(..))
  }
}

#[cfg(feature = "std")]
pub(crate) fn get_error_text<'a>(language: &[u8]) -> Option<&'a str> {
  match glossa_l10n::error::matches::map(language) {
    "" => None,
    s => Some(s),
  }
}

#[cfg(feature = "std")]
pub(crate) fn text_not_found<'a>() -> &'a str {
  use glossa_l10n::error::default as default_text;

  use crate::LocaleContext;
  let all_locales = glossa_l10n::error::locale_registry::all_locales();

  match LocaleContext::default()
    .with_all_locales(all_locales)
    .get_or_try_init_chain()
  {
    Some(x) => x
      .iter()
      .map(|id| id.as_bytes())
      .find_map(get_error_text)
      .unwrap_or_else(default_text),
    _ => default_text(),
  }
}

#[cfg(not(feature = "std"))]
pub(crate) fn text_not_found<'a>() -> &'a str {
  glossa_l10n::error::default()
}

#[cfg(test)]
#[cfg(feature = "std")]
mod tests {
  use testutils::simple_benchmark;

  use super::*;

  #[ignore]
  #[test]
  /// - release: 250ns
  /// - debug: 2.833µs
  fn bench_get_err_text() {
    let _ = text_not_found();
    simple_benchmark(|| {
      let _text = text_not_found();
    });
  }

  #[ignore]
  #[test]
  fn test_err() {
    let err = GlossaError::new_text_not_found("greeting");
    println!("{err}");

    let err2 = GlossaError::new_map_text_not_found("abc.tmpl", "hello");
    println!("{err2}")
  }
}