stackr-rs 0.1.14

A stack-based interpreter to be embedded in your application. Heavily inspired by Forth.
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

use super::*;

pub fn register_builtins<State>(interpreter: &mut Interpreter<State>) {
    let example = "[ rot drop dup ]";
    interpreter.register_builtin(
            "[",
            ".. -- ..",
            "Begins read mode. The addresses of all following words are put on the stack. Use ']' to end.",
            example,
            |interpreter| {
                interpreter.read_mode = ReadMode::On;
                Ok(())
            },
        );

    interpreter.register_builtin(
        "]",
        "",
        "Ends read mode. All following words are evaluated.",
        example,
        |interpreter| {
            interpreter.read_mode = ReadMode::Off;
            Ok(())
        },
    );
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn sets_read_mode_true() {
        let mut interpreter = Interpreter::new(());
        interpreter.register_builtins();
        interpreter.evaluate("[", None).unwrap();
        assert_eq!(interpreter.read_mode, ReadMode::On);
    }

    #[test]
    fn sets_read_mode_false() {
        let mut interpreter = Interpreter::new(());
        interpreter.register_builtins();
        interpreter.evaluate("[ ]", None).unwrap();
        assert_eq!(interpreter.read_mode, ReadMode::Off);
    }

    #[test]
    fn read_mode_puts_addresses_on_stack() {
        let mut interpreter = Interpreter::new(());
        interpreter.register_builtins();
        interpreter.evaluate("[ hi there buddy ]", None).unwrap();

        let input = ["hi", "there", "buddy"];
        let expected = input
            .iter()
            .map(|s| StackValue::Address(interpreter.get_address(s)))
            .collect::<Vec<_>>();

        assert_eq!(expected, interpreter.stack);
    }
}