# loon
[](https://docs.rs/loon/)
[](https://crates.io/crates/loon)
<h2>lo<span style="color:Silver;">[calizati]</span>on</h2>
A very simple localization/internationalization library, inspired by `ruby-i18n`.
Provides a (configurable) global `translate`/`t` function for convenience, as well
as a `Dictionary` builder/container if you prefer to manage state directly.
### Usage:
Global function:
```rust
fn main() {
use loon::*;
set_config(PathPattern("examples/locales/*.yml")).unwrap();
assert_eq!(
t("custom.greeting", Var("name", "Jacob")).unwrap(),
String::from("Hello, Jacob!!!")
);
assert_eq!(
t("greeting", Opts::default().locale("de")).unwrap(),
String::from("Hallo Welt!")
);
}
```
Using a `Dictionary`:
```rust
fn main() {
use loon::*;
let dict = Config::default()
.with_path_pattern("examples/locales/*.yml")
.finish()
.unwrap();
assert_eq!(
dict.translate("custom.greeting", Var("name", "Jacob")).unwrap(),
String::from("Hello, Jacob!!!")
);
assert_eq!(
dict.translate("greeting", Opts::default().locale("de")).unwrap(),
String::from("Hallo Welt!")
);
}
```
### Features
Translation files can be:
* JSON
* YAML (enabled by default, disable with `default-features = false`), or
* TOML (enable with `features = ["toml"]`).
<hr/>
Current version: 0.3.2
License: MIT