rs_taskflow 0.1.0

A library for executing graphs of tasks
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

use dyn_clone::DynClone;
use std::fmt::Debug;
use std::marker::Send;

use crate::flow::Flow;
use crate::task::private::AsAny;

mod private {
    use std::any::Any;

    pub trait AsAny: Any {
        fn as_any(&self) -> &dyn Any;
        fn as_mut_any(&mut self) -> &mut dyn Any;
    }

    impl<T: Any> AsAny for T {
        fn as_any(&self) -> &dyn Any {
            self
        }
        fn as_mut_any(&mut self) -> &mut dyn Any {
            self
        }
    }
}

pub trait ExecutableTask: AsAny + DynClone + Sync + Send {
    fn exec(&mut self, flow: &Flow);
}

impl PartialEq for dyn ExecutableTask {
    fn eq(&self, other: &Self) -> bool {
        self == other
    }
}

impl Eq for dyn ExecutableTask {}
dyn_clone::clone_trait_object!(ExecutableTask);

#[cfg(feature = "macro_task_ifaces")]
rs_taskflow_derive::generate_task_input_iface_traits!(TaskInput, set_input, 10);
#[cfg(feature = "macro_task_ifaces")]
rs_taskflow_derive::generate_task_output_iface_traits!(TaskOutput, get_output, 10);
#[cfg(not(feature = "macro_task_ifaces"))]
pub trait TaskInput0<I0>: ExecutableTask {
    fn set_input_0(&mut self, task_input: TaskInputHandle<I0>);
}
#[cfg(not(feature = "macro_task_ifaces"))]
pub trait TaskInput1<I0, I1>: TaskInput0<I0> {
    fn set_input_1(&mut self, task_input: TaskInputHandle<I1>);
}
#[cfg(not(feature = "macro_task_ifaces"))]
pub trait TaskOutput0<O0>: ExecutableTask {
    fn get_output_0(task: &dyn ExecutableTask) -> Option<&O0>;
}
#[cfg(not(feature = "macro_task_ifaces"))]
pub trait TaskOutput1<O0, O1>: TaskOutput0<O0> {
    fn get_output_1(task: &dyn ExecutableTask) -> Option<&O1>;
}

#[derive(Clone)]
struct DummyTask;

impl ExecutableTask for DummyTask {
    fn exec(&mut self, _flow: &Flow) {
        unimplemented!()
    }
}

#[derive(Clone)]
pub struct TaskInputHandle<T> {
    source_task_id: usize,
    value_func: fn(&dyn ExecutableTask) -> Option<&T>,
}

impl<T> TaskInputHandle<T> {
    pub fn new(id: usize, func: fn(&dyn ExecutableTask) -> Option<&T>) -> Self {
        Self {
            source_task_id: id,
            value_func: func,
        }
    }

    pub fn set(&mut self, id: usize, func: fn(&dyn ExecutableTask) -> Option<&T>) {
        self.source_task_id = id;
        self.value_func = func;
    }

    pub fn get_value<'a, 'b>(&'a self, flow: &'b Flow) -> Option<&'b T> {
        let task_handle = flow.get_task_by_id::<DummyTask>(self.source_task_id); // calling task_handle.borrow_concrete() will panic
        let val_ref = (self.value_func)(task_handle.borrow());
        let val_ptr: *const T = val_ref.unwrap();
        unsafe { Some(&*val_ptr) }
    }
}

impl<T> Debug for TaskInputHandle<T> {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("TaskInputHandle")
            .field("source_task_id", &self.source_task_id)
            .field(
                "value_func",
                &format_args!("{:p}", self.value_func as *const ()),
            )
            .finish()
    }
}