delbin 0.1.0

Descriptive Language for Binary Object
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
95
96
97
98
99
100
101
102
103

//! Delbin error type definitions

use thiserror::Error;

/// Error codes
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ErrorCode {
    // Parse errors (01)
    E01001, // UnexpectedToken
    E01002, // UnexpectedEOF
    E01003, // InvalidSyntax
    E01004, // InvalidNumber
    E01005, // InvalidString

    // Semantic errors (02)
    E02001, // UndefinedVariable
    E02002, // UndefinedField
    E02003, // UndefinedSection
    E02004, // UndefinedFunction

    // Type errors (03)
    E03001, // TypeMismatch
    E03002, // ArraySizeMismatch
    E03003, // IntegerOverflow
    E03004, // InvalidArraySize
    E03005, // StringTooLong

    // Evaluation errors (04)
    E04001, // DivisionByZero
    E04002, // InvalidRange
    E04003, // InvalidArgument
    E04004, // ArgumentCountMismatch
    E04005, // ComputationFailed
    E04006, // ShiftOverflow

    // IO errors (05)
    E05001, // FileNotFound
    E05002, // FileReadError
    E05003, // FileWriteError
}

impl std::fmt::Display for ErrorCode {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{:?}", self)
    }
}

/// Source code location
#[derive(Debug, Clone, Default)]
pub struct SourceLocation {
    pub line: usize,
    pub column: usize,
    pub context: String,
}

/// Delbin error
#[derive(Debug, Error)]
#[error("[{code}] {message}")]
pub struct DelbinError {
    pub code: ErrorCode,
    pub message: String,
    pub location: Option<SourceLocation>,
    pub hint: Option<String>,
}

impl DelbinError {
    pub fn new(code: ErrorCode, message: impl Into<String>) -> Self {
        Self {
            code,
            message: message.into(),
            location: None,
            hint: None,
        }
    }

    pub fn with_location(mut self, location: SourceLocation) -> Self {
        self.location = Some(location);
        self
    }

    pub fn with_hint(mut self, hint: impl Into<String>) -> Self {
        self.hint = Some(hint.into());
        self
    }
}

/// Delbin warning
#[derive(Debug, Clone)]
pub struct DelbinWarning {
    pub code: WarningCode,
    pub message: String,
    pub location: Option<SourceLocation>,
}

/// Warning codes
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum WarningCode {
    W03001, // StringTruncated
    W03002, // ValueTruncated
    W04001, // ShiftOverflow (shift amount >= operand bit-width)
}

pub type Result<T> = std::result::Result<T, DelbinError>;