meta-language 0.47.0

A self-describing links-network core for lossless language representation
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

//! Importers for external grammar definition formats.

use std::error::Error;
use std::fmt;

use crate::grammar::GrammarFormat;

mod abnf;
mod antlr;
mod bnf;
mod ebnf;
mod gbnf;
mod lark;
mod pest;
mod tree_sitter_json;

pub use abnf::import_abnf;
pub use antlr::import_antlr;
pub use bnf::import_bnf;
pub use ebnf::import_ebnf;
pub use gbnf::import_gbnf;
pub use lark::import_lark;
pub use pest::import_pest;
pub use tree_sitter_json::import_tree_sitter_json;

/// Error raised while importing an external grammar notation.
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum GrammarImportError {
    /// The source text could not be parsed or validated as the requested format.
    Parse {
        /// Grammar format being imported.
        format: GrammarFormat,
        /// Human-readable error message.
        message: String,
    },
    /// The importer parsed the input but cannot lower this construct yet.
    Unsupported {
        /// Grammar format being imported.
        format: GrammarFormat,
        /// Construct name or summary.
        construct: String,
    },
}

impl fmt::Display for GrammarImportError {
    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            Self::Parse { format, message } => {
                write!(formatter, "{format} import parse error: {message}")
            }
            Self::Unsupported { format, construct } => {
                write!(
                    formatter,
                    "{format} import unsupported construct: {construct}"
                )
            }
        }
    }
}

impl Error for GrammarImportError {}

pub(super) fn parse_error(format: GrammarFormat, message: impl Into<String>) -> GrammarImportError {
    GrammarImportError::Parse {
        format,
        message: message.into(),
    }
}

pub(super) fn unsupported_error(
    format: GrammarFormat,
    construct: impl Into<String>,
) -> GrammarImportError {
    GrammarImportError::Unsupported {
        format,
        construct: construct.into(),
    }
}