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

use crate::{alphabets::Password, generate};

/// Generates an UTF-8 valid password with a length of 32 characters.
///
/// Only the first call to this function initializes a random number generator.
///
/// Internally, the [`Password`] set is used.
///
/// # Panics
///
/// This functions panics if the secure random number generator can not
/// be created or the generator fails.
///
/// # Example
///
/// ```
/// use mkpasswd::mkpasswd;
///
/// println!("Password 1: {}", mkpasswd());
/// println!("Password 2: {}", mkpasswd());
/// println!("Password 3: {}", mkpasswd());
///
/// assert_eq!(mkpasswd().len(), 32);
/// ```
///
/// [`Password`]: sets/constant.Password.html
pub fn mkpasswd() -> String {
    unsafe { String::from_utf8_unchecked(generate(&Password, 32).unwrap()) }
}