maomi 0.5.0

Strict and Performant Web Application Programming
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
104
105
106
107
108
109
110
111
112
113

//! The translated string types, used in i18n.

use std::{fmt::Display, ops::Deref};

/// Marker for a type that is i18n friendly.
///
/// When i18n support is enabled,
/// only types which implemented this trait can be used in text node.
pub trait ToLocaleStr {
    /// Get the translated text.
    fn to_locale_str(&self) -> &str;

    /// Get the owned string of the translated text.
    fn to_locale_string(&self) -> LocaleString {
        LocaleString::translated(self.to_locale_str())
    }
}

/// A translated static str.
#[derive(Debug, Clone, Copy, Default, PartialEq, Eq, Hash)]
pub struct LocaleStaticStr(&'static str);

impl LocaleStaticStr {
    /// Wraps a translated str.
    ///
    /// Make sure the string is translated!
    pub const fn translated(s: &'static str) -> Self {
        Self(s)
    }
}

impl ToLocaleStr for LocaleStaticStr {
    fn to_locale_str(&self) -> &str {
        self.0
    }
}

impl Display for LocaleStaticStr {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.0.fmt(f)
    }
}

impl Deref for LocaleStaticStr {
    type Target = str;

    fn deref(&self) -> &Self::Target {
        self.0
    }
}

impl AsRef<str> for LocaleStaticStr {
    fn as_ref(&self) -> &str {
        self.0
    }
}

impl<'a> Into<&'a str> for &'a LocaleStaticStr {
    fn into(self) -> &'a str {
        self.0
    }
}

/// A translated string.
#[derive(Debug, Clone, Default, PartialEq, Eq, Hash)]
pub struct LocaleString(String);

impl LocaleString {
    /// Wraps a translated string.
    ///
    /// Make sure the string is translated!
    pub fn translated(s: impl ToString) -> Self {
        Self(s.to_string())
    }
}

impl ToLocaleStr for LocaleString {
    fn to_locale_str(&self) -> &str {
        self.0.as_str()
    }
}

impl<T: ?Sized + ToLocaleStr> ToLocaleStr for &T {
    fn to_locale_str(&self) -> &str {
        (*self).to_locale_str()
    }
}

impl Display for LocaleString {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        self.0.fmt(f)
    }
}

impl Deref for LocaleString {
    type Target = str;

    fn deref(&self) -> &Self::Target {
        self.0.as_str()
    }
}

impl AsRef<str> for LocaleString {
    fn as_ref(&self) -> &str {
        self.0.as_str()
    }
}

impl<'a> Into<&'a str> for &'a LocaleString {
    fn into(self) -> &'a str {
        self.0.as_str()
    }
}