garnish_lang_runtime 0.0.11-alpha

Runtime and execution library for Garnish Lang.
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
94
95
96

use log::trace;

use crate::runtime::error::state_error;
use crate::runtime::utilities::next_ref;
use garnish_lang_traits::{GarnishDataType, GarnishData, RuntimeError};

pub(crate) fn jump<Data: GarnishData>(this: &mut Data, index: Data::Size) -> Result<Option<Data::Size>, RuntimeError<Data::Error>> {
    match this.get_jump_point(index.clone()) {
        None => state_error(format!("No jump point at index {:?}", index))?,
        Some(point) => {
            trace!("Jumping to point {:?}", point);
            return Ok(Some(point));
        }
    }

    Ok(None)
}

pub(crate) fn jump_if_true<Data: GarnishData>(
    this: &mut Data,
    index: Data::Size,
) -> Result<Option<Data::Size>, RuntimeError<Data::Error>> {
    let point = match this.get_jump_point(index.clone()) {
        None => state_error(format!("No jump point at index {:?}", index))?,
        Some(point) => point,
    };

    let d = next_ref(this)?;

    match this.get_data_type(d.clone())? {
        GarnishDataType::False | GarnishDataType::Unit => {
            trace!("Not jumping from value of type {:?} with addr {:?}", this.get_data_type(d.clone())?, d);
            Ok(None)
        }
        // all other values are considered true
        t => {
            trace!("Jumping from value of type {:?} with addr {:?} to point {:?}", t, d, point);
            Ok(Some(point))
        }
    }
}

pub(crate) fn jump_if_false<Data: GarnishData>(
    this: &mut Data,
    index: Data::Size,
) -> Result<Option<Data::Size>, RuntimeError<Data::Error>> {
    let point = match this.get_jump_point(index.clone()) {
        None => state_error(format!("No jump point at index {:?}", index))?,
        Some(point) => point,
    };

    let d = next_ref(this)?;

    match this.get_data_type(d.clone())? {
        GarnishDataType::False | GarnishDataType::Unit => {
            trace!(
                "Jumping from value of type {:?} with addr {:?} to point {:?}",
                this.get_data_type(d.clone())?,
                d,
                point
            );
            Ok(Some(point))
        }
        t => {
            trace!("Not jumping from value of type {:?} with addr {:?}", t, d);
            Ok(None)
        }
    }
}

pub(crate) fn end_expression<Data: GarnishData>(this: &mut Data) -> Result<Option<Data::Size>, RuntimeError<Data::Error>> {
    match this.pop_jump_path() {
        None => {
            // no more jumps, this should be the end of the entire execution
            let r = next_ref(this)?;
            trace!(
                "No remaining return points. Pushing {:?} to values. Setting cursor to instruction length {:?}.",
                r,
                this.get_instruction_len()
            );

            match this.get_current_value_mut() {
                None => state_error(format!("No inputs available to update during end expression operation."))?,
                Some(v) => *v = r,
            }

            Ok(Some(this.get_instruction_len()))
        }
        Some(jump_point) => {
            trace!("Setting cursor to {:?}", jump_point);
            this.pop_value_stack();

            Ok(Some(jump_point))
        }
    }
}