docs(aes,des): add crate documentation and improve re-exports

Add crate-level doc comments with usage examples. Export additional
types for library users:
    - aes: Block32 (32-bit word type)
    - des: LR (Feistel round state)
This commit is contained in:
2025-12-31 00:18:24 +02:00
parent 54b3d8716d
commit dd07a1d29b
2 changed files with 29 additions and 2 deletions

View File

@@ -1,3 +1,16 @@
//! AES (Advanced Encryption Standard) implementation.
//!
//! Provides AES-128 block cipher with 128-bit keys and blocks.
//!
//! # Example
//! ```
//! use aes::Aes;
//! use cipher_core::BlockCipher;
//!
//! let cipher = Aes::new(0x2b7e1516_28aed2a6_abf71588_09cf4f3c_u128);
//! let ciphertext = cipher.encrypt(&[0u8; 16]).unwrap();
//! ```
mod aes;
mod block;
mod constants;
@@ -5,4 +18,4 @@ mod key;
mod operations;
mod sbox;
pub use {aes::Aes, block::Block128};
pub use {aes::Aes, block::Block128, block::Block32};