dinoco_compiler 1.2.4

The Dinoco schema compiler for parsing, validating, and analyzing database schemas.
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

mod ast;
mod error;
mod parser;
mod resolver;

use std::path::Path;

pub use ast::*;
pub use error::*;

pub type CompileResult<T> = Result<T, CompileError>;

/// Parses a schema without running semantic validation.
///
/// Editors can use this to report every semantic issue in a syntactically valid
/// document instead of stopping at the compiler's first validation error.
pub fn parse(source: &str) -> CompileResult<Schema> {
    parser::parse_schema(source)
}

pub fn compile(source: &str) -> CompileResult<Schema> {
    let schema = parse(source)?;
    if let Some(import) = schema.imports().next() {
        return Err(CompileError::at(
            "Imports require file-based compilation starting from `schema.dinoco`",
            &import.origin,
        ));
    }
    if let Some(import) = schema.config_imports().next() {
        return Err(CompileError::at(
            "`config.imports` requires file-based compilation starting from `schema.dinoco`",
            &import.origin,
        ));
    }
    parser::validate_schema(&schema)?;
    Ok(schema)
}

/// Compiles `schema.dinoco` and its complete import tree.
pub fn compile_file(path: impl AsRef<Path>) -> CompileResult<Schema> {
    resolver::compile_file(path.as_ref())
}