pwgen 0.1.3

Generate passwords
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

//! Auxiliary functions to generate passwords.
use rand::{distributions::Alphanumeric, thread_rng, Rng};

/// Returns password containing alphanumeric chars.
fn alphanum(length: u8) -> String {
    let mut rng = thread_rng();
    (0..length)
        .filter_map(|_| -> Option<char> { rng.sample(Alphanumeric).try_into().ok() })
        .collect()
}

/// Returns password containing ascii chars ranging from '0' to '9'.
/// In other words, digits.
fn pin(length: u8) -> String {
    let mut rng = thread_rng();
    (0..length)
        .filter_map(|_| -> Option<char> { rng.gen_range(b'0'..=b'9').try_into().ok() })
        .collect()
}

/// Returns password containing ascii chars ranging from '!' to '~'.
/// In other words, alphanum + symbols.
fn everything(length: u8) -> String {
    let mut rng = thread_rng();
    (0..length)
        .filter_map(|_| -> Option<char> { rng.gen_range(b'!'..=b'~').try_into().ok() })
        .collect()
}

/// Generate random passwords.
///
/// `option` sets the password type. It can be `pin`, `alpha` or `full`. `length` sets the password length.
///
/// # Examples
///
/// ```
/// use pwgen::generate;
///
/// let pw = generate("pin", 8);
///
/// assert_eq!(pw.len(), 8);
/// assert!(pw.chars().all(|ch| ch.is_ascii_digit()));
/// ```
#[inline]
#[must_use]
pub fn generate(option: &str, length: u8) -> String {
    match option {
        "pin" => pin(length),
        "full" => everything(length),
        &_ => alphanum(length),
    }
}

#[cfg(test)]
mod tests;