blok 0.0.23

Types and traits for graphlike 3D arrays, designed for visual thinkers.
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


use blok::*;

#[derive(
    Default, Clone,         // Necessary for Block impl
    Debug, Eq, PartialEq    // Nice to have for testing
)]
pub struct MyNode {
    pub id: String,
    pub connections: Vec<String>,
}

impl Block for MyNode {

    type CreationInstructions = String;

    fn create(id: &String) -> Self {
        MyNode {
            id: id.to_owned(),
            connections: Vec::new(),
        }
    }

    fn void() -> Self {
        Self::default()
    }

    fn is_void(&self) -> bool {
        self.id.is_empty()
    }

}


impl Node for MyNode {

    type ConnectionInstructions = u32;

    fn connect(
        &mut self, 
        other: &mut Self, 
        times: &u32
    ) {
        for _ in 0..*times {
            self.connections.push(other.id.clone())
        }
    }

}


// Borrowing this from example 1.
fn build_cube() -> Stack<MyNode> {
    let mut stack = Stack::new();
    stack
        .populate_with_clones(vec!{ layout![4; 4]; 4 }, &MyNode::void())
        .get_all_mut()
            .into_iter()
            .enumerate()
            .for_each(|(l, layer_mut)| { 
                layer_mut.into_iter()
                    .enumerate()
                    .for_each(|(r, row_mut)| {
                        row_mut.into_iter()
                            .enumerate()
                            .for_each(|(b, block_mut)| {
                                block_mut.id = format!("{}{}{}", l, r, b)
                            });
                    });
            });
    stack
}


pub fn main() {

    // Two identical cube stacks:
    let (mut cube1, mut cube2) = (build_cube(), build_cube());

    cube1.connect(&mut cube2,
        // Alignments for the layer, row, and block;
        // these are used to organize the pairings for procedural connection generation.
        Alignment::corresponding,
        Alignment::corresponding,
        Alignment::corresponding,
        // By breaking instructions into vectors, 
        // we are able to customize the instruction for each connection.
        // If you don't provide enough instructions to cover each connection,
        // the last instruction will be repeated for the remaining connections.
        // If you don't provide any connection instructions, it will use the default.
        // (This syntax will be made cleaner at some point.)
        vec![vec![vec![1]]], 
    );

    // TBD: In the future, iterating over types will be much easier.
    cube1.get_all_mut()
        .into_iter()
        .for_each(|layer_mut| {
            layer_mut.into_iter()
                .for_each(|row_mut| {
                    row_mut.into_iter()
                        .for_each(|block_mut| {
                            // Each block should have one connection,
                            assert_eq!(block_mut.connections.len(), 1);
                            // and it should be connected to a block that shares its ID,
                            // since it connects to a corresponding block in an idential stack.
                            assert_eq!(
                                block_mut.id, 
                                block_mut.connections[0]
                            );
                        });
                });
        });


    //let mut cube3 = build_cube();
    // TODO: connect rows and layers within stack 

    println!("That's all folks!");
}