Skip to main content

made_core/value_objects/artifact/
artifact_digest.rs

1use std::fmt;
2
3use serde::{Deserialize, Serialize};
4
5use crate::error::DomainError;
6
7const PREFIX: &str = "sha256:";
8const HEX_LENGTH: usize = 64;
9
10/// Canonical SHA-256 content digest, including its algorithm label.
11#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord, Hash, Serialize, Deserialize)]
12#[serde(try_from = "String", into = "String")]
13pub struct ArtifactDigest(String);
14
15impl ArtifactDigest {
16    pub fn new(raw: impl Into<String>) -> Result<Self, DomainError> {
17        let value = raw.into();
18        let Some(hex) = value.strip_prefix(PREFIX) else {
19            return Err(DomainError::InvalidCharacters {
20                field: "artifact_digest",
21            });
22        };
23        if hex.len() != HEX_LENGTH
24            || !hex
25                .bytes()
26                .all(|byte| byte.is_ascii_digit() || (b'a'..=b'f').contains(&byte))
27        {
28            return Err(DomainError::InvalidCharacters {
29                field: "artifact_digest",
30            });
31        }
32        Ok(Self(value))
33    }
34
35    #[must_use]
36    pub fn as_str(&self) -> &str {
37        &self.0
38    }
39}
40
41impl TryFrom<String> for ArtifactDigest {
42    type Error = DomainError;
43
44    fn try_from(value: String) -> Result<Self, Self::Error> {
45        Self::new(value)
46    }
47}
48
49impl From<ArtifactDigest> for String {
50    fn from(value: ArtifactDigest) -> Self {
51        value.0
52    }
53}
54
55impl fmt::Display for ArtifactDigest {
56    fn fmt(&self, formatter: &mut fmt::Formatter<'_>) -> fmt::Result {
57        formatter.write_str(&self.0)
58    }
59}