rvf-types 0.2.1

RuVector Format core types -- segment headers, enums, flags
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

//! Checksum / hash algorithm identifiers.

/// Identifies the hash algorithm used for segment content verification.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash)]
#[cfg_attr(feature = "serde", derive(serde::Serialize, serde::Deserialize))]
#[repr(u8)]
pub enum ChecksumAlgo {
    /// CRC32C (deprecated). Transparently upgraded to XXH3-128 at read time.
    Crc32c = 0,
    /// XXH3-128. Output: 16 bytes. Fast, good distribution.
    Xxh3_128 = 1,
    /// SHAKE-256 (first 128 bits). Post-quantum safe, cryptographic.
    Shake256 = 2,
    /// HMAC-SHAKE-256 (keyed, first 128 bits). Reserved for federated transfer.
    HmacShake256 = 3,
}

impl TryFrom<u8> for ChecksumAlgo {
    type Error = u8;

    fn try_from(value: u8) -> Result<Self, Self::Error> {
        match value {
            0 => Ok(Self::Crc32c),
            1 => Ok(Self::Xxh3_128),
            2 => Ok(Self::Shake256),
            3 => Ok(Self::HmacShake256),
            other => Err(other),
        }
    }
}

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

    #[test]
    fn round_trip() {
        assert_eq!(ChecksumAlgo::try_from(0), Ok(ChecksumAlgo::Crc32c));
        assert_eq!(ChecksumAlgo::try_from(1), Ok(ChecksumAlgo::Xxh3_128));
        assert_eq!(ChecksumAlgo::try_from(2), Ok(ChecksumAlgo::Shake256));
        assert_eq!(ChecksumAlgo::try_from(3), Ok(ChecksumAlgo::HmacShake256));
    }

    #[test]
    fn invalid_value() {
        assert_eq!(ChecksumAlgo::try_from(4), Err(4));
    }
}