trees-lang 0.2.5

Official impl of Trees (programming-language), supporting only parsing code now
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

use std::{error::Error, fmt};

use super::{ArgPlug, CompilingBlock, EdgeFragment};

#[derive(Debug, PartialEq, Eq)]
/// Errors that can occur during the compilation process.
pub enum CompileError {
  /// Error indicating that there are multiple blocks or no blocks without a block-plug.
  NonUniqueStartBlock(Box<NonUniqueStartBlockError>),
  /// Error indicating that an argument plug is not connected to any block.
  DanglingArgEdge(Box<DanglingArgEdgeError>),
}

#[derive(Debug, PartialEq, Eq)]
/// Represents an error where there are multiple or no blocks without a block-plug.
pub struct NonUniqueStartBlockError {
  /// A list of candidate blocks (i.e., blocks without a block-plug).
  pub candinates: Vec<CompilingBlock>,
}

#[derive(Debug, PartialEq, Eq)]
/// Represents an error where an argument plug is not connected to any block.
pub struct DanglingArgEdgeError {
  /// The block associated with the argument plug that is dangling.
  pub block_of_arg_plug: CompilingBlock,
  /// The argument plug that is dangling and not connected to any block.
  pub arg_plug: ArgPlug,
  /// A list of edge fragments associated with the dangling argument plug.
  pub edge_fragments: Vec<EdgeFragment>,
  /// The position (x, y) of the dangling edge's endpoint.
  ///
  /// This position is expected to be connected to a block.
  pub dangling_position: (usize, usize),
}

impl fmt::Display for CompileError {
  fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
    match self {
      CompileError::NonUniqueStartBlock(err) => write!(
        f,
        "The code must have exact one block which has no block-plug. Found: {}",
        err.candinates.len() // Accessing through Box
      ),
      CompileError::DanglingArgEdge(err) => write!(
        f,
        "The arg-plug on ({}, {}) has an arg-plug which is not connected to any block. Expected position: ({}, {})",
        err.arg_plug.x,
        err.arg_plug.y,
        err.dangling_position.0,
        err.dangling_position.1 // Accessing through Box
      ),
    }
  }
}

impl Error for CompileError {
  fn source(&self) -> Option<&(dyn Error + 'static)> {
    None
  }
}