Merge pull request #815 from renyuneyun/i18n-fallback

Add i18n fallback

Author: Manishearth

Cargo.lock

@@ -9,6 +9,7 @@ lazy_static = "1.2.0"
 fluent = "0.5"
 fluent-bundle = "0.6.0"
 fluent-syntax = "0.9.0"
+fluent-locale = "0.4.1"
 rand = "0.6"
 regex = "1"
 rocket = "0.4.1"

Cargo.toml

@@ -15,21 +15,50 @@ use std::io::prelude::*;
 use std::path::Path;
 
 use fluent_bundle::{FluentBundle, FluentResource, FluentValue};
+use fluent_locale::negotiate_languages;
 
 lazy_static! {
     static ref CORE_RESOURCE: FluentResource =
         read_from_file("./locales/core.ftl").expect("cannot find core.ftl");
     static ref RESOURCES: HashMap<String, Vec<FluentResource>> = build_resources();
     static ref BUNDLES: HashMap<String, FluentBundle<'static>> = build_bundles();
+    static ref LOCALES: Vec<String> = build_locale_list();
+}
+
+pub struct Fallback<'res> {
+    default: Option<&'res str>,
+    availables: &'res Vec<String>,
+}
+
+impl<'res> Fallback<'res> {
+    pub fn new(available_locales: &'res Vec<String>) -> Self {
+        Self {
+            default: Some("en-US"),
+            availables: available_locales,
+        }
+    }
+
+    pub fn order<'t, T: AsRef<str>>(&'t self, targets: &'t [T]) -> Vec<&'t str> {
+        negotiate_languages(
+            targets,
+            &self.availables,
+            self.default,
+            &fluent_locale::NegotiationStrategy::Filtering,
+        )
+    }
 }
 
 pub struct I18NHelper {
     bundles: &'static HashMap<String, FluentBundle<'static>>,
+    fallback: Fallback<'static>,
 }
 
 impl I18NHelper {
     pub fn new() -> Self {
-        Self { bundles: &*BUNDLES }
+        Self {
+            bundles: &*BUNDLES,
+            fallback: Fallback::new(&*LOCALES),
+        }
     }
 
     pub fn lookup(
@@ -60,17 +89,12 @@ impl I18NHelper {
         text_id: &str,
         args: Option<&HashMap<&str, FluentValue>>,
     ) -> String {
-        if let Some(val) = self.lookup(lang, text_id, args) {
-            val
-        } else if lang != "en-US" {
-            if let Some(val) = self.lookup("en-US", text_id, args) {
-                val
-            } else {
-                format!("Unknown localization {}", text_id)
+        for l in self.fallback.order(&[lang]) {
+            if let Some(val) = self.lookup(l, text_id, args) {
+                return val;
             }
-        } else {
-            format!("Unknown localization {}", text_id)
         }
+        format!("Unknown localization {}", text_id)
     }
 }
 
@@ -310,6 +334,14 @@ pub fn create_bundle(lang: &str, resources: &'static Vec<FluentResource>) -> Flu
     bundle
 }
 
+fn build_locale_list() -> Vec<String> {
+    let mut locale_list = Vec::new();
+    for key in RESOURCES.keys() {
+        locale_list.push(key.clone());
+    }
+    locale_list
+}
+
 fn build_resources() -> HashMap<String, Vec<FluentResource>> {
     let mut all_resources = HashMap::new();
     let entries = read_dir("./locales").unwrap();