text_components 0.1.6

A Rust implementation of Minecraft's Text Components
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

use crate::TextComponent;
use std::borrow::Cow;

#[derive(Debug, Clone, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(::serde::Serialize, ::serde::Deserialize))]
pub struct TranslatedMessage {
    #[cfg_attr(feature = "serde", serde(rename = "translate"))]
    pub key: Cow<'static, str>,
    #[cfg_attr(
        feature = "serde",
        serde(skip_serializing_if = "Option::is_none", default)
    )]
    pub fallback: Option<Cow<'static, str>>,
    #[cfg_attr(
        feature = "serde",
        serde(skip_serializing_if = "Option::is_none", rename = "with", default)
    )]
    pub args: Option<Box<[TextComponent]>>,
}
impl TranslatedMessage {
    /// Creates a new `TranslatedMessage` without fallback.
    /// ### Warning
    /// Using this method directly is discouraged.
    /// Please use a compiled [Translation] instead.
    pub const fn new(key: &'static str, args: Option<Box<[TextComponent]>>) -> Self {
        Self {
            key: Cow::Borrowed(key),
            args,
            fallback: None,
        }
    }

    #[inline]
    pub fn component(self) -> TextComponent {
        TextComponent::translated(self)
    }
    #[inline]
    pub fn component_fallback<F: Into<Cow<'static, str>>>(mut self, fallback: F) -> TextComponent {
        self.fallback = Some(fallback.into());
        TextComponent::translated(self)
    }
}

impl From<TranslatedMessage> for TextComponent {
    fn from(value: TranslatedMessage) -> Self {
        value.component()
    }
}

pub struct Translation<const ARGS: usize>(pub &'static str);

impl Translation<0> {
    /// Creates a new `TranslatedMessage` with no arguments.
    #[must_use]
    pub const fn msg(&self) -> TranslatedMessage {
        TranslatedMessage::new(self.0, None)
    }
}

impl<const ARGS: usize> Translation<ARGS> {
    /// Creates a new `TranslatedMessage` with the given arguments.
    #[must_use]
    pub fn message(&self, args: [impl Into<TextComponent>; ARGS]) -> TranslatedMessage {
        TranslatedMessage::new(self.0, Some(Box::new(args.map(Into::into))))
    }
}

impl From<&Translation<0>> for TextComponent {
    fn from(value: &Translation<0>) -> Self {
        value.msg().component()
    }
}