acts 0.22.0

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

use super::super::core::RunningMode;
use crate::{
    Act, ActError, Context, Result, Vars,
    package::{
        ActPackage, ActPackageCatalog, ActPackageDefinition, ActPackageRegister, ActRunAs,
        core::block::BlockPackageParams,
    },
    utils::consts,
};
use serde::{Deserialize, Serialize};
use serde_json::{Value as JsonValue, json};

#[derive(Debug, Clone)]
pub struct ParallelPackage;

#[derive(Debug, Clone, Deserialize, Serialize)]
struct ParallelPackageParams {
    r#in: Vec<JsonValue>,
    acts: Vec<Act>,
}

#[async_trait::async_trait]
impl ActPackage for ParallelPackage {
    fn definition() -> ActPackageDefinition {
        ActPackageDefinition {
            id: "acts.core.parallel",
            name: "Parallel",
            desc: "create acts based on an array and run them in parallel",
            version: "0.1.0",
            icon: r#"<svg viewBox="0 0 1024 1024" version="1.1" xmlns="http://www.w3.org/2000/svg" width="24" height="24"><path d="M822.656 649.344l128 128v45.312l-128 128-45.312-45.312L850.752 832H250.496a96 96 0 1 1 0-64h600.256l-73.408-73.344z m0-640l-45.312 45.312L850.752 128H250.496a96 96 0 1 0 0 64h600.256l-73.408 73.344 45.312 45.312 128-128v-45.312z m-45.312 365.312L850.752 448H250.496a96 96 0 1 0 0 64h600.256l-73.408 73.344 45.312 45.312 128-128v-45.312l-128-128z" fill="currentColor"></path></svg>"#,
            doc: "",
            schema: json!({
                "type": "object",
                "properties": {
                    "in": {
                        "type": "array",
                        "title": "In",
                        "items": { "type": "string" },
                        "description": "The input array to create acts"
                    },
                    "acts": {
                        "type": "array",
                        "title": "Actions",
                        "items": { "type": "object" },
                        "description": "The acts to run in parallel"
                    }
                },
                "required": ["in", "acts"]
            }),
            options: Some(json!({
                "in": {
                    "ui:widget": "in",
                },
                "acts": {
                    "ui:widget": "actions",
                    "ui:options": {
                        "label": false,
                        "addButtonText": "Add Act"
                    }
                }
            })),

            run_as: ActRunAs::Func,
            resources: vec![],
            catalog: ActPackageCatalog::Core,
        }
    }

    fn new(_config: &crate::Config) -> crate::Result<Self> {
        Ok(Self)
    }

    async fn execute(&self, ctx: &Context, params: &serde_json::Value) -> Result<Option<Vars>> {
        let params =
            serde_json::from_value::<ParallelPackageParams>(params.clone()).map_err(|e| {
                ActError::Package(format!(
                    "invalid ActPackage({}) params: {}",
                    Self::definition().id,
                    e
                ))
            })?;
        let mut acts = Vec::new();
        for (index, value) in params.r#in.iter().enumerate() {
            let block_params = serde_json::to_value(BlockPackageParams {
                mode: RunningMode::Parallel,
                acts: params.acts.clone(),
            })?;

            acts.push(Act {
                uses: "acts.core.block".to_string(),
                options: Vars::new()
                    .with(consts::ACT_INDEX, index)
                    .with(consts::ACT_VALUE, value),
                params: block_params,
                ..Default::default()
            });
        }
        ctx.build_acts(&acts, false)?;
        Ok(None)
    }
}

inventory::submit!(ActPackageRegister::new::<ParallelPackage>());

#[cfg(test)]
mod tests {
    use crate::ActPackage;

    #[test]
    fn pack_parallel_parse() {
        let params = r#"
            in: ["u1", "u2"]
            acts:
                - uses: acts.core.irq
                  params:
                    a: 1
                - uses: acts.core.irq
                  params:
                    b: 10
        "#;

        let value = serde_yaml::from_str::<serde_json::Value>(params).unwrap();
        let meta = super::ParallelPackage::definition();
        jsonschema::validate(&meta.schema, &value).unwrap()
    }
}