dpcs 0.5.0

Reference implementation of the Data Pipeline Contract Standard (DPCS)
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

//! Structural validation phase.

use crate::diagnostics::{categories, Diagnostic, ValidationReport};
use crate::model::PipelineContract;

/// Validate non-identity structural constraints.
///
/// Identifier presence and uniqueness are owned by the Canonical Object Model
/// phase. This phase covers remaining structural shape such as step types.
pub fn validate(contract: &PipelineContract) -> ValidationReport {
    let mut report = ValidationReport::new();

    for step in &contract.steps {
        if step.id.trim().is_empty() {
            continue;
        }

        if step.step_type.trim().is_empty() {
            report.push(
                Diagnostic::error(
                    "DPCS-STR-003",
                    categories::STRUCTURAL,
                    format!("pipeline step `{}` has an empty type", step.id),
                )
                .with_object_ref(format!("steps.{}.type", step.id))
                .with_remediation("Provide a step type"),
            );
        }

        for (side, ports) in [("inputs", &step.inputs), ("outputs", &step.outputs)] {
            for (index, port) in ports.iter().enumerate() {
                if port.id.trim().is_empty() {
                    report.push(
                        Diagnostic::error(
                            "DPCS-STR-001",
                            categories::STRUCTURAL,
                            format!(
                                "pipeline step `{}` declares an empty {side} port id",
                                step.id
                            ),
                        )
                        .with_object_ref(format!("steps.{}.{side}[{index}].id", step.id))
                        .with_remediation("Provide a non-empty port identifier"),
                    );
                }
            }
        }
    }

    report
}