argonautica 0.2.0

//! Utility functions for generating random bytes, which can be useful for generating
//! [`SecretKey`](input/struct.SecretKey.html)s, for example.
use base64;
use rand::rngs::EntropyRng;
use rand::RngCore;

use {Error, ErrorKind};

/// A utility function for generating cryptographically-secure random bytes. A quick glance at
/// this function's source should give you a good idea of what the function is doing.
pub fn generate_random_bytes(len: u32) -> Result<Vec<u8>, Error> {
    let mut rng = EntropyRng::new();
    let mut bytes = vec![0u8; len as usize];
    rng.try_fill_bytes(&mut bytes)
        .map_err(|e| Error::new(ErrorKind::OsRngError).add_context(format!("{}", e)))?;
    Ok(bytes)
}

/// A utility function for generating a cryptographically-secure, random, base64-encoded string
/// based on
/// [standard base64 encoding](https://docs.rs/base64/0.9.1/base64/constant.STANDARD.html).
/// A quick glance at this function's source should give you a good idea of what the function
/// is doing.
pub fn generate_random_base64_encoded_string(len: u32) -> Result<String, Error> {
    let mut rng = EntropyRng::new();
    let mut bytes = vec![0u8; len as usize];
    rng.try_fill_bytes(&mut bytes)
        .map_err(|e| Error::new(ErrorKind::OsRngError).add_context(format!("{}", e)))?;
    let output = base64::encode_config(&bytes, base64::STANDARD);
    Ok(output)
}

/// A utility function for generating a cryptographically-secure, random, base64-encoded string
/// based on a custom base64 encoding (e.g. a
/// [url-safe encoding](https://docs.rs/base64/0.9.1/base64/constant.URL_SAFE.html)).
/// A quick glance at this function's source should give you a good idea of what the
/// function is doing.
pub fn generate_random_base64_encoded_string_config(
    len: u32,
    config: base64::Config,
) -> Result<String, Error> {
    let mut rng = EntropyRng::new();
    let mut bytes = vec![0u8; len as usize];
    rng.try_fill_bytes(&mut bytes)
        .map_err(|e| Error::new(ErrorKind::OsRngError).add_context(format!("{}", e)))?;
    let output = base64::encode_config(&bytes, config);
    Ok(output)
}