Přejít na obsah
Rust

Rust i18n

Crate Better I18N neexistuje. Služba v Rustu čte stejný JSON z CDN jako každé SDK — stačí reqwest a serde_json a nové texty vyjdou bez překladu aplikace.

Setup

Použijte Better I18N z Rustu

Přidejte crate pro HTTP a JSON

Stačí reqwest a serde_json — žádný crate Better I18N k instalaci neexistuje.

Cargo.toml
[dependencies]
reqwest = { version = "0.12", features = ["json"] }
serde_json = "1"
tokio = { version = "1", features = ["full"] }

Načtěte jmenný prostor

CDN poskytuje jeden JSON soubor na jmenný prostor a jazyk a vždy odpovídá 200.

src/i18n.rs
use std::collections::HashMap;

/// The CDN serves one JSON file per namespace, per locale:
///   https://cdn.better-i18n.com/{org}/{project}/{locale}/{namespace}.json
/// It always answers 200 — an unknown locale returns `{}` rather than an error.
pub async fn fetch_messages(
    locale: &str,
    namespace: &str,
) -> reqwest::Result<HashMap<String, serde_json::Value>> {
    let url = format!(
        "https://cdn.better-i18n.com/your-org/your-project/{locale}/{namespace}.json"
    );

    reqwest::get(&url).await?.json().await
}

Obnovujte na pozadí

Uložte mapu do cache v procesu a načítejte ji znovu každých 60 sekund, stejně jako max-age CDN.

src/main.rs
use std::time::Duration;

// Cache in process and re-read on an interval: the CDN sets
// `Cache-Control: max-age=60`, so a 60s refresh matches it exactly.
tokio::spawn(async move {
    let mut ticker = tokio::time::interval(Duration::from_secs(60));
    loop {
        ticker.tick().await;
        if let Ok(next) = fetch_messages("en", "common").await {
            *messages.write().await = next;
        }
    }
});
Capabilities

Co získají služby v Rustu

Žádné SDK není třeba — a crate pro Rust neexistuje, takže není na co čekat
Prostý JSON přes HTTPS, parsovaný pomocí serde_json
Funguje s axum, actix-web, Rocket i s prostou binárkou
Nové texty dorazí přibližně za 60 sekund bez překladu aplikace
REST API pokrývá vše, co nepokrývá CDN
Funguje vedle rust-i18n, pokud jej už používáte pro lokální katalogy
Example

Handler axum čtoucí zprávy z CDN

Zprávy leží za RwLock a obnovují se podle časovače.

use axum::{extract::State, routing::get, Json, Router};
use std::{collections::HashMap, sync::Arc};
use tokio::sync::RwLock;

type Messages = Arc<RwLock<HashMap<String, serde_json::Value>>>;

async fn greeting(State(messages): State<Messages>) -> Json<serde_json::Value> {
    let messages = messages.read().await;

    let hello = messages
        .get("greeting.hello")
        .and_then(|v| v.as_str())
        .unwrap_or("Hello");

    Json(serde_json::json!({ "message": hello }))
}

#[tokio::main]
async fn main() {
    let messages: Messages = Arc::new(RwLock::new(
        fetch_messages("en", "common").await.unwrap_or_default(),
    ));

    let app = Router::new()
        .route("/greeting", get(greeting))
        .with_state(messages);

    let listener = tokio::net::TcpListener::bind("0.0.0.0:3000").await.unwrap();
    axum::serve(listener, app).await.unwrap();
}

Související témata

Server-side i18nThe same request-scoped translator pattern, in the runtime that does have an SDK.Hono i18nIf part of your stack is TypeScript, this is the API-side equivalent.Ruby i18nAnother runtime we serve over the CDN and REST API rather than a native package.

Další frameworky

React i18nNext.js i18nVue i18nNuxt i18nAngular i18nSvelte i18nVite i18nRemix & Hydrogen i18nExpo i18niOS i18nFlutter i18nTanStack Start i18nServer i18nHono i18n

Get started

Lokalizujte svou službu v Rustu

Vytvořte projekt, publikujte první jazyk a čtěte jej z Rustu přes HTTPS.

Začít zdarmaPřečíst dokumentaci