ic-memory 0.60.2

Durable stable-memory allocation governance for Internet Computer canisters
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

//! Consumer selection over the canonical shared release-group policy.
use super::*;

pub(super) const GROUP_POLICY: &str = "ci/cargo-release-groups.json";

///
/// ReleaseGroup
///
/// Consumer metadata selected from the canonical Shared group policy.
///

#[derive(Clone, Debug, Deserialize)]
#[serde(deny_unknown_fields)]
pub(super) struct ReleaseGroup {
    pub name: String,
    pub primary: String,
    pub version: String,
    pub members: Vec<String>,
    pub changelog: String,
    pub dependencies: Vec<String>,
    #[serde(default)]
    pub metadata_files: Vec<String>,
}

#[derive(Deserialize)]
#[serde(deny_unknown_fields)]
struct ReleaseGroups {
    schema: u32,
    groups: Vec<ReleaseGroup>,
}

impl<E: Execute> Repository<E> {
    pub(super) fn release_groups(&self, revision: Option<&str>) -> Result<Vec<ReleaseGroup>> {
        let policy: ReleaseGroups = serde_json::from_str(&self.text(GROUP_POLICY, revision)?)?;
        require(policy.schema == 1, "unsupported release-group policy")?;
        for group in &policy.groups {
            let identifier = |s: &str| {
                !s.is_empty()
                    && s.bytes()
                        .all(|b| b.is_ascii_alphanumeric() || b"_-".contains(&b))
            };
            let relative = |s: &str| {
                !s.is_empty()
                    && !s.bytes().any(|b| b.is_ascii_control())
                    && Path::new(s)
                        .components()
                        .all(|c| matches!(c, std::path::Component::Normal(_)))
            };
            require(
                identifier(&group.name)
                    && identifier(&group.primary)
                    && group.members.iter().all(|name| identifier(name))
                    && group.members.contains(&group.primary)
                    && group.version == "package"
                    && relative(&group.changelog)
                    && group.metadata_files.iter().all(|path| relative(path)),
                "invalid consumer release group",
            )?;
        }
        Ok(policy.groups)
    }

    pub(super) fn release_group(&self, revision: Option<&str>) -> Result<ReleaseGroup> {
        require(!self.group.is_empty(), "select RELEASE_GROUP explicitly")?;
        self.release_groups(revision)?
            .into_iter()
            .find(|group| group.name == self.group)
            .ok_or_else(|| "unknown selected release group".into())
    }

    pub(super) fn release_files(&self, revision: Option<&str>) -> Result<Vec<String>> {
        let group = self.release_group(revision)?;
        let mut paths = vec![
            "Cargo.toml".to_owned(),
            "Cargo.lock".to_owned(),
            group.changelog,
        ];
        paths.extend(group.members.iter().map(|name| package_manifest(name)));
        paths.extend(group.metadata_files);
        Ok(paths)
    }

    pub(super) fn selected_packages(&self) -> Result<Vec<String>> {
        Ok(self.release_group(None)?.members)
    }

    pub(super) fn check_lock_update(
        &self,
        before: &[u8],
        after: &str,
        previous: &str,
        version: &str,
    ) -> Result<()> {
        let group = self.release_group(None)?;
        verify_workspace_release_projection(
            std::str::from_utf8(before)?,
            after,
            &group
                .members
                .iter()
                .map(|package| WorkspaceVersionProjection {
                    package,
                    previous,
                    next: version,
                })
                .collect::<Vec<_>>(),
        )?;
        Ok(())
    }
}