acts 0.17.2

a fast, lightweight, extensiable workflow engine
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
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

use crate::{ActError, Vars};
use core::fmt;
use serde::{Deserialize, Serialize, de};
use serde_json::Value;
use std::collections::HashMap;

#[derive(Debug, Default, Clone, Serialize, Deserialize, strum::AsRefStr)]
pub enum OutputType {
    #[default]
    String,
    Bool,
    Number,
    Array,
    Object,
}

#[derive(Debug, Default, Clone, Serialize, Deserialize)]
pub struct Output {
    pub required: bool,
    pub default: Value,
    pub r#type: OutputType,
}

#[derive(Debug, Default, Clone)]
pub struct Outputs {
    inner: HashMap<String, Output>,
}

fn get<T>(name: &str, value: &Value) -> Option<T>
where
    T: for<'de> Deserialize<'de> + Clone,
{
    if let Some(v) = value.get(name) {
        if let Ok(v) = serde_json::from_value::<T>(v.clone()) {
            return Some(v);
        }
    }

    None
}

impl fmt::Display for OutputType {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        f.write_str(self.as_ref())
    }
}

impl From<Value> for Output {
    fn from(value: Value) -> Self {
        let required = get::<bool>("required", &value).unwrap_or_default();
        let default = get::<Value>("default", &value).unwrap_or_default();
        let r#type = get::<OutputType>("type", &value).unwrap_or_default();

        Self {
            required,
            default,
            r#type,
        }
    }
}

impl Serialize for Outputs {
    fn serialize<S>(&self, serializer: S) -> core::result::Result<S::Ok, S::Error>
    where
        S: serde::Serializer,
    {
        use serde::ser::SerializeMap;

        let mut map = serializer.serialize_map(Some(self.inner.len()))?;
        for (k, v) in &self.inner {
            map.serialize_entry(k, v)?;
        }
        map.end()
    }
}

impl<'de> Deserialize<'de> for Outputs {
    fn deserialize<D>(deserializer: D) -> core::result::Result<Self, D::Error>
    where
        D: serde::Deserializer<'de>,
    {
        struct Visitor;

        impl<'de> de::Visitor<'de> for Visitor {
            type Value = HashMap<String, Output>;
            fn expecting(&self, formatter: &mut fmt::Formatter) -> fmt::Result {
                formatter.write_str("a map")
            }

            #[inline]
            fn visit_unit<E>(self) -> Result<Self::Value, E>
            where
                E: de::Error,
            {
                Ok(HashMap::new())
            }

            #[inline]
            fn visit_map<V>(self, mut visitor: V) -> Result<Self::Value, V::Error>
            where
                V: de::MapAccess<'de>,
            {
                let mut values = HashMap::new();

                while let Some((key, value)) = visitor.next_entry::<String, Value>()? {
                    let value: Output = value.into();
                    values.insert(key, value);
                }

                Ok(values)
            }
        }

        core::result::Result::Ok(Self {
            inner: deserializer.deserialize_map(Visitor)?,
        })
    }
}

impl Outputs {
    pub fn push(&mut self, name: &str, output: &Output) {
        self.inner.insert(name.to_string(), output.clone());
    }

    pub fn check(&self, vars: &Vars) -> crate::Result<()> {
        for (k, output) in &self.inner {
            let v = vars.get::<Value>(k);
            if v.is_none() && output.required {
                return Err(ActError::Runtime(format!("the key '{k}' is required",)));
            }

            if let Some(v) = &v {
                let is_type_match = match output.r#type {
                    OutputType::String => v.is_string(),
                    OutputType::Bool => v.is_boolean(),
                    OutputType::Number => v.is_number(),
                    OutputType::Array => v.is_array(),
                    OutputType::Object => v.is_object(),
                };

                if !is_type_match {
                    return Err(ActError::Runtime(format!(
                        "the value {k}({v}) is not matched the type '{}'",
                        output.r#type
                    )));
                }
            }
        }
        Ok(())
    }
}