secure-types 0.5.0

Secure data types that protect sensitive data in memory via locking and zeroization.
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

//! `SecureBytesWriter`, exercised through the public API.
//!
//! The module itself is `use_os`-only, so these tests are too.

#![cfg(feature = "use_os")]

use std::io::Write;

use secure_types::{SecureBytes, SecureBytesWriter};

#[test]
fn test_writer_appends_to_secure_bytes() {
   let mut buffer = SecureBytes::new_with_capacity(8).unwrap();

   {
      let mut writer = SecureBytesWriter::new(&mut buffer);
      writer.write_all(b"hello ").unwrap();
      writer.write_all(b"world").unwrap();
      assert_eq!(writer.write(b"!").unwrap(), 1);
      writer.flush().unwrap();
   }

   buffer.unlock_slice(|bytes| assert_eq!(bytes, b"hello world!"));
}

#[test]
fn test_writer_grows_without_losing_data() {
   let mut buffer = SecureBytes::new().unwrap();

   {
      let mut writer = SecureBytesWriter::new(&mut buffer);
      // Far beyond the initial capacity, so the buffer reallocates repeatedly.
      for _ in 0..64 {
         writer.write_all(&[0xAB; 32]).unwrap();
      }
   }

   buffer.unlock_slice(|bytes| {
      assert_eq!(bytes.len(), 64 * 32);
      assert!(bytes.iter().all(|byte| *byte == 0xAB));
   });
}