1 unstable release

0.0.1 Jan 7, 2024

#96 in #compact

MIT license

21KB
453 lines

rs-i18n

A lightweight and compact I18n library

QuickStart

1. install dependencies

cargo add rs-i18n
cargo add lazy_static

2. write i18n json file

-- your project
|---- i18n
|       |-- en_US.json
|       |-- zh_CN.json

en_US.json

{
  "HELLO":"hello",
  "HAPPY":"satisfied",
  "JOY":"good"
}

zh_CN.json

{
  "HELLO":"你好",
  "HAPPY":"开心",
  "JOY":"欢快"
}

3. main.rs

#[macro_use]
extern crate lazy_static;

use rs_i18n::{I18ns, Loader, UseI18n};

// if use absolute path, you should pay attention that the path should write from root
// means :
// It is an absolute path based on the root directory as the standard
lazy_static! {
    static ref LOADER: Loader = Loader::new(Some("./i18n"));
}

fn main() {
    let mut i18n = UseI18n::new(
        &LOADER,
        None,
    );
    // change lang
    // i18n.set_lang(I18ns::ENUS);
    println!("{}", i18n.t("JOY"));
}

Use Dev (recommend)

add strum

cargo add strum --feature derive
----or----
strum = { version = "0.25", features = ["derive"] }

main.rs

#[macro_use]
extern crate lazy_static;

use rs_i18n::{I18ns, Loader, UseI18n};
mod i18n_dict;

use i18n_dict::I18nDict;

lazy_static! {
    static ref LOADER: Loader = Loader::new(Some("./i18n"));
}
fn main() {
    // donot use absoulte path
    let mut i18n = UseI18n::new(
        &LOADER,
        Some("E:\\Rust\\try\\rs-i18n-all\\i18n-test\\src\\i18n_dict.rs"),
    );
    println!("{}", i18n.t(&format!("{:?}", I18nDict::HAPPY)));
}

Goals

  • translate
  • get system lang as default
  • dev
  • date format

Dependencies

~0.5–1MB
~20K SLoC