diml 0.2.0

DIML parser
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
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

//! # Errors implementation

use std::error::Error;
use std::fmt::Display;

/// Result type for [`DimlError`].
pub type Result<T, E = DimlError> = std::result::Result<T, E>;

/// Error definitions.
#[derive(Debug, Clone, PartialEq, Eq)]
#[non_exhaustive]
pub enum DimlError {
    /// Reports an empty input.
    EmptyInput(
        /// Line number.
        usize,
        /// Column number.
        usize,
    ),
    /// Reports an unexpected character.
    UnexpectedCharacter(
        /// Encountered character.
        char,
        /// Line number.
        usize,
        /// Column number.
        usize,
    ),
    /// Reports a missing newline.
    MissingNewline(
        /// Line number.
        usize,
        /// Column number.
        usize,
    ),
    /// Reports invalid indentation.
    InvalidIndentation(
        /// Length of the invalid indent.
        usize,
        /// Expected indentation multiplier.
        usize,
        /// Line number.
        usize,
        /// Column number.
        usize,
    ),
    /// Reports skipped indentation level.
    SkippedIndentation(
        /// Previous indentation level.
        usize,
        /// Current (invalid) indentation level.
        usize,
        /// Line number.
        usize,
        /// Column number.
        usize,
    ),
}

impl Display for DimlError {
    /// Implements [Display] trait for [`DimlError`].
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::EmptyInput(line, column) => {
                write!(f, "empty input at line {line}, column {column}")
            }
            Self::UnexpectedCharacter(ch, line, column) => {
                write!(
                    f,
                    "unexpected character '{}' at line {line}, column {column}",
                    ch.escape_debug()
                )
            }
            Self::MissingNewline(line, column) => {
                write!(f, "missing newline at line {line}, column {column}")
            }
            Self::InvalidIndentation(indent, multiplier, line, column) => {
                write!(
                    f,
                    "invalid indentation {indent}, expected a multiple of {multiplier} spaces at line {line}, column {column}"
                )
            }
            Self::SkippedIndentation(previous, level, line, column) => {
                write!(
                    f,
                    "skipped indentation level, jump from level {previous} to level {level} at line {line}, column {column}"
                )
            }
        }
    }
}

/// Implements [Error] trait for [`DimlError`].
impl Error for DimlError {}