stega 0.1.2

A simple tool and library to conceal and reveal UTF-8 encoded data within PNG images
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

use super::{SteganographyError, carrier::Carrier, lsb, payload::Payload};

/// Encodes a payload into a carrier by overwriting in place its least significant bits
pub fn encode(payload: &Payload, carrier: &mut Carrier) -> Result<(), SteganographyError> {
    if carrier.capacity() >= payload.length() {
        carrier
            .subpixels()
            .zip(payload.bits())
            .for_each(|(subpixel, bit)| lsb::encode(subpixel, bit));
        Ok(())
    } else {
        Err(SteganographyError::SmallCarrier)
    }
}

#[cfg(test)]
mod tests {
    use image::RgbImage;

    use super::*;

    const HASH_CHAR: char = '#';
    const SHEBANG_STR: &str = "#!";

    const HASH_CHAR_CARRIER: [u8; 27] = [
        0, 0, 0, 0, 0, 0, 1, 0, 0, 0, 1, 0, 0, 0, 1, 1, 0, 0, 0, 0, 0, 0, 1, 1, 0, 0, 0,
    ];

    #[test]
    fn encode_char_payload() {
        let rgb_image = RgbImage::from_vec(3, 3, HASH_CHAR_CARRIER.into()).unwrap();
        let mut carrier = Carrier::new(rgb_image).unwrap();
        let payload = Payload::new(&HASH_CHAR.to_string());

        let result = encode(&payload, &mut carrier);
        assert!(result.is_ok());

        let result = carrier
            .subpixels()
            .zip(&HASH_CHAR_CARRIER)
            .all(|(a, b)| a == b);
        assert!(result);
    }

    #[test]
    fn try_to_encode_into_small_carrier() {
        let rgb_image = RgbImage::new(3, 3);
        let mut carrier = Carrier::new(rgb_image).unwrap();
        let payload = Payload::new(&SHEBANG_STR.to_string());

        let result = encode(&payload, &mut carrier);
        assert!(result.is_err());

        let error = result.err().unwrap();
        assert!(matches!(error, SteganographyError::SmallCarrier));
    }
}