philbin 1.0.1

A pure Rust AEGIS library with SIMD and runtime CPU detection
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

use std::fmt::Debug;

/// A type alias for a byte array storing a 128 bit (16 byte) authentication tag.
///
/// See also: [`AuthTag`].
pub type AuthTag128 = [u8; 16];

/// A type alias for a byte array storing a 256 bit (32 byte) authentication tag.
///
/// See also: [`AuthTag`].
pub type AuthTag256 = [u8; 32];

/// An authentication tag.
///
/// See also: [`AuthTag128`] and [`AuthTag256`] which implement this trait.
pub trait AuthTag
where
  Self: private::Sealed,           // Prevent client impls
  Self: AsMut<[u8]> + AsRef<[u8]>, // Looks, swims and quacks like a byte array
  Self: PartialEq + Debug + Default,
{
  /// The length of the `AuthTag` in bytes.
  const BYTES: usize;
}

impl AuthTag for AuthTag128 {
  const BYTES: usize = 16;
}

impl AuthTag for AuthTag256 {
  const BYTES: usize = 32;
}

mod private {
  // Prevent client implementations of AuthTag
  pub trait Sealed {}
  impl Sealed for super::AuthTag128 {}
  impl Sealed for super::AuthTag256 {}
}