translatable 1.0.0

A robust internationalization solution for Rust featuring compile-time validation, ISO 639-1 compliance, and TOML-based translation management.
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
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

use std::env::{remove_var, set_var};
use std::fs::canonicalize;
use std::sync::Mutex;

use trybuild::TestCases;

mod integration;

const PATH_ENV: &str = "TRANSLATABLE_LOCALES_PATH";
const OVERLAP_ENV: &str = "TRANSLATABLE_OVERLAP";

static ENV_MUTEX: Mutex<()> = Mutex::new(());

macro_rules! lock_env {
    () => {
        let _env_guard = ENV_MUTEX.lock();
    };
}

#[inline]
unsafe fn set_default_env() {
    unsafe {
        set_locales_env("everything_valid");
        remove_var(OVERLAP_ENV);
    }
}

#[inline]
unsafe fn set_locales_env(env: &str) {
    unsafe {
        set_var(
            PATH_ENV,
            canonicalize(format!("./tests/environments/{env}/translations/")).unwrap(),
        );
    }
}

#[test]
fn valid_environment() {
    unsafe {
        let t = TestCases::new();

        lock_env!();

        set_default_env();
        set_locales_env("everything_valid");

        t.pass("./tests/integration/language/pass*.rs");
        t.compile_fail("./tests/integration/language/fail*.rs");

        t.pass("./tests/integration/path/pass*.rs");
        t.compile_fail("./tests/integration/path/fail*.rs");

        t.pass("./tests/integration/templates/pass*.rs");
        t.compile_fail("./tests/integration/templates/fail*.rs");
    }
}

#[test]
fn invalid_tests_path() {
    unsafe {
        let t = TestCases::new();

        lock_env!();

        set_default_env();
        set_var(PATH_ENV, "something_invalid");

        // invalid path in configuration.
        t.compile_fail("./tests/integration/config/fail_config_path_missmatch.rs");
    }
}

#[test]
fn invalid_config_value() {
    unsafe {
        let t = TestCases::new();

        lock_env!();

        set_default_env();
        set_locales_env("everything_valid");
        set_var(OVERLAP_ENV, "49854835093459fjkdjfkj");

        // invalid enum value in configuration.
        t.compile_fail("./tests/integration/config/fail_config_invalid_enums.rs");
    }
}

#[test]
fn translations_malformed() {
    unsafe {
        let t = TestCases::new();

        lock_env!();

        set_default_env();
        set_locales_env("translations_malformed");

        // translation file rule broken.
        t.compile_fail("./tests/integration/config/fail_translations_malformed.rs");
    }
}