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
107
108
109
110
111
112
113
114
115
116
117
118
119

//! Stable identifier validation.

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

fn is_valid_stable_id(value: &str) -> bool {
    !value.is_empty()
        && value
            .chars()
            .all(|ch| ch.is_ascii_alphanumeric() || ch == '_' || ch == '-')
}

fn validate_stable_id(report: &mut DiagnosticReport, id: &StableId, object_ref: &str) {
    if !is_valid_stable_id(&id.0) {
        emit(
            report,
            validation_error(
                ValidationPhase::Ids,
                codes::INVALID_EXTENSION,
                DiagnosticCategory::Extension,
                format!("stable id '{}' contains invalid characters", id.0),
            )
            .with_object_ref(object_ref.to_string())
            .with_remediation("use only letters, numbers, underscores, and hyphens"),
        );
    }
}

fn validate_optional_stable_id(
    report: &mut DiagnosticReport,
    id: &Option<StableId>,
    object_ref: &str,
) {
    if let Some(id) = id {
        validate_stable_id(report, id, object_ref);
    }
}

/// Validate stable identifier patterns across the contract.
#[must_use]
pub fn validate(contract: &DataContract) -> DiagnosticReport {
    let mut report = DiagnosticReport::new();

    if !contract.id.is_empty() && !is_valid_stable_id(&contract.id) {
        emit(
            &mut report,
            validation_error(
                ValidationPhase::Ids,
                codes::INVALID_EXTENSION,
                DiagnosticCategory::Extension,
                format!("contract id '{}' contains invalid characters", contract.id),
            )
            .with_object_ref("id".to_string()),
        );
    }

    for (index, schema) in contract.schema.iter().enumerate() {
        let base_ref = format!("schema[{index}]");
        validate_optional_stable_id(&mut report, &schema.element.id, &format!("{base_ref}.id"));
        validate_property_ids(&mut report, &schema.properties, &base_ref);
    }

    for (index, server) in contract.servers.iter().enumerate() {
        validate_optional_stable_id(&mut report, &server.id, &format!("servers[{index}].id"));
    }

    for (index, role) in contract.roles.iter().enumerate() {
        validate_optional_stable_id(&mut report, &role.id, &format!("roles[{index}].id"));
    }

    for (index, sla) in contract.sla_properties.iter().enumerate() {
        validate_optional_stable_id(&mut report, &sla.id, &format!("slaProperties[{index}].id"));
    }

    if let Some(team) = &contract.team {
        validate_team_ids(&mut report, team);
    }

    report
}

fn validate_team_ids(report: &mut DiagnosticReport, team: &TeamDeclaration) {
    match team {
        TeamDeclaration::Team(team) => {
            validate_optional_stable_id(report, &team.id, "team.id");
            for (index, member) in team.members.iter().enumerate() {
                validate_optional_stable_id(
                    report,
                    &member.id,
                    &format!("team.members[{index}].id"),
                );
            }
        }
        TeamDeclaration::LegacyMembers(members) => {
            for (index, member) in members.iter().enumerate() {
                validate_optional_stable_id(report, &member.id, &format!("team[{index}].id"));
            }
        }
    }
}

fn validate_property_ids(report: &mut DiagnosticReport, properties: &[SchemaProperty], base: &str) {
    for (index, property) in properties.iter().enumerate() {
        let prop_ref = format!("{base}.properties[{index}]");
        validate_optional_stable_id(report, &property.element.id, &format!("{prop_ref}.id"));
        if !property.properties.is_empty() {
            validate_property_ids(report, &property.properties, &prop_ref);
        }
        if let Some(items) = &property.items {
            validate_property_ids(
                report,
                std::slice::from_ref(items),
                &format!("{prop_ref}.items"),
            );
        }
    }
}