polib 0.3.0

Read, manipulate and store translation data in GNU gettext PO format.
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

use crate::message::{Message, MessageFlags};

/// A helper type to build a `Message` conveniently via method chaining.
#[derive(Clone, Debug, Eq, PartialEq)]
pub struct MessageBuilder {
    m: Message,
}

impl Message {
    /// Build a new singular message.
    pub fn build_singular() -> MessageBuilder {
        MessageBuilder {
            m: Message {
                is_plural: false,
                ..Message::default()
            },
        }
    }

    /// Build a new plural message.
    pub fn build_plural() -> MessageBuilder {
        MessageBuilder {
            m: Message {
                is_plural: true,
                ..Message::default()
            },
        }
    }
}

impl MessageBuilder {
    /// Set the translator comments field.
    pub fn with_translator_comments(&mut self, comments: String) -> &mut Self {
        self.m.translator_comments = comments;
        self
    }

    /// Set the extracted comments field.
    pub fn with_extracted_comments(&mut self, comments: String) -> &mut Self {
        self.m.extracted_comments = comments;
        self
    }

    /// Set the source field.
    pub fn with_source(&mut self, source: String) -> &mut Self {
        self.m.source = source;
        self
    }

    /// Set the flags field.
    pub fn with_flags(&mut self, flags: MessageFlags) -> &mut Self {
        self.m.flags = flags;
        self
    }

    /// Set the msgctxt field.
    pub fn with_msgctxt(&mut self, msgctxt: String) -> &mut Self {
        self.m.msgctxt = msgctxt;
        self
    }

    /// Set the msgid field.
    pub fn with_msgid(&mut self, msgid: String) -> &mut Self {
        self.m.msgid = msgid;
        self
    }

    /// Set the msgid_plural field.
    pub fn with_msgid_plural(&mut self, msgid_plural: String) -> &mut Self {
        self.m.msgid_plural = msgid_plural;
        self
    }

    /// Set the msgstr field.
    pub fn with_msgstr(&mut self, msgstr: String) -> &mut Self {
        self.m.msgstr = msgstr;
        self
    }

    /// Set the msgstr_plural field.
    pub fn with_msgstr_plural(&mut self, msgstr_plural: Vec<String>) -> &mut Self {
        self.m.msgstr_plural = msgstr_plural;
        self
    }

    /// Finish building and get the resulting `Message` object.
    /// This builder object should be discarded and not be re-used afterwards.
    pub fn done(&mut self) -> Message {
        std::mem::take(&mut self.m)
    }
}