dagrs 0.8.1

Dagrs follows the concept of Flow-based Programming and is suitable for the execution of multiple tasks with graph-like dependencies. Dagrs has the characteristics of high performance and asynchronous execution. It provides users with a convenient programming 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

use std::sync::{
    Arc, Mutex,
    atomic::{AtomicBool, Ordering},
};

use log::warn;

use super::output::Output;
use crate::connection::information_packet::Content;

#[derive(Debug)]
pub(crate) struct ExecState {
    /// The execution succeed or not.
    success: AtomicBool,
    /// Output produced by a task.
    output: Arc<Mutex<Output>>,
}

impl ExecState {
    /// Construct a new [`ExeState`].
    pub(crate) fn new() -> Self {
        // initialize the task to failure without output.
        Self {
            success: AtomicBool::new(false),
            output: Arc::new(Mutex::new(Output::empty())),
            //semaphore: Semaphore::new(0),
        }
    }

    /// After the task is successfully executed, set the execution result.
    pub(crate) fn set_output(&self, output: Output) {
        self.success.store(true, Ordering::Relaxed);
        match self.output.lock() {
            Ok(mut guard) => {
                *guard = output;
            }
            Err(poisoned) => {
                warn!("ExecState output mutex poisoned in set_output, recovering inner value");
                *poisoned.into_inner() = output;
            }
        }
    }

    /// [`Output`] for fetching internal storage.
    /// This function is generally not called directly, but first uses the semaphore for synchronization control.
    pub(crate) fn get_output(&self) -> Option<Content> {
        match self.output.lock() {
            Ok(guard) => guard.get_out(),
            Err(poisoned) => {
                warn!("ExecState output mutex poisoned in get_output, recovering inner value");
                poisoned.into_inner().get_out()
            }
        }
    }
    pub(crate) fn get_full_output(&self) -> Output {
        match self.output.lock() {
            Ok(guard) => guard.clone(),
            Err(poisoned) => {
                warn!("ExecState output mutex poisoned in get_full_output, recovering inner value");
                poisoned.into_inner().clone()
            }
        }
    }

    pub(crate) fn exe_success(&self) {
        self.success.store(true, Ordering::Relaxed)
    }

    pub(crate) fn exe_fail(&self) {
        self.success.store(false, Ordering::Relaxed)
    }

    pub(crate) fn is_success(&self) -> bool {
        self.success.load(Ordering::Relaxed)
    }
}