runkon-flow 0.6.1-alpha

Portable workflow execution engine — DSL, traits, and in-memory reference implementations
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

use std::collections::HashMap;
use std::path::{Path, PathBuf};
use std::sync::{atomic::AtomicBool, Arc};

use runkon_flow::engine::{ChildWorkflowContext, ChildWorkflowInput, ChildWorkflowRunner};
use runkon_flow::engine_error::EngineError;
use runkon_flow::traits::run_context::RunContext;
use runkon_flow::types::{WorkflowExecConfig, WorkflowResult};
use runkon_flow::CancellationToken;

/// `ChildWorkflowRunner` that logs each call and returns a stub result.
struct LoggingChildRunner;

fn stub_result(run_id: &str, workflow_name: &str) -> WorkflowResult {
    WorkflowResult {
        workflow_run_id: run_id.to_string(),
        workflow_name: workflow_name.to_string(),
        all_succeeded: true,
        total_duration_ms: 0,
        extensions: Default::default(),
    }
}

impl ChildWorkflowRunner for LoggingChildRunner {
    fn execute_child(
        &self,
        workflow_name: &str,
        parent_ctx: &ChildWorkflowContext,
        params: ChildWorkflowInput,
    ) -> Result<WorkflowResult, EngineError> {
        println!(
            "execute_child: workflow={} inputs={}",
            workflow_name,
            params.inputs.len()
        );
        Ok(stub_result(&parent_ctx.workflow_run_id, workflow_name))
    }

    fn resume_child(
        &self,
        workflow_run_id: &str,
        _model: Option<&str>,
        parent_ctx: &ChildWorkflowContext,
    ) -> Result<WorkflowResult, EngineError> {
        println!("resume_child: run_id={}", workflow_run_id);
        Ok(stub_result(
            workflow_run_id,
            parent_ctx.run_ctx.workflow_name(),
        ))
    }

    fn find_resumable_child(
        &self,
        _parent_run_id: &str,
        _workflow_name: &str,
    ) -> Result<Option<runkon_flow::types::WorkflowRun>, EngineError> {
        Ok(None)
    }
}

struct StubCtx(PathBuf);

impl RunContext for StubCtx {
    fn injected_variables(&self) -> HashMap<&'static str, String> {
        HashMap::new()
    }
    fn working_dir(&self) -> &Path {
        &self.0
    }
    fn working_dir_str(&self) -> String {
        self.0.to_string_lossy().into_owned()
    }
    fn get(&self, _: &str) -> Option<String> {
        None
    }
    fn run_id(&self) -> &str {
        "parent-run-001"
    }
    fn workflow_name(&self) -> &str {
        "parent-workflow"
    }
    fn parent_run_id(&self) -> Option<&str> {
        None
    }
    fn shutdown(&self) -> Option<&Arc<AtomicBool>> {
        None
    }
}

fn main() {
    let runner = LoggingChildRunner;
    let ctx = Arc::new(StubCtx(std::env::temp_dir()));
    let parent_ctx = ChildWorkflowContext::new(
        Arc::clone(&ctx) as Arc<dyn RunContext>,
        vec![],
        "parent-run-001".into(),
        None,
        WorkflowExecConfig::default(),
        HashMap::new(),
        Arc::from(vec![]),
    );
    let params = ChildWorkflowInput {
        inputs: HashMap::new(),
        iteration: 0,
        as_identity: None,
        depth: 1,
        parent_step_id: None,
        cancellation: CancellationToken::new(),
    };
    let result = runner
        .execute_child("child-workflow", &parent_ctx, params)
        .expect("execute_child failed");
    println!("succeeded: {}", result.all_succeeded);
}