Struct Localizer 

pub struct Localizer<'this> { /* private fields */ }

Heart and soul of this crated. Intended to be initialized once.

Implementations

impl<'this> Localizer<'this>

pub fn new(locales_path: impl AsRef<Path>) -> Self

Creates new Localizer and searches for available locales in specified folder.

pub fn precache_all(self) -> Self

Loads all available locales into internal cache.

pub fn debug(self, enable: bool) -> Self

Enables debug mode. This mostly means that Localizer will prefer fetching locales from disk rather than cache.

pub fn default_locale(self, default_locale: &'static str) -> Self

pub fn localize<'w>(&mut self, tag: &'w str) -> Result<&Locale, LocaleError>

where 'w: 'this,

Normal mode

Looks up cache for tag. If not found fetches locale from disk and overwrites old value in cache, returns a reference to new locale afterwards. Otherwise returns cached value.

Debug mode

Looks up available locales on disk for specified tag. If found, overwrites locale in cache with value from disk and returns a reference to it. Otherwise tries to fetch the locale from cache.

pub fn localize_no_cache<'w>( &self, tag: &'w str, ) -> Result<Cow<'_, Locale>, LocaleError>

where 'w: 'this,

Normal mode

Looks up cache for tag. If not found fetches locale from disk and returns borrowed value of it. Otherwise returns cached value.

Debug mode

Looks up available locales for specified tag. If found fetches locale from disk and returns owned value of it. Otherwise returns an error.