localoco 0.2.1

A utility library for internationlization in Rust.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38

//! # LocaLoco
//! Localoco is a simple library that brings the ability of translating strings to your
//! application. The core of it is to use a **translation key** to replace the string to be
//! displayed and then load a specified **strings file** (according to the language/region
//! settings).
//!
//! To ensure the loading of the so-called "string file" is fast, we compile it into a binary form
//! so that it will be easier to parse at runtime. This work could be done as your Rust code being
//! compiled. The strings file will be originally written in json, which is a human-readable text
//! format, and finally transpiled into a binary form, being ready to be loaded at runtime.

pub mod compiler;
pub mod strings;
pub mod util;

/// This module contains some utilities for buildscript.
pub mod buildscript;
pub mod locale_names;

#[cfg(test)]
#[allow(unused_imports)]
mod tests {
    use super::*;

    #[test]
    fn strings() {
        let mut s = strings::Strings::new("en_US", strings::Strings::find_locale_name("en_US"));
        s.add_string("ui.hello", "Hello, World! ");
        s.add_string("ui.cancel", "Cancel");
        assert_eq!(s.get_lang_id(), "en_US");
        assert_eq!(s.get_lang_name(), "English (United States)");
        assert_eq!(s.translate("ui.hello"), "Hello, World! ");
        assert_eq!(s.translate("key.not.exist"), "key.not.exist");
        let bytes = compiler::compile(&s.jsonize()).unwrap();
        let recov = strings::Strings::load(&bytes).unwrap();
        assert_eq!(s.translate("ui.hello"), recov.translate("ui.hello"));
    }
}