protoflow 0.4.3

Protoflow implements flow-based programming (FBP) for Rust using Protocol Buffers messages.
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

// This is free and unencumbered software released into the public domain.

use crate::exit::ExitCode;
use protoflow_blocks::{build_stdio_system, types::Encoding, StdioConfig, StdioError};
use protoflow_core::SystemExecution;
use std::path::PathBuf;

pub fn execute(
    system_uri: PathBuf,
    system_params: Vec<(String, String)>,
    stdio_encoding: Encoding,
) -> Result<(), ExitCode> {
    let system_uri = system_uri.to_string_lossy().to_string();
    let system_config = StdioConfig {
        encoding: stdio_encoding,
        params: system_params.iter().cloned().collect(),
    };
    let system = build_stdio_system(system_uri, system_config)?;
    system.execute().unwrap().join().unwrap(); // TODO: improve error handling
    Ok(())
}

#[derive(Clone, Debug)]
pub enum ExecuteError {
    UnknownSystem(String),
    UnknownParameter(String),
    MissingParameter(&'static str),
    InvalidParameter(&'static str),
    InvalidEncoding(String),
}

impl std::error::Error for ExecuteError {}

impl std::fmt::Display for ExecuteError {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        use ExecuteError::*;
        match self {
            UnknownSystem(system) => {
                write!(f, "unknown system: {}", system)
            }
            UnknownParameter(parameter) => {
                write!(f, "unknown parameter: {}", parameter)
            }
            MissingParameter(parameter) => {
                write!(f, "missing parameter: {}", parameter)
            }
            InvalidParameter(parameter) => {
                write!(f, "invalid parameter: {}", parameter)
            }
            InvalidEncoding(encoding) => {
                write!(f, "invalid encoding: {}", encoding)
            }
        }
    }
}

impl From<StdioError> for ExecuteError {
    fn from(error: StdioError) -> Self {
        use StdioError::*;
        match error {
            UnknownSystem(system) => Self::UnknownSystem(system),
            UnknownParameter(parameter) => Self::UnknownParameter(parameter),
            MissingParameter(parameter) => Self::MissingParameter(parameter),
            InvalidParameter(parameter) => Self::InvalidParameter(parameter),
        }
    }
}