fast-floe 0.3.2

High performance, spec-compliant Fast Lightweight Online Encryption (FLOE) implementation
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
71
72
73
74
75
76
77
78
79
80
81
82

/// A compiled-in cryptographic backend: an AEAD, KDF, and RNG bundle.
///
/// When exactly one backend is compiled in, everything "just works" transparently.
///
/// When a build contains multiple providers, bind one explicitly to
/// a [`crate::Key`] with [`crate::Key::from_bytes_with_provider`] or
/// [`crate::Key::generate_with_provider`].
#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub struct Provider(ProviderKind);

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) enum ProviderKind {
    #[cfg(feature = "aws-lc-rs")]
    AwsLcRs,
    #[cfg(feature = "boring")]
    Boring,
    #[cfg(feature = "ring")]
    Ring,
    #[cfg(feature = "rustcrypto")]
    RustCrypto,
}

impl Provider {
    /// The aws-lc-rs provider.
    #[cfg(feature = "aws-lc-rs")]
    pub const AWS_LC_RS: Self = Self(ProviderKind::AwsLcRs);

    /// The `BoringSSL` provider.
    #[cfg(feature = "boring")]
    pub const BORING: Self = Self(ProviderKind::Boring);

    /// The Ring provider.
    #[cfg(feature = "ring")]
    pub const RING: Self = Self(ProviderKind::Ring);

    /// The `RustCrypto` provider.
    #[cfg(feature = "rustcrypto")]
    pub const RUSTCRYPTO: Self = Self(ProviderKind::RustCrypto);

    /// Every provider compiled into this build.
    pub const COMPILED: &'static [Self] = &[
        #[cfg(feature = "aws-lc-rs")]
        Self::AWS_LC_RS,
        #[cfg(feature = "boring")]
        Self::BORING,
        #[cfg(feature = "ring")]
        Self::RING,
        #[cfg(feature = "rustcrypto")]
        Self::RUSTCRYPTO,
    ];

    /// Returns the build's default provider when exactly one provider was compiled.
    ///
    /// Multi-provider builds deliberately have no default.
    #[must_use]
    pub const fn build_default() -> Option<Self> {
        if Self::COMPILED.len() == 1 {
            Some(Self::COMPILED[0])
        } else {
            None
        }
    }

    /// Returns this provider's stable identifier.
    #[must_use]
    pub const fn name(self) -> &'static str {
        match self.0 {
            #[cfg(feature = "aws-lc-rs")]
            ProviderKind::AwsLcRs => "aws-lc-rs",
            #[cfg(feature = "boring")]
            ProviderKind::Boring => "boring",
            #[cfg(feature = "ring")]
            ProviderKind::Ring => "ring",
            #[cfg(feature = "rustcrypto")]
            ProviderKind::RustCrypto => "rustcrypto",
        }
    }

    pub(crate) const fn kind(self) -> ProviderKind {
        self.0
    }
}