rops 0.1.7

SOPS-like library in pure Rust
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

use derive_more::{AsMut, AsRef};
use generic_array::{
    typenum::{Unsigned, U32},
    GenericArray,
};
use zeroize::Zeroize;

use crate::*;

type DataKeySize = U32;

#[derive(Debug, PartialEq, AsRef, AsMut)]
#[as_ref(forward)]
#[as_mut(forward)]
pub struct DataKey(RngKey<DataKeySize>);

impl Drop for DataKey {
    fn drop(&mut self) {
        self.0 .0.zeroize()
    }
}

impl DataKey {
    pub const fn byte_size() -> usize {
        DataKeySize::USIZE
    }

    #[allow(clippy::new_without_default)]
    pub fn new() -> Self {
        DataKey(RngKey::new())
    }

    pub fn empty() -> Self {
        Self(RngKey::empty())
    }
}

#[derive(Debug, thiserror::Error)]
#[error("Invalid data key size, expected {0}, got {1}")]
pub struct DataKeySizeError(usize, usize);

impl TryFrom<Vec<u8>> for DataKey {
    type Error = DataKeySizeError;

    fn try_from(vec: Vec<u8>) -> Result<Self, Self::Error> {
        if vec.len() != DataKey::byte_size() {
            return Err(DataKeySizeError(DataKey::byte_size(), vec.len()));
        }

        GenericArray::from_exact_iter(vec)
            .map(|array| Ok(Self(RngKey(array))))
            .expect("invalid data key size assertion")
    }
}

#[cfg(feature = "test-utils")]
mod mock {
    use generic_array::GenericArray;

    use crate::*;

    impl MockTestUtil for DataKey {
        fn mock() -> Self {
            Self(RngKey(GenericArray::from([
                254, 79, 93, 103, 195, 165, 169, 238, 35, 187, 236, 95, 222, 243, 40, 26, 130, 128, 59, 176, 15, 195, 55, 93, 129, 212, 57,
                80, 15, 181, 72, 114,
            ])))
        }
    }
}