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
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
use std::rc::Rc;
use std::cell::RefCell;
use std::default::Default;
use crate::Data;
use crate::progress::{ChangeBatch, Timestamp};
use crate::progress::frontier::{Antichain, MutableAntichain};
use crate::dataflow::{Stream, Scope};
use crate::dataflow::channels::pushers::Tee;
use crate::dataflow::channels::pushers::Counter as PushCounter;
use crate::dataflow::channels::pushers::buffer::Buffer as PushBuffer;
use crate::dataflow::channels::pact::ParallelizationContract;
use crate::dataflow::channels::pullers::Counter as PullCounter;
use crate::dataflow::operators::capability::Capability;
use crate::dataflow::operators::capability::mint as mint_capability;
use crate::dataflow::operators::generic::handles::{InputHandle, new_input_handle, OutputWrapper};
use crate::dataflow::operators::generic::operator_info::OperatorInfo;
use crate::logging::TimelyLogger as Logger;
use super::builder_raw::OperatorBuilder as OperatorBuilderRaw;
pub struct OperatorBuilder<G: Scope> {
builder: OperatorBuilderRaw<G>,
frontier: Vec<MutableAntichain<G::Timestamp>>,
consumed: Vec<Rc<RefCell<ChangeBatch<G::Timestamp>>>>,
internal: Rc<RefCell<Vec<Rc<RefCell<ChangeBatch<G::Timestamp>>>>>>,
produced: Vec<Rc<RefCell<ChangeBatch<G::Timestamp>>>>,
logging: Option<Logger>,
}
impl<G: Scope> OperatorBuilder<G> {
pub fn new(name: String, scope: G) -> Self {
let logging = scope.logging();
OperatorBuilder {
builder: OperatorBuilderRaw::new(name, scope),
frontier: Vec::new(),
consumed: Vec::new(),
internal: Rc::new(RefCell::new(Vec::new())),
produced: Vec::new(),
logging,
}
}
pub fn set_notify(&mut self, notify: bool) {
self.builder.set_notify(notify);
}
pub fn new_input<D: Data, P>(&mut self, stream: &Stream<G, D>, pact: P) -> InputHandle<G::Timestamp, D, P::Puller>
where
P: ParallelizationContract<G::Timestamp, D> {
let connection = vec![Antichain::from_elem(Default::default()); self.builder.shape().outputs()];
self.new_input_connection(stream, pact, connection)
}
pub fn new_input_connection<D: Data, P>(&mut self, stream: &Stream<G, D>, pact: P, connection: Vec<Antichain<<G::Timestamp as Timestamp>::Summary>>) -> InputHandle<G::Timestamp, D, P::Puller>
where
P: ParallelizationContract<G::Timestamp, D> {
let puller = self.builder.new_input_connection(stream, pact, connection);
let input = PullCounter::new(puller);
self.frontier.push(MutableAntichain::new());
self.consumed.push(input.consumed().clone());
new_input_handle(input, self.internal.clone(), self.logging.clone())
}
pub fn new_output<D: Data>(&mut self) -> (OutputWrapper<G::Timestamp, D, Tee<G::Timestamp, D>>, Stream<G, D>) {
let connection = vec![Antichain::from_elem(Default::default()); self.builder.shape().inputs()];
self.new_output_connection(connection)
}
pub fn new_output_connection<D: Data>(&mut self, connection: Vec<Antichain<<G::Timestamp as Timestamp>::Summary>>) -> (OutputWrapper<G::Timestamp, D, Tee<G::Timestamp, D>>, Stream<G, D>) {
let (tee, stream) = self.builder.new_output_connection(connection);
let internal = Rc::new(RefCell::new(ChangeBatch::new()));
self.internal.borrow_mut().push(internal.clone());
let mut buffer = PushBuffer::new(PushCounter::new(tee));
self.produced.push(buffer.inner().produced().clone());
(OutputWrapper::new(buffer, internal), stream)
}
pub fn build<B, L>(self, constructor: B)
where
B: FnOnce(Vec<Capability<G::Timestamp>>) -> L,
L: FnMut(&[MutableAntichain<G::Timestamp>])+'static
{
let mut capabilities = Vec::new();
for output_index in 0 .. self.internal.borrow().len() {
let borrow = &self.internal.borrow()[output_index];
capabilities.push(mint_capability(Default::default(), borrow.clone()));
borrow.borrow_mut().clear();
}
let mut logic = constructor(capabilities);
let self_frontier1 = Rc::new(RefCell::new(self.frontier));
let self_frontier2 = self_frontier1.clone();
let self_consumed = self.consumed;
let self_internal = self.internal;
let self_produced = self.produced;
let pep = move |changes: &mut [ChangeBatch<G::Timestamp>]| {
let mut borrow = self_frontier1.borrow_mut();
for index in 0 .. changes.len() {
borrow[index].update_iter(changes[index].drain());
}
};
let pip = move |consumed: &mut [ChangeBatch<G::Timestamp>],
internal: &mut [ChangeBatch<G::Timestamp>],
produced: &mut [ChangeBatch<G::Timestamp>]| {
let borrow = self_frontier2.borrow();
logic(&*borrow);
for index in 0 .. consumed.len() {
self_consumed[index].borrow_mut().drain_into(&mut consumed[index]);
}
let self_internal_borrow = self_internal.borrow_mut();
for index in 0 .. self_internal_borrow.len() {
let mut borrow = self_internal_borrow[index].borrow_mut();
internal[index].extend(borrow.drain());
}
for index in 0 .. produced.len() {
self_produced[index].borrow_mut().drain_into(&mut produced[index]);
}
false
};
self.builder.build(pep, pip);
}
pub fn index(&self) -> usize {
self.builder.index()
}
pub fn global(&self) -> usize {
self.builder.global()
}
pub fn operator_info(&self) -> OperatorInfo {
self.builder.operator_info()
}
}
#[cfg(test)]
mod tests {
#[test]
#[should_panic]
fn incorrect_capabilities() {
use crate::dataflow::operators::generic::builder_rc::OperatorBuilder;
crate::example(|scope| {
let mut builder = OperatorBuilder::new("Failure".to_owned(), scope.clone());
let (mut output1, _stream1) = builder.new_output::<()>();
let (mut output2, _stream2) = builder.new_output::<()>();
builder.build(move |capabilities| {
move |_frontiers| {
let mut output_handle1 = output1.activate();
let mut output_handle2 = output2.activate();
output_handle2.session(&capabilities[0]);
output_handle1.session(&capabilities[1]);
}
});
})
}
#[test]
fn correct_capabilities() {
use crate::dataflow::operators::generic::builder_rc::OperatorBuilder;
crate::example(|scope| {
let mut builder = OperatorBuilder::new("Failure".to_owned(), scope.clone());
let (mut output1, _stream1) = builder.new_output::<()>();
let (mut output2, _stream2) = builder.new_output::<()>();
builder.build(move |mut capabilities| {
move |_frontiers| {
let mut output_handle1 = output1.activate();
let mut output_handle2 = output2.activate();
if !capabilities.is_empty() {
output_handle1.session(&capabilities[0]);
output_handle2.session(&capabilities[1]);
capabilities.clear();
}
}
});
"Hello".to_owned()
});
}
}