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

// Copyright (c) 2017-2021 Fabian Schuiki

//! Facilities to emit a module as human-readable assembly, or to parse such
//! assembly back into a module.

use crate::{ir::Module, ty::Type, value::TimeValue};

#[allow(unused_parens)]
mod grammar;
mod reader;
mod writer;

/// Emit assembly for a module.
pub fn write_module(sink: impl std::io::Write, module: &Module) {
    writer::Writer::new(sink).write_module(module).unwrap();
}

/// Emit assembly for a module as string.
pub fn write_module_string(module: &Module) -> String {
    let mut asm = vec![];
    write_module(&mut asm, &module);
    String::from_utf8(asm).expect("writer should emit proper utf8")
}

/// Parse a type.
///
/// Parses the `input` string into a type.
pub fn parse_type(input: impl AsRef<str>) -> Result<Type, String> {
    reader::TypeParser::new()
        .parse(input.as_ref())
        .map_err(|e| format!("{}", e))
}

/// Parse a time.
///
/// Parses the `input` string into a time constant.
pub fn parse_time(input: impl AsRef<str>) -> Result<TimeValue, String> {
    reader::TimeValueParser::new()
        .parse(input.as_ref())
        .map_err(|e| format!("{}", e))
}

/// Parse a module.
///
/// Parses the `input` string into a module.
pub fn parse_module(input: impl AsRef<str>) -> Result<Module, String> {
    parse_module_unchecked(input).map(|mut module| {
        module.link();
        module.verify();
        module
    })
}

/// Parse a module without linking and verifying it.
pub fn parse_module_unchecked(input: impl AsRef<str>) -> Result<Module, String> {
    reader::ModuleParser::new()
        .parse(input.as_ref())
        .map(|m| {
            debug!("Parsed module:\n{}", m.dump());
            m
        })
        .map_err(|e| format!("{}", e))
}