Skip to main content
This is unreleased documentation for the main (development) branch of crypto-glue.

hmac/
lib.rs

1// Overwrite intra-crate links
2//! [`Reset`]: digest::Reset
3//! [`Digest`]: digest::Digest
4//! [`FixedOutputReset`]: digest::FixedOutputReset
5//! [`Hmac`]: Hmac
6//! [`HmacReset`]: HmacReset
7//! [`SimpleHmac`]: SimpleHmac
8//! [`SimpleHmacReset`]: SimpleHmacReset
9//! [`block_api::HmacCore`]: block_api::HmacCore
10//! [`block_api::HmacResetCore`]: block_api::HmacResetCore
11
12#![no_std]
13#![doc = include_str!("../README.md")]
14#![doc(
15    html_logo_url = "https://raw.githubusercontent.com/RustCrypto/media/26acc39f/logo.svg",
16    html_favicon_url = "https://raw.githubusercontent.com/RustCrypto/media/26acc39f/logo.svg"
17)]
18#![cfg_attr(docsrs, feature(doc_cfg))]
19#![forbid(unsafe_code)]
20#![warn(missing_docs)]
21
22pub use digest::{self, KeyInit, Mac, block_api::EagerHash};
23
24/// Block-level implementation.
25pub mod block_api;
26mod simple;
27mod simple_reset;
28mod utils;
29
30pub use simple::SimpleHmac;
31pub use simple_reset::SimpleHmacReset;
32
33use core::fmt;
34use digest::block_api::{AlgorithmName, CoreProxy};
35
36digest::buffer_fixed!(
37    /// Generic HMAC instance.
38    pub struct Hmac<D: EagerHash>(block_api::HmacCore<D>);
39    impl: MacTraits KeyInit;
40);
41
42impl<D: EagerHash + AlgorithmName> AlgorithmName for Hmac<D> {
43    fn write_alg_name(f: &mut fmt::Formatter<'_>) -> fmt::Result {
44        <Self as CoreProxy>::Core::write_alg_name(f)
45    }
46}
47
48digest::buffer_fixed!(
49    /// Generic HMAC instance with reset support.
50    pub struct HmacReset<D: EagerHash>(block_api::HmacResetCore<D>);
51    impl: ResetMacTraits KeyInit;
52);
53
54impl<D: EagerHash + AlgorithmName> AlgorithmName for HmacReset<D> {
55    fn write_alg_name(f: &mut fmt::Formatter<'_>) -> fmt::Result {
56        <Self as CoreProxy>::Core::write_alg_name(f)
57    }
58}