Struct poem::i18n::I18NBundle

pub struct I18NBundle(/* private fields */);

Available on crate feature i18n only.

A collection of localization messages.

Implementations

impl I18NBundle

pub fn text_with_args<'a>( &self, id: impl AsRef<str>, args: impl Into<I18NArgs<'a>> ) -> Result<String, I18NError>

Gets the text with arguments.

Example

use poem::i18n::I18NResources;
use unic_langid::langid;

let resources = I18NResources::builder()
    .add_ftl(
        "en-US",
        "input-parse-error = Error: Could not parse input `{ $input }`. Reason: { $reason }",
    )
    .build()
    .unwrap();
let bundle = resources.negotiate_languages(&[langid!("en-US")]);

let err = "abc".parse::<i32>().unwrap_err();
assert_eq!(
    bundle
        .text_with_args(
            "input-parse-error",
            (("input", "abc"), ("reason", err.to_string()))
        )
        .unwrap(),
    "Error: Could not parse input `\u{2068}abc\u{2069}`. Reason: \u{2068}invalid digit found in string\u{2069}"
);

pub fn text(&self, id: impl AsRef<str>) -> Result<String, I18NError>

Gets the text.

Example

use poem::i18n::I18NResources;
use unic_langid::langid;

let resources = I18NResources::builder()
    .add_ftl("en-US", "hello-world = Hello world!")
    .build()
    .unwrap();
let bundle = resources.negotiate_languages(&[langid!("en-US")]);

assert_eq!(bundle.text("hello-world").unwrap(), "Hello world!");