fea-rs 0.22.0

Tools for working with Adobe OpenType Feature files.
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

//! the result of a parsing operation

use std::sync::Arc;

use super::source::Source;
use super::{FileId, SourceList, SourceMap};
use crate::{Diagnostic, Node, token_tree::typed};

/// A fully parsed feature file, with attached imports and a sourcemap.
///
/// As well as representing the entire AST, this type also allows mapping tokens
/// and other spans back to a position in a particular source file.
///
/// This is cheap to clone, so it can be attached to diagnostics, allowing them
/// to print themselves where needed.
#[derive(Clone, Debug, PartialEq)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
pub struct ParseTree {
    pub(crate) root: Node,
    // Arc so we can send across threads
    pub(crate) sources: Arc<SourceList>,
    pub(crate) map: Arc<SourceMap>,
}

impl ParseTree {
    /// The root node for this parse tree
    pub fn root(&self) -> &Node {
        &self.root
    }

    /// The root node, as typed AST node
    pub fn typed_root(&self) -> typed::Root {
        typed::Root::try_from_node(&self.root).expect("parse tree has invalid root node type")
    }

    /// Return a refernce to the source map
    pub fn source_map(&self) -> &SourceMap {
        &self.map
    }

    /// Return the source for this id, if it exists in the source map
    pub fn get_source(&self, id: FileId) -> Option<&Source> {
        self.sources.get(&id)
    }

    /// Generate a string suitable for presenting a [`Diagnostic`] to the user.
    ///
    /// This associates the message with the appropriate source location and
    /// syntax highlighting.
    pub fn format_diagnostic(&self, err: &Diagnostic, colorize: bool) -> String {
        self.sources.format_diagnostic(err, colorize)
    }
}