lift-ast 0.4.4

LIFT compiler framework AST: lexer, parser, and AST for the .lif source language
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

//! LIFT AST: Lexer, parser, and AST for the `.lif` source language.
//!
//! This crate provides tokenisation, parsing, and IR construction from
//! LIFT source files. Use [`Lexer`] to tokenise, [`Parser`] to parse,
//! and [`IrBuilder`] to lower the AST into the core IR.

pub mod ast;
pub mod builder;
pub mod lexer;
pub mod parser;
pub mod token;

pub use ast::*;
pub use builder::IrBuilder;
pub use lexer::Lexer;
pub use parser::Parser;
pub use token::{Token, TokenKind};

/// Convenience: parse a `.lif` source string into a Program AST.
pub fn parse_source(source: &str) -> Result<Program, Vec<parser::ParseError>> {
    let mut lexer = Lexer::new(source);
    let tokens = lexer.tokenize().to_vec();
    Parser::new(tokens).parse()
}

/// Convenience: lower a Program AST into a populated Context.
pub fn build_context(program: &Program) -> Result<lift_core::Context, String> {
    let mut ctx = lift_core::Context::new();
    let mut builder = IrBuilder::new();
    builder.build_program(&mut ctx, program)?;
    Ok(ctx)
}