Struct poem::i18n::Locale

pub struct Locale { /* private fields */ }

Available on crate feature i18n only.

An extractor that parses the Accept-Language header and negotiates language bundles.

Example

use poem::{
    handler,
    http::header,
    i18n::{I18NResources, Locale},
    test::TestClient,
    Endpoint, EndpointExt, Request, Route,
};

let resources = I18NResources::builder()
    .add_ftl("en-US", "hello-world = hello world!")
    .add_ftl("zh-CN", "hello-world = 你好世界！")
    .build()
    .unwrap();

#[handler]
async fn index(locale: Locale) -> String {
    locale
        .text("hello-world")
        .unwrap_or_else(|_| "error".to_string())
}

let app = Route::new().at("/", index).data(resources);
let cli = TestClient::new(app);

let resp = cli
    .get("/")
    .header(header::ACCEPT_LANGUAGE, "en-US")
    .send()
    .await;
resp.assert_status_is_ok();
resp.assert_text("hello world!").await;

let resp = cli
    .get("/")
    .header(header::ACCEPT_LANGUAGE, "zh-CN")
    .send()
    .await;
resp.assert_status_is_ok();
resp.assert_text("你好世界！").await;

Implementations

impl Locale

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

Gets the text with arguments.

See also: I18NBundle::text_with_args

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

Gets the text.

See also: I18NBundle::text

Trait Implementations

impl<'a> FromRequest<'a> for Locale

async fn from_request(req: &'a Request, _body: &mut RequestBody) -> Result<Self>

Extract from request head and body.

fn from_request_without_body( req: &'a Request ) -> impl Future<Output = Result<Self>> + Send

Extract from request head.