Struct Localizer 

pub struct Localizer { /* private fields */ }

Resolve localization messages for a specific locale.

The loader eagerly falls back to en-GB when the requested locale is not recognized. This mirrors the planned lookup order that surfaces explicit configuration, environment overrides, and finally the bundled fallback.

Implementations

impl Localizer

pub fn new(locale: Option<&str>) -> Self

Create a localizer for locale, falling back to crate::i18n::FALLBACK_LOCALE.

use whitaker_common::i18n::{available_locales, Localizer};

let locale = Localizer::new(Some("cy"));
assert!(available_locales().contains(&"cy".to_string()));
assert_eq!(locale.locale(), "cy");
assert!(!locale.used_fallback());

let fallback = Localizer::new(Some("zz"));
assert_eq!(fallback.locale(), "en-GB");
assert!(fallback.used_fallback());

pub fn language(&self) -> &LanguageIdentifier

Return the resolved locale identifier.

pub fn locale(&self) -> &str

Return the resolved locale as a string slice.

pub fn used_fallback(&self) -> bool

Whether the fallback locale was used.

pub fn message(&self, key: &str) -> Result<String, I18nError>

Fetch the translated message for key.

pub fn message_with_args( &self, key: &str, args: &Arguments<'_>, ) -> Result<String, I18nError>

Fetch the translated message with Fluent arguments.

pub fn attribute(&self, key: &str, attribute: &str) -> Result<String, I18nError>

Fetch a translated attribute, e.g. function.primary.

pub fn attribute_with_args( &self, key: &str, attribute: &str, args: &Arguments<'_>, ) -> Result<String, I18nError>

Fetch a translated attribute with Fluent arguments.

Trait Implementations

impl BundleLookup for Localizer

fn message( &self, key: MessageKey<'_>, args: &Arguments<'_>, ) -> Result<String, I18nError>

Resolve the primary message for key using args.

fn attribute( &self, key: MessageKey<'_>, attribute: AttrKey<'_>, args: &Arguments<'_>, ) -> Result<String, I18nError>

Resolve an attribute message for key.attribute using args.

impl Clone for Localizer

fn clone(&self) -> Localizer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Localizer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.