droll 0.1.0

Dice notation parser and interpeter library
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

#[derive(Debug, Copy, Clone, PartialEq)]
/// Represents the operators in the parse tree.
pub enum Operator {
    /// Represents the die operator.
    Die,
    /// Represents the plus operator.
    Plus,
    /// Represents the minus operator.
    Minus,
}

#[derive(Debug, Clone, PartialEq)]
/// Represents the expressions in the parse tree.
pub enum Expr {
    /// Represents the binary expression in the parse tree.
    Binary(Box<Expr>, Box<Expr>, Operator),
    /// Represents the right-associative unary expression in the parse tree.
    Unary(Box<Expr>, Operator),
    /// Represents the numeric literal in the parse tree.
    NumericLiteral(usize),
}

/// Helper function to create numeric literal expression.
pub fn numeric_literal(n: usize) -> Expr {
    Expr::NumericLiteral(n)
}

/// Helper function to create unary expression.
pub fn unary_expr(rhs: Expr, op: Operator) -> Expr {
    Expr::Unary(Box::new(rhs), op)
}

/// Helper function to create binary expression.
pub fn binary_expr(lhs: Expr, rhs: Expr, op: Operator) -> Expr {
    Expr::Binary(Box::new(lhs), Box::new(rhs), op)
}

/// Helper function to create binary roll expression.
pub fn binary_roll_expr(lhs: usize, rhs: usize) -> Expr {
    binary_expr(numeric_literal(lhs), numeric_literal(rhs), Operator::Die)
}

/// Helper function to create unary roll expression.
pub fn unary_roll_expr(rhs: usize) -> Expr {
    unary_expr(numeric_literal(rhs), Operator::Die)
}