slicec 0.4.0

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

// Copyright (c) ZeroC, Inc.

mod annotated_diagnostic;
mod diagnostic;
mod errors;
mod lints;

pub use annotated_diagnostic::*;
pub use diagnostic::{Diagnostic, Diagnostics};
pub use errors::Error;
pub use lints::Lint;

use crate::slice_file::Span;

/// Wrapper enum for the 3 possible kinds of diagnostics.
#[derive(Debug)]
pub enum DiagnosticKind {
    /// An irrecoverable error; the compiler will terminate early at the end of the next phase.
    Error(Error),

    /// A minor and recoverable mistake; has no effect on the compiler's execution pipeline.
    Lint(Lint),

    /// A purely informational comment; has no effect on the compiler's execution pipeline.
    Info(String),
}

/// Diagnostic levels describe the severity of a diagnostic, and how the compiler should react to their emission.
#[derive(Clone, Copy, Debug, Hash, Eq, PartialEq, Ord, PartialOrd)]
pub enum DiagnosticLevel {
    #[rustfmt::skip] // See https://github.com/rust-lang/rustfmt/issues/5801
    /// Diagnostics with the `Error` level will be emitted and will cause compilation to fail with a non-zero exit code.
    Error,

    /// Diagnostics with the `Warning` level will be emitted, but will not influence the exit code of the compiler.
    Warning,

    /// Diagnostics with the `Allowed` level will be suppressed and will not emit any message.
    Allowed,

    /// Diagnostics with the `Info` level will be emitted, but will not influence the exit code of the compiler.
    Info,
}

/// Stores additional information about a diagnostic.
#[derive(Clone, Debug)]
pub struct Note {
    pub message: String,
    pub span: Option<Span>,
}