nbnf_language 0.0.2

A parser for the NBNF language itself, and the parser generator
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

//!
#![forbid(missing_docs)]

///
pub mod generator;
///
pub mod lexer;
///
pub mod parser;

use std::collections::HashSet;
use std::ops::RangeInclusive;

pub use crate::generator::{generate_parser, generate_parser_tokens};
pub use crate::lexer::{Token, lex};
pub use crate::parser::{Expr, Grammar, parse};

/// A literal character, string, or character range to be matched.
#[derive(Clone, Debug, PartialEq, Eq)]
pub enum Literal {
	/// A character.
	Char(char),
	/// A string.
	String(String),
	/// A range of characters.
	Range {
		/// Literal characters
		chars: HashSet<char>,
		/// Literal ranges
		ranges: HashSet<RangeInclusive<char>>,
		/// Whether to match any character except those in the range
		invert: bool,
	},
}

/// Shortcut to parse a grammar directly from a string.
pub fn parse_grammar(input: &str) -> anyhow::Result<Grammar> {
	let tokens = lexer::lex(input)?;
	parser::parse(tokens)
}