gmt_dos-actors-clients_interface 1.5.1

Giant Magellan Telescope Dynamic Optical Simulation Actor to Clients Interface
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

/**
Clients chain

Apply the traits [Read], [Update] and [Write] (and in that order)
 to clients which inputs and outputs form an uninterrupted chain

A single client:
```ignore
chain!(
    input_uid: input_data_1,
    ...,
    input_uid: input_data_n;
    client;
    output_uid: output_data_1,
    ...,
    output_uid: output_data_n);
```

Two clients where the UID of the output of `client1` is
also the UID of the input of `client2`:
```ignore
chain!(
    client1_input_uid: client_1_input_data_1,
    ...,
    client1_input_uid: client_1_input_data_n;
    client1;
    io_uid;
    client2;
    io_uid;
    ...;
    clientn:
    clientn_output_uid: client2_output_data_1,
    ...,
    clientn_output_uid: client2_output_data_n);
    );
```

*/
#[macro_export]
macro_rules! chain {
    // read, update
    // UID1: input1, ..., UIDN: inputN; client
    ($($r:ty:$vr:expr),+;$e:expr) => {
        $(<_ as ::interface::Read<$r>>::read($e, interface::Data::<$r>::from($vr));)+
        <_ as ::interface::Update>::update($e);
    };
    // update, write
    // client; UID1: output1, ..., UIDN: outputN
    ($e:expr;$($w:ty:$vw:ident),+) => {
            <_ as ::interface::Update>::update($e);
            $(let $vw = <_ as ::interface::Write<$w>>::write($e).expect(&format!(
                "cannot write to {}",
                ::std::any::type_name::<$w>()
            ));)+
    };
    // read, update, write
    // UID1: input1, ..., UIDN: inputN; client; UID1: output1, ..., UIDN: outputN
    ($($r:ty:$vr:expr),+;$e:expr;$($w:ty:$vw:ident),+) => {
            $(<_ as ::interface::Read<$r>>::read($e, interface::Data::<$r>::from($vr));)+
            <_ as ::interface::Update>::update($e);
            $(let $vw =<_ as ::interface::Write<$w>>::write($e).expect(&format!(
                "cannot write to {}",
                ::std::any::type_name::<$w>()
            ));)+
    };
    // read, update, write, read, update
    // UID1: input1, ..., UIDN: inputN; client1; UID; client2
    ($($r1:ty:$vr1:expr),+;$e1:expr;$w1:ty;$e2:expr) => {
        ::interface::chain!($($r1:$vr1),+;$e1;$w1:data);
        ::interface::chain!($w1:data;$e2);
    };
    // update, write, read, update
    // client1; UID; client2
    ($e1:expr;$w1:ty;$e2:expr) => {
        ::interface::chain!($e1;$w1:data);
        ::interface::chain!($w1:data;$e2);
    };
    // update, write, read, update, write
    // client1; UID; client2; UID1: output1, ..., UIDN: outputN
    ($e1:expr;$w1:ty;$e2:expr;$($w2:ty:$vw2:ident),+) => {
        ::interface::chain!($e1;$w1:data);
        ::interface::chain!($w1:data;$e2;$($w2:$vw2),+);
    };
    // read, update, write, read, update, write
    // UID1: input1, ..., UIDN: inputN; client1; UID; client2; UID1: output1, ..., UIDN: outputN
    ($($r1:ty:$vr1:expr),+;$e1:expr;$w1:ty;$e2:expr;$($w2:ty:$vw2:ident),+) => {
        ::interface::chain!($($r1:$vr1),+;$e1;$w1:data);
        ::interface::chain!($w1:data;$e2;$($w2:$vw2),+);
    };
    // read, update, write, read, update, write, read, update, write
    // UID1: input1, ..., UIDN: inputN; client1; UID; client2; UID; client3; UID1: output1, ..., UIDN: outputN
    ($($r1:ty:$vr1:expr),+;$e1:expr;$w1:ty;$e2:expr;$w2:ty;$e3:expr;$($w3:ty:$vw3:ident),+) => {
        ::interface::chain!($($r1:$vr1),+;$e1;$w1;$e2;$w2:data);
        ::interface::chain!($w2:data;$e3;$($w3:$vw3),+);
    };
    // read, update, write, read, update, write, read, update, write, read, update, write
    // UID1: input1, ..., UIDN: inputN; client1; UID; client2; UID; client3; UID; client4; UID1: output1, ..., UIDN: outputN
    ($($r1:ty:$vr1:expr),+;$e1:expr;$w1:ty;$e2:expr;$w2:ty;$e3:expr;$w3:ty;$e4:expr;$($w4:ty:$vw4:ident),+) => {
        ::interface::chain!($($r1:$vr1),+;$e1;$w1;$e2;$w2;$e3;$w3:data);
        ::interface::chain!($w3:data;$e4;$($w4:$vw4),+);
    };
}