fluent4rs 2.3.1

Parser / codec for [Fluent FTL files](https://github.com/projectfluent/fluent/blob/master/spec/fluent.ebnf), written for [lingora](https://github.com/nigeleke/lingora) (a localization management program), and may be found to be useful outside of that context. It is not intended to replace any aspects of the [fluent-rs](https://github.com/projectfluent/fluent-rs) crate implemented by [Project Fluent](https://projectfluent.org/), and, for the majority of language translation needs, the reader is referred back to that crate.
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

#[cfg(feature = "serde")]
use serde::{Deserialize, Serialize};

use super::{CommentLine, Message, Term};
#[cfg(feature = "walker")]
use crate::walker::{Visitor, Walkable, Walker};

/// [Entry](crate::ast::Entry) ::= ([Message](crate::ast::Message) line_end)
///  | ([Term](crate::ast::Term) line_end)
///  | [CommentLine](crate::ast::CommentLine)
///
/// Entries are the main building blocks of Fluent.
///
/// They define translations and contextual and semantic information about the
/// translations. During the AST construction, adjacent comment lines of the same
/// comment type (defined by the number of #) are joined together. Single-# comments
/// directly preceding [Message](crate::ast::Message)s and [Term](crate::ast::Term)s
/// are attached to the [Message](crate::ast::Message) or [Term](crate::ast::Term)
/// and are not standalone Entries.
#[derive(Clone, Debug, PartialEq)]
#[cfg_attr(feature = "hash", derive(Eq, PartialOrd, Ord, Hash))]
#[cfg_attr(feature = "serde", derive(Deserialize, Serialize))]
pub enum Entry {
    #[doc(hidden)]
    Message(Message),

    #[doc(hidden)]
    Term(Term),

    #[doc(hidden)]
    CommentLine(CommentLine),
}

#[cfg(feature = "walker")]
impl Walkable for Entry {
    fn walk(&self, visitor: &mut dyn Visitor) {
        visitor.visit_entry(self);
        match self {
            Self::Message(message) => Walker::walk(message, visitor),
            Self::Term(term) => Walker::walk(term, visitor),
            Self::CommentLine(comment) => Walker::walk(comment, visitor),
        }
    }
}

impl std::fmt::Display for Entry {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        let value = match self {
            Self::Message(message) => message.to_string(),
            Self::Term(term) => term.to_string(),
            Self::CommentLine(line) => line.to_string(),
        };
        write!(f, "{value}")
    }
}