Simple implementation

This commit is contained in:
Terry Raimondo 2019-10-03 13:56:43 +02:00
parent 9a19736f79
commit 09ad4390ac
4 changed files with 114 additions and 6 deletions

View File

@ -6,5 +6,10 @@ edition = "2018"
description = "Easy to use I18n" description = "Easy to use I18n"
keywords = ["i18n", "internationalization"] keywords = ["i18n", "internationalization"]
license = "MIT/Apache-2.0" license = "MIT/Apache-2.0"
repository = "https://github.com/terry90/internationalization-rs"
homepage = "https://github.com/terry90/internationalization-rs"
[dependencies] [dependencies]
lazy_static = "1.4.0"
glob = "0.3.0"
serde_json = "1.0.40"

17
README.md Normal file
View File

@ -0,0 +1,17 @@
# Internationalization
An simple i18n implementation in Rust.
> API documentation [https://crates.io/crates/internationalization](https://crates.io/crates/internationalization)
## Usage
```rust
use internationalization::{init_i18n, t};
fn main() {
init_i18n!("locales/*.json", "fr", "en");
let res = t("err.not_allowed");
assert_eq!("You are not allowed to do this", res);
}
```

63
src/i18n/mod.rs Normal file
View File

@ -0,0 +1,63 @@
use glob::glob;
use lazy_static::lazy_static;
use std::collections::HashMap;
use std::fs::File;
use std::io::BufReader;
use std::io::Read;
use std::sync::RwLock;
type Key = String;
type Locale = String;
type Value = String;
lazy_static! {
pub static ref TR: RwLock<HashMap<Key, HashMap<Locale, Value>>> = RwLock::new(HashMap::new());
}
pub fn read_files(pattern: &str) -> Vec<String> {
let mut contents = Vec::new();
for entry in glob(pattern).expect("Failed to read glob pattern") {
let file = File::open(entry.unwrap()).expect("Failed to open the file");
let mut reader = BufReader::new(file);
let mut content = String::new();
reader
.read_to_string(&mut content)
.expect("Failed to read the file");
contents.push(content);
}
contents
}
pub fn load_i18n(content: String) {
let res: HashMap<String, HashMap<String, String>> =
serde_json::from_str(&content).expect("Cannot parse I18n file");
TR.write().unwrap().extend(res);
}
/// Translates by key
///
/// # Panics
///
/// If a key is missing, the code will panic
/// If a locale is not present for the key, ths will also panic
///
/// # Example
/// ```no-run
/// use internationalization::t;
///
/// fn main() {
/// init_i18n!("locales/*.json", "fr", "en");
///
/// let res = t("err.not_allowed");
/// assert_eq!("You are not allowed to do this", res);
/// }
/// ```
pub fn t(key: &str, locale: &str) -> String {
match TR.read().unwrap().get(key) {
Some(trs) => match trs.get(locale) {
Some(value) => value.to_owned(),
None => panic!("Missing language ({}) for key: {}", locale, key),
},
None => panic!("Missing key: {}", key),
}
}

View File

@ -1,7 +1,30 @@
#[cfg(test)] //! # Internationalization
mod tests { //! An simple i18n implementation in Rust.
#[test]
fn it_works() { //! > API documentation [https://crates.io/crates/internationalization](https://crates.io/crates/internationalization)
assert_eq!(2 + 2, 4);
//! ## Usage
//!
//! ```
//! use internationalization::{init_i18n, t};
//!
//! fn main() {
//! init_i18n!("locales/*.json", "fr", "en");
//!
//! let res = t("err.not_allowed");
//! assert_eq!("You are not allowed to do this", res);
//! }
//! ```
pub mod i18n;
pub use i18n::t;
#[macro_export]
macro_rules! init_i18n {
( $path:expr, $( $lang:expr ),* ) => {
use internationalization::i18n::{load_i18n, read_files};
for content in read_files($path) {
load_i18n(content)
} }
};
} }