crain 0.1.0

A Brainfuck compiler/interpreter/tool
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

//! Error types for the Crain Brainfuck interpreter and VM.
//!
//! This module defines error enums for parsing, virtual machine execution, and interpretation
//! in the Brainfuck toolchain. All errors implement the `std::error::Error` trait via `thiserror`.

use thiserror::Error;

/// Errors that may occur when parsing Brainfuck code.
#[derive(Error, Debug)]
pub enum ParseError {
    /// IO error occurred during parsing.
    #[error("IO error: {source}")]
    IO {
        #[from]
        source: std::io::Error,
    },

    /// Mismatched bracket found in the code.
    #[error("Mismatched bracket: '{bracket}' at {line}:{row}")]
    MismatchedBracket {
        bracket: char,
        line: usize,
        row: usize,
    },
}

/// Errors that may occur during Brainfuck VM execution.
#[derive(Error, Debug)]
pub enum VmError {
    /// IO error occurred during VM execution.
    #[error("IO error: {source}")]
    IO {
        #[from]
        source: std::io::Error,
    },

    /// The pointer moved out of the valid range.
    #[error("Pointer Overflow: {info}")]
    PointerOverflow { info: String },
    // It maybe used in the future.
    //  #[error("Cell Overflow: {info}")]
    //  CellOverflow { info: String },
}

/// Errors that may occur during interpretation, including parsing and VM errors.
#[derive(Error, Debug)]
pub enum InterpError {
    /// Error occurred during parsing.
    #[error("{source}")]
    Parse {
        #[from]
        source: ParseError,
    },

    /// Error occurred during VM execution.
    #[error("{source}")]
    Vm {
        #[from]
        source: VmError,
    },

    /// IO error occurred during interpretation.
    #[error("IO error: {source}")]
    IO {
        #[from]
        source: std::io::Error,
    },
}