Implement i18n_args(...) function (#12)

HLXEasy · web-flow · commit 3b5354c0f85d · 2024-08-06T00:32:13.000+03:00
diff --git a/i18n/src/i18n.rs b/i18n/src/i18n.rs
@@ -14,6 +14,7 @@ static mut JSON_DATA_GUARD: Option<Mutex<()>> = None;
 static DICTIONARY: ArcSwapOption<Dictionary> = ArcSwapOption::const_empty();
 
 pub type StoreFn = dyn Send + Sync + Fn(&str) -> Result<()> + 'static;
+pub type DictionaryArgs<'a> = Vec<(&'static str, &'a str)>;
 
 pub struct Builder {
     current_code: String,
@@ -272,6 +273,21 @@ pub fn i18n(text: &str) -> &str {
     }
 }
 
+/// Translate a string to the currently user-selected language
+/// and replace given placeholders with given values.
+/// Parameter 'replacements' is a vector consisting of key value pairs,
+/// where the key is the placeholder within 'text'.
+pub fn i18n_args(text: &str, replacements: DictionaryArgs) -> String {
+    let mut translated = String::from(i18n(text));
+
+    for (key, value) in replacements {
+        let placeholder = format!("{{{}}}", key);
+        translated = str::replace(&translated, &placeholder, value);
+    }
+
+    translated
+}
+
 /// Dictionary structure containing all translations and related data.
 pub struct Dictionary {
     /// list of languages {"en": "English", "ja": "日本語", ..."}
diff --git a/i18n/src/lib.rs b/i18n/src/lib.rs
@@ -14,6 +14,7 @@ pub mod json;
 pub mod result;
 
 pub use i18n::i18n;
+pub use i18n::i18n_args;
 
 pub mod prelude {
     pub use crate::i18n;
