Module poem::i18n

Available on crate feature i18n only.

Internationalization related types.

Load resources from file system

use poem::i18n::I18NResources;

let resources = I18NResources::builder()
    .add_path("/resources")
    .build()
    .unwrap();

Load resources from string

use poem::i18n::I18NResources;

let en_us = r#"
hello-world = Hello world!
welcome = Welcome { $name }!
"#;

let zh_cn = r#"
hello-world = 你好！
welcome = 欢迎 { $name }！
"#;

let resources = I18NResources::builder()
    .add_ftl("en-US", en_us)
    .add_ftl("zh-CN", zh_cn)
    .build()
    .unwrap();

Negotiation

use poem::i18n::I18NResources;
use unic_langid::{langid, langids};

let resources = I18NResources::builder()
    .add_path("/resources")
    .build()
    .unwrap();

let bundle = resources.negotiate_languages(&langids!("zh-CN", "en-US", "fr"));

// get text
let hello_world = bundle.text("hello-world").unwrap();

// get text with arguments
let welcome = bundle
    .text_with_args("welcome", (("name", "sunli"),))
    .unwrap();

Use extractor

See also: crate::i18n::Locale

Re-exports

• pub use unic_langid;

Structs

• I18NArgs
  Parameters for formatting the message.
• I18NBundle
  A collection of localization messages.
• I18NResources
  A resource for translating natural language.
• I18NResourcesBuilder
  I18N resources builder.
• Locale
  An extractor that parses the Accept-Language header and negotiates language bundles.

Enums

• NegotiationStrategy