slicec 0.3.3

The Slice parser and other core components for Slice compilers.
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

// Copyright (c) ZeroC, Inc.

//! TODO write a comment about how parsing works in Slice.

// We only export the parsers and keep all the other logic private.
pub use self::comments::parser::CommentParser;
pub use self::preprocessor::parser::Preprocessor;
pub use self::slice::parser::Parser;

mod comments;
mod common;
mod preprocessor;
mod slice;

use crate::ast::Ast;
use crate::compilation_state::CompilationState;
use crate::diagnostics::{Diagnostic, Diagnostics, Error};
use crate::slice_file::SliceFile;
use std::collections::HashSet;

pub fn parse_files(state: &mut CompilationState, symbols: &HashSet<String>) {
    for file in &mut state.files {
        // Attempt to parse the file.
        let mut diagnostics = Diagnostics::new();
        parse_file(file, &mut state.ast, &mut diagnostics, symbols.clone());

        // Store any diagnostics that were emitted during parsing.
        state.diagnostics.extend(diagnostics);
    }
}

fn parse_file(file: &mut SliceFile, ast: &mut Ast, diagnostics: &mut Diagnostics, mut symbols: HashSet<String>) {
    // Pre-process the file's raw text.
    let preprocessor = Preprocessor::new(&file.relative_path, &mut symbols, diagnostics);
    let Ok(preprocessed_text) = preprocessor.parse_slice_file(file.raw_text.as_str()) else { return };

    // Parse the preprocessed text.
    let parser = Parser::new(&file.relative_path, ast, diagnostics);
    let Ok((mode, attributes, module, definitions)) = parser.parse_slice_file(preprocessed_text) else { return };

    // Issue a syntax error if the user had definitions but forgot to declare a module.
    if !definitions.is_empty() && module.is_none() {
        Diagnostic::new(Error::Syntax {
            // TODO improve this message, see: #348
            message: "module declaration is required".to_owned(),
        })
        .push_into(diagnostics);
    }

    // Store the parsed data in the `SliceFile` it was parsed from.
    file.mode = mode;
    file.module = module.map(|m| ast.add_named_element(m));
    file.attributes = attributes;
    file.contents = definitions;
}