age/
i18n.rs

Help
1use i18n_embed::{
2    fluent::{fluent_language_loader, FluentLanguageLoader},
3    unic_langid::LanguageIdentifier,
4    I18nEmbedError, LanguageLoader, Localizer,
5};
6use lazy_static::lazy_static;
7use rust_embed::RustEmbed;
8
9#[derive(RustEmbed)]
10#[folder = "i18n"]
11struct Localizations;
12
13lazy_static! {
14    pub(crate) static ref LANGUAGE_LOADER: FluentLanguageLoader = {
15        let language_loader = fluent_language_loader!();
16        // Ensure that the fallback language is always loaded, even if the library user
17        // doesn't call `localizer().select(languages)`.
18        let fallback: LanguageIdentifier = "en-US".parse().unwrap();
19        language_loader.load_languages(&Localizations, &[&fallback]).unwrap();
20        language_loader
21    };
22}
23
24/// Loads a localized age string.
25#[doc(hidden)]
26#[macro_export]
27macro_rules! fl {
28    ($message_id:literal) => {{
29        i18n_embed_fl::fl!($crate::i18n::LANGUAGE_LOADER, $message_id)
30    }};
31
32    ($message_id:literal, $($args:expr),* $(,)?) => {{
33        i18n_embed_fl::fl!($crate::i18n::LANGUAGE_LOADER, $message_id, $($args), *)
34    }};
35}
36
37/// age-localized version of the write! macro.
38#[doc(hidden)]
39#[macro_export]
40macro_rules! wfl {
41    ($f:ident, $message_id:literal) => {
42        write!($f, "{}", $crate::fl!($message_id))
43    };
44
45    ($f:ident, $message_id:literal, $($args:expr),* $(,)?) => {
46        write!($f, "{}", $crate::fl!($message_id, $($args), *))
47    };
48}
49
50/// age-localized version of the writeln! macro.
51#[doc(hidden)]
52#[macro_export]
53macro_rules! wlnfl {
54    ($f:ident, $message_id:literal) => {
55        writeln!($f, "{}", $crate::fl!($message_id))
56    };
57
58    ($f:ident, $message_id:literal, $($args:expr),* $(,)?) => {
59        writeln!($f, "{}", $crate::fl!($message_id, $($args), *))
60    };
61}
62
63/// Returns the [`Localizer`] to be used for localizing this library.
64///
65/// # Examples
66///
67/// ```
68/// // Fetch the set of languages that the user's desktop environment requests.
69/// let requested_languages = i18n_embed::DesktopLanguageRequester::requested_languages();
70///
71/// // Localize the age crate based on the requested languages.
72/// //
73/// // If none of the requested languages are available, or if this function
74/// // is not called, age defaults to en-US.
75/// age::localizer().select(&requested_languages).unwrap();
76/// ```
77pub fn localizer() -> Box<dyn Localizer> {
78    Box::from(AgeLocalizer)
79}
80
81struct AgeLocalizer;
82
83impl Localizer for AgeLocalizer {
84    fn language_loader(&self) -> &'_ dyn LanguageLoader {
85        &*LANGUAGE_LOADER
86    }
87
88    fn i18n_assets(&self) -> &'_ dyn i18n_embed::I18nAssets {
89        &Localizations
90    }
91
92    fn select(
93        &self,
94        requested_languages: &[LanguageIdentifier],
95    ) -> Result<Vec<LanguageIdentifier>, I18nEmbedError> {
96        let supported_languages =
97            i18n_embed::select(&*LANGUAGE_LOADER, &Localizations, requested_languages)?;
98        // Unfortunately the common Windows terminals don't support Unicode Directionality
99        // Isolation Marks, so we disable them for now.
100        LANGUAGE_LOADER.set_use_isolating(false);
101        Ok(supported_languages)
102    }
103}
age/i18n.rs

age/
i18n.rs
