tangibl 0.1.0

A parser for generating an AST from a set of predefined TopCodes
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
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

use crate::{
    ast::{
        BooleanMethod, BooleanMethodKind, Command, Condition, Conditional, ConditionalKind, Flow,
        FlowKind, IntegerMethod, IntegerMethodKind, Start, Value,
    },
    parser::Parser,
};
use std::collections::VecDeque;
use topcodes::TopCode;

pub fn parse(topcodes: &Vec<TopCode>) -> Option<Start> {
    Parser::new(topcodes).parse()
}

pub fn start() -> TangiblStartBuilder {
    TangiblStartBuilder::default()
}

pub fn flow() -> TangiblFlowBuilder {
    TangiblFlowBuilder::default()
}

#[derive(Default, Debug)]
pub struct TangiblStartBuilder {
    /// The main flow for the program. As if it were the 'main' function of many common languages.
    flow_builder: TangiblFlowBuilder,
}

impl TangiblStartBuilder {
    pub fn with_command(&mut self, command: Command) -> &mut Self {
        self.flow_builder.with_command(command);
        self
    }

    pub fn with_conditional(
        &mut self,
        conditional_kind: ConditionalKind,
        alternate: Option<Flow>,
    ) -> &mut Self {
        self.flow_builder.with_conditional(Conditional {
            kind: conditional_kind,
            alternate: alternate.map(Box::new),
        });
        self
    }

    pub fn with_boolean_method(
        &mut self,
        boolean_method_kind: BooleanMethodKind,
        condition: Option<Condition>,
        body: Option<Flow>,
    ) -> &mut Self {
        self.flow_builder
            .with_boolean_method(boolean_method_kind, condition, body);
        self
    }

    pub fn with_integer_method(
        &mut self,
        integer_method_kind: IntegerMethodKind,
        value: Option<Value>,
        body: Option<Flow>,
    ) -> &mut Self {
        self.flow_builder
            .with_integer_method(integer_method_kind, value, body);
        self
    }

    pub fn build(&mut self) -> Start {
        Start {
            next: self.flow_builder.build(),
        }
    }
}

#[derive(Default, Debug)]
pub struct TangiblFlowBuilder {
    nodes: VecDeque<Flow>,
}

impl TangiblFlowBuilder {
    pub fn with_command(&mut self, command: Command) -> &mut Self {
        self.with_flow(Flow::new(FlowKind::Command(command)));
        self
    }

    pub fn with_conditional(&mut self, conditional: Conditional) -> &mut Self {
        self.with_flow(Flow::new(FlowKind::Conditional(conditional)));
        self
    }

    pub fn with_boolean_method(
        &mut self,
        boolean_method_kind: BooleanMethodKind,
        condition: Option<Condition>,
        body: Option<Flow>,
    ) -> &mut Self {
        self.with_flow(Flow::new(FlowKind::BooleanMethod(BooleanMethod {
            kind: boolean_method_kind,
            condition,
            body: body.map(Box::new),
        })));
        self
    }

    pub fn with_integer_method(
        &mut self,
        integer_method_kind: IntegerMethodKind,
        value: Option<Value>,
        body: Option<Flow>,
    ) -> &mut Self {
        self.with_flow(Flow::new(FlowKind::IntegerMethod(IntegerMethod {
            kind: integer_method_kind,
            value,
            body: body.map(Box::new),
        })));
        self
    }

    pub fn build(&mut self) -> Option<Flow> {
        let mut current = None;
        while let Some(mut node) = self.nodes.pop_back() {
            match current {
                None => current = Some(node),
                Some(_) => {
                    node.next = current.map(Box::new);
                    current = Some(node);
                }
            }
        }
        current
    }

    fn with_flow(&mut self, flow: Flow) -> &mut Self {
        self.nodes.push_back(flow);
        self
    }
}