doge-compiler 0.3.0

Compiler for the Doge programming language — lexer, parser, semantic checks, and Rust codegen.
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

#![allow(clippy::result_large_err)]

mod ast;
mod builtins;
mod check;
mod codegen;
mod complete;
mod diagnostics;
mod fmt;
mod keywords;
mod lexer;
mod manifest;
mod modules;
mod parser;
mod project;
mod stdlib;
mod token;

pub use ast::{
    celled_locals, child_funcdefs, dump, free_names, hoisted_names, BinOp, Expr, InterpPart, Param,
    Params, Script, Stmt, UnOp,
};
pub use builtins::{builtin, is_builtin, BuiltinFn, BuiltinShape, BUILTINS};
pub use check::{check_snippet, ClassInfo, SessionScope};
pub use complete::{complete, Completion, CompletionKind};
pub use diagnostics::Diagnostic;
pub use manifest::{Dependency, DependencySource, GitRev, Manifest, MANIFEST_NAME};
pub use modules::{
    load_program, load_program_with_deps, single_file_program, Program, ProgramFile,
};
pub use parser::{parse_repl, ReplParse};
pub use project::{discover_root, read_manifest, resolve_project, DependencyMap};
pub use stdlib::{module as stdlib_module, Module, ModuleFn, MODULES, PACK_ZOOM_RUNTIME_FN};
pub use token::Span;

/// Lex and parse `source` (named `path` for diagnostics) into a [`Script`]
pub fn parse(path: &str, source: &str) -> Result<Script, Diagnostic> {
    parser::parse(path, source)
}

/// Run the semantic checks over an already-parsed [`Script`].
pub fn check(path: &str, source: &str, script: &Script) -> Result<(), Diagnostic> {
    check::check(path, source, script)
}

/// Format `source` (named `path` for diagnostics) to canonical Doge style, or a
/// diagnostic if it does not parse. Comments are preserved; the token stream is
/// never changed.
pub fn format(path: &str, source: &str) -> Result<String, Diagnostic> {
    fmt::format(path, source)
}

/// Generate a complete Rust source file from a checked [`Script`], or a
/// diagnostic for a construct it cannot compile (a class used as a value).
pub fn generate(path: &str, source: &str, script: &Script) -> Result<String, Diagnostic> {
    let program = modules::single_file_program(path, source, script.clone())?;
    codegen::generate_program(&program)
}

/// Load the entry script and every `.doge` module it transitively imports.
pub fn load(entry_path: &str, entry_source: &str) -> Result<Program, Diagnostic> {
    modules::load_program(entry_path, entry_source)
}

/// Run the semantic checks over every file in a loaded [`Program`].
pub fn check_program(program: &Program) -> Result<(), Diagnostic> {
    check::check_program(program)
}

/// Generate one Rust source file wiring together every file in a [`Program`].
pub fn generate_program(program: &Program) -> Result<String, Diagnostic> {
    codegen::generate_program(program)
}