odcs 0.9.1

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

//! Document-level validation.

use crate::diagnostics::{
    codes, emit, validation_error, DiagnosticCategory, DiagnosticReport, ValidationPhase,
};
use crate::model::DataContract;

/// Validate document-level constraints.
#[must_use]
pub fn validate(contract: &DataContract) -> DiagnosticReport {
    let mut report = DiagnosticReport::new();

    if contract.version.is_empty() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::MISSING_REQUIRED_FIELD,
                DiagnosticCategory::Structure,
                "contract version must not be empty",
            )
            .with_object_ref("version"),
        );
    }

    if contract.api_version.is_empty() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::MISSING_REQUIRED_FIELD,
                DiagnosticCategory::Structure,
                "contract apiVersion must not be empty",
            )
            .with_object_ref("apiVersion"),
        );
    } else if !contract.is_supported_api_version() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::UNSUPPORTED_VERSION,
                DiagnosticCategory::Compatibility,
                format!(
                    "unsupported ODCS apiVersion '{}'; supported: {:?}",
                    contract.api_version,
                    crate::model::SUPPORTED_API_VERSIONS
                ),
            )
            .with_object_ref("apiVersion")
            .with_remediation("set apiVersion to a supported ODCS release"),
        );
    }

    if contract.id.is_empty() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::MISSING_REQUIRED_FIELD,
                DiagnosticCategory::Structure,
                "contract id must not be empty",
            )
            .with_object_ref("id"),
        );
    }

    if contract.status.is_empty() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::MISSING_REQUIRED_FIELD,
                DiagnosticCategory::Structure,
                "contract status must not be empty",
            )
            .with_object_ref("status"),
        );
    }

    if contract.kind.is_empty() {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::MISSING_REQUIRED_FIELD,
                DiagnosticCategory::Structure,
                "contract kind must not be empty",
            )
            .with_object_ref("kind"),
        );
    } else if contract.kind != "DataContract" {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Document,
                codes::INVALID_KIND,
                DiagnosticCategory::Structure,
                format!("expected kind 'DataContract', got '{}'", contract.kind),
            )
            .with_object_ref("kind"),
        );
    }

    report
}