zuzu-rust 0.6.0

Rust implementation of ZuzuScript
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
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

pub mod ast;
pub mod codegen;
pub mod error;
pub mod infer;
pub mod lexer;
pub mod optimizer;
pub mod parser;
pub mod runtime;
pub mod sema;
pub mod span;
pub mod token;
pub mod web;

pub use ast::{Expression, Program};
pub use error::{Result, ZuzuRustError};
pub use optimizer::{OptimizationLevel, OptimizationOptions, OptimizationPass};
pub use runtime::{
    module_search_roots, ExecutionOutput, HostValue, LoadedScript, Runtime, RuntimePolicy,
};

#[derive(Debug, Clone, PartialEq, Eq)]
pub struct ParseOptions {
    pub run_sema: bool,
    pub infer_types: bool,
    pub optimizations: OptimizationOptions,
}

impl Default for ParseOptions {
    fn default() -> Self {
        Self {
            run_sema: true,
            infer_types: true,
            optimizations: OptimizationOptions::default(),
        }
    }
}

impl ParseOptions {
    pub fn new(run_sema: bool, infer_types: bool, optimizations: OptimizationOptions) -> Self {
        Self {
            run_sema,
            infer_types,
            optimizations,
        }
    }
}

pub fn parse_program(source: &str) -> Result<Program> {
    parse_program_with_options(source, true, true)
}

pub fn parse_program_with_options(
    source: &str,
    run_sema: bool,
    infer_types: bool,
) -> Result<Program> {
    parse_program_with_compile_options(
        source,
        &ParseOptions::new(run_sema, infer_types, OptimizationOptions::disabled()),
    )
}

pub fn parse_program_with_options_and_source_file(
    source: &str,
    run_sema: bool,
    infer_types: bool,
    source_file: Option<&str>,
) -> Result<Program> {
    parse_program_with_compile_options_and_source_file(
        source,
        &ParseOptions::new(run_sema, infer_types, OptimizationOptions::disabled()),
        source_file,
    )
}

pub fn parse_program_with_compile_options(source: &str, options: &ParseOptions) -> Result<Program> {
    parse_program_with_compile_options_and_source_file(source, options, None)
}

pub fn parse_program_with_compile_options_and_source_file(
    source: &str,
    options: &ParseOptions,
    source_file: Option<&str>,
) -> Result<Program> {
    let tokens = lexer::lex(source).map_err(|err| err.with_source_file(source_file))?;
    let mut parser = match source_file {
        Some(source_file) => parser::Parser::with_source_file(tokens, source_file),
        None => parser::Parser::new(tokens),
    };
    let mut program = parser
        .parse_program()
        .map_err(|err| err.with_source_file(source_file))?;
    if options.run_sema {
        sema::validate_program(&program).map_err(|err| err.with_source_file(source_file))?;
    }
    if options.infer_types {
        infer::annotate_program(&mut program);
    }
    optimizer::optimize_program(&mut program, &options.optimizations);
    Ok(program)
}

pub fn parse_expression(source: &str) -> Result<Expression> {
    parse_expression_with_source_file(source, None)
}

pub fn parse_expression_with_source_file(
    source: &str,
    source_file: Option<&str>,
) -> Result<Expression> {
    let tokens = lexer::lex(source).map_err(|err| err.with_source_file(source_file))?;
    match source_file {
        Some(source_file) => parser::Parser::with_source_file(tokens, source_file),
        None => parser::Parser::new(tokens),
    }
    .parse_expression_root()
    .map_err(|err| err.with_source_file(source_file))
}