Struct ParserGen 

pub struct ParserGen { /* private fields */ }

Implementations

impl ParserGen

pub fn build_from_rules<T>(rules: ProdRuleSet<T>, name: String) -> Self

where ProdRuleSet<LL1>: BuildFrom<ProdRuleSet<T>>,

Creates a ParserGen from a set of production rules and gives it a specific name, which is used to name the user listener trait in the generated code.

If rules already has a name, it is best to use the BuildFrom<ProdRuleSet<T>> trait.

pub fn set_options(&mut self, options: ParserGenOptions)

pub fn set_name(&mut self, name: String)

pub fn get_name(&self) -> &str

pub fn get_symbol_table(&self) -> Option<&SymbolTable>

pub fn get_parsing_table(&self) -> &LLParsingTable

pub fn set_terminal_hooks(&mut self, terminal_hooks: Vec<TokenId>)

pub fn add_header<T: Into<String>>(&mut self, header: T)

pub fn extend_headers<I: IntoIterator<Item = T>, T: Into<String>>( &mut self, headers: I, )

pub fn add_lib<T: Into<String>>(&mut self, lib: T)

pub fn extend_libs<I: IntoIterator<Item = T>, T: Into<String>>( &mut self, libs: I, )

pub fn add_nt_type<T: Into<String>>(&mut self, org_var: VarId, var_type: T)

Declares the type of a non-terminal. The index of the NT, org_var, is the original index in the ruletree set, which is the index originally assigned when parsing the grammar file.

pub fn get_nt_type(&self, v: VarId) -> &str

pub fn set_nt_value(&mut self, nt_value: NTValue)

Sets which nonterminals have a value, from nt_value.

pub fn set_nt_has_value(&mut self, v: VarId, has_value: bool)

pub fn set_gen_parser(&mut self, gen_parser: bool)

Generates the parser source code if gen_parser is true. This option is true by default.

pub fn set_gen_wrapper(&mut self, gen_wrapper: bool)

Generates the wrapper source code if gen_parser is true. This option is true by default.

pub fn set_indent(&mut self, indent: usize)

Sets the source code indentation. This option is 0 by default.

pub fn set_types_indent(&mut self, indent: usize)

Sets the source code indentation of the template for the user types. This option is 0 by default.

pub fn set_listener_indent(&mut self, indent: usize)

Sets the source code indentation of the template for the listener implementation. This option is 0 by default.

pub fn set_indents(&mut self, wrapper: usize, types: usize, listner: usize)

Sets the source code indentation for the wrapper, the template for the user types and the template for the listener implementation.

pub fn set_gen_span_params(&mut self, gen_span_params: bool)

Generates code to give the location of nonterminals and tokens as extra parameters of listener methods.

pub fn set_gen_token_enums(&mut self, gen_token_enums: bool)

Generates enums for the terminal and nonterminal values. They may be helpful in the optional listener trait methods like hook() and intercept_token() when they are used.

Example

#[derive(Clone, Copy, PartialEq, Debug)]
#[repr(u16)]
pub enum Term {
    #[doc = "','"]        Comma = 0,
    #[doc = "';'"]        SemiColon = 1,
}

#[derive(Clone, Copy, PartialEq, Debug)]
#[repr(u16)]
pub enum NTerm {
    #[doc = "`program`"]                   Program = 0,
    #[doc = "`stmt_i`, parent: `program`"] StmtI = 1,
}

pub fn get_nt_parent(&self, v: VarId) -> Option<VarId>

pub fn set_include_alts(&mut self, include_alts: bool)

Include the definitions of the alternatives in the parser, for debugging purposes: allows to print out the alternatives in VERBOSE mode.

pub fn use_full_lib(&mut self, use_full_lib: bool)

pub fn set_crate(&mut self, lcrate: LexigramCrate)

pub fn gen_source_code(&mut self) -> (String, String, String)

Generates the source code of the wrapper and the accompanying templates. Returns

• the indented source of the wrapper
• the indented source of the template for the user types
• the indented source of the template for the listener implementation

pub fn try_gen_source_code( self, ) -> Result<(BufLog, String, String, String), BuildError>

impl ParserGen

pub fn get_nt_tree(&self) -> VecTree<VarId>

pub fn get_indented_nt(&self) -> Vec<(VarId, String)>

pub fn nt_info_str(&self) -> Vec<String>

pub fn log_nt_info(&mut self)

pub fn alt_info_str(&self) -> Vec<String>

pub fn log_alt_info(&mut self)

pub fn print_items(&self, indent: usize, show_symbols: bool, show_span: bool)

pub fn print_flags(&self, indent: usize)

Trait Implementations

impl BuildFrom<ParserGen> for ParserTables

fn build_from(parser_gen: ParserGen) -> Self

Creates a ParserTables, from which a parser can be created dynamically with parser_table.make_parser().

impl<T> BuildFrom<ProdRuleSet<T>> for ParserGen

where ProdRuleSet<LL1>: BuildFrom<ProdRuleSet<T>>,

fn build_from(rules: ProdRuleSet<T>) -> Self

Creates a ParserGen from a set of production rules.

If the rule set has a name, it’s transmitted to the parser generator to name the user listener trait in the generated code. If the rule set has no name, a default “Parser” name is used instead (unless the name is set with ParserGen::set_name().

impl Debug for ParserGen

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl HasBuildErrorSource for ParserGen

const SOURCE: BuildErrorSource = BuildErrorSource::ParserGen

fn get_build_error_source() -> BuildErrorSource

impl LogReader for ParserGen

type Item = BufLog

fn get_log(&self) -> &Self::Item

fn give_log(self) -> Self::Item

impl TryBuildFrom<ParserGen> for ParserTables

type Error = BuildError

The type returned in the event of a conversion error.

fn try_build_from(source: ParserGen) -> Result<Self, Self::Error>

Performs the conversion.