uxn-tal 0.6.1

uxntal:// protocol | a Rust library for assembling TAL (Tal Assembly Language) files into UXN ROM files
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

use std::fmt;
impl fmt::Display for LabelReferenceErrorData {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "Label reference error at {}:{}:{} for label '{}'\nToken: {:?}\nSource: {}",
            self.path, self.line, self.position, self.label, self.token, self.source_line
        )
    }
}

use thiserror::Error;

/// Errors that can occur during TAL assembly
#[derive(Error, Debug)]
pub struct LabelReferenceErrorData {
    pub path: String,
    pub line: usize,
    pub position: usize,
    pub label: String,
    pub token: crate::lexer::TokenWithPos,
    pub source_line: String,
}

#[derive(Error, Debug)]
pub enum AssemblerError {
    #[error("Label reference error at {0:?}")]
    LabelReferenceError(Box<LabelReferenceErrorData>),
    #[error("Expected identifier at {path}:{line}:{position} after token: {after_token} (found '{found}')\nSource: {source_line}")]
    ExpectedIdentifierError {
        path: String,
        line: usize,
        position: usize,
        after_token: String,
        found: char,
        source_line: String,
    },
    #[error("File read error at {path}: {message}")]
    FileReadError { path: String, message: String },
    #[error("Syntax error at {path}:{line}:{position} {message}\nSource: {source_line}")]
    SyntaxError {
        path: String,
        line: usize,
        position: usize,
        message: String,
        source_line: String,
    },

    #[error("Unknown opcode: {opcode}")]
    UnknownOpcode { opcode: String },

    #[error("Invalid number format: {value}")]
    InvalidNumber { value: String },

    #[error("UTF-8 error at {path}:{line}:{position} {message}\nSource: {source_line}")]
    Utf8Error {
        path: String,
        line: usize,
        position: usize,
        message: String,
        source_line: String,
    },

    #[error("Undefined label: {label}")]
    UndefinedLabel { label: String },

    #[error("Label already defined: {label}")]
    DuplicateLabel { label: String },

    #[error("Invalid addressing mode")]
    InvalidAddressing,

    #[error("ROM too large: {size} bytes (maximum 65536)")]
    RomTooLarge { size: usize },

    #[error("Invalid padding address: {address:04x}")]
    InvalidPadding { address: u16 },

    #[error("IO error: {0}")]
    Io(#[from] std::io::Error),

    #[error("Internal error: {message}")]
    Internal { message: String },

    #[error("Backend error: {message}")]
    Backend { message: String },

    #[error("Disassembly error: {message}")]
    Disassembly { message: String },
}

/// Result type for assembler operations
pub type Result<T> = std::result::Result<T, AssemblerError>;