canic-host 0.92.0

Host-side build, install, deployment, and fleet-template library for Canic workspaces
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
120
121
122
123
124
125

use super::super::SafetyFindingV1;
use super::source::{PromotionArtifactLevelV1, PromotionReadinessStatusV1};
use serde::{Deserialize, Serialize};

///
/// RolePromotionPolicyV1
///
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
pub struct RolePromotionPolicyV1 {
    pub role: String,
    pub allowed_promotion_levels: Vec<PromotionArtifactLevelV1>,
    pub requirements: Vec<PromotionPolicyRequirementV1>,
}

///
/// PromotionPolicyRequirementV1
///
#[derive(Clone, Copy, Debug, Deserialize, Eq, Ord, PartialEq, PartialOrd, Serialize)]
pub enum PromotionPolicyRequirementV1 {
    SameSourceRevision,
    SameCargoFeatures,
    TargetConfigDigest,
    ByteIdenticalWasm,
    SealedBytes,
}

impl PromotionPolicyRequirementV1 {
    #[must_use]
    pub const fn label(self) -> &'static str {
        match self {
            Self::SameSourceRevision => "SameSourceRevision",
            Self::SameCargoFeatures => "SameCargoFeatures",
            Self::TargetConfigDigest => "TargetConfigDigest",
            Self::ByteIdenticalWasm => "ByteIdenticalWasm",
            Self::SealedBytes => "SealedBytes",
        }
    }
}

///
/// PromotionPolicyClaimV1
///
#[derive(Clone, Copy, Debug, Deserialize, Eq, Ord, PartialEq, PartialOrd, Serialize)]
pub enum PromotionPolicyClaimV1 {
    ByteIdenticalWasm,
    TargetConfigDigest,
}

impl PromotionPolicyClaimV1 {
    #[must_use]
    pub const fn label(self) -> &'static str {
        match self {
            Self::ByteIdenticalWasm => "ByteIdenticalWasm",
            Self::TargetConfigDigest => "TargetConfigDigest",
        }
    }
}

///
/// PromotionPolicyCheckV1
///
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
pub struct PromotionPolicyCheckV1 {
    pub schema_version: u32,
    pub check_id: String,
    pub promotion_policy_check_digest: String,
    pub status: PromotionReadinessStatusV1,
    pub roles: Vec<RolePromotionPolicyDecisionV1>,
    pub blockers: Vec<SafetyFindingV1>,
}

///
/// RolePromotionPolicyDecisionV1
///
#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
pub struct RolePromotionPolicyDecisionV1 {
    pub role: String,
    pub requested_promotion_level: PromotionArtifactLevelV1,
    pub allowed_promotion_levels: Vec<PromotionArtifactLevelV1>,
    pub requirements: Vec<PromotionPolicyRequirementV1>,
    pub claims: Vec<PromotionPolicyClaimV1>,
    pub level_allowed: bool,
    pub policy_satisfied: bool,
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn promotion_policy_requirement_owns_text_labels() {
        assert_eq!(
            PromotionPolicyRequirementV1::SameSourceRevision.label(),
            "SameSourceRevision"
        );
        assert_eq!(
            PromotionPolicyRequirementV1::SameCargoFeatures.label(),
            "SameCargoFeatures"
        );
        assert_eq!(
            PromotionPolicyRequirementV1::TargetConfigDigest.label(),
            "TargetConfigDigest"
        );
        assert_eq!(
            PromotionPolicyRequirementV1::ByteIdenticalWasm.label(),
            "ByteIdenticalWasm"
        );
        assert_eq!(
            PromotionPolicyRequirementV1::SealedBytes.label(),
            "SealedBytes"
        );
    }

    #[test]
    fn promotion_policy_claim_owns_text_labels() {
        assert_eq!(
            PromotionPolicyClaimV1::ByteIdenticalWasm.label(),
            "ByteIdenticalWasm"
        );
        assert_eq!(
            PromotionPolicyClaimV1::TargetConfigDigest.label(),
            "TargetConfigDigest"
        );
    }
}