Crate yapg

This crate is for generating random passphrases from characters. The heavy lifting is done by PasswordGenerator structs, which needs to be mutable because of the encapsulated underlying RNG.

Examples

let mut pwg = yapg::PasswordGenerator::from("ab").length(10);
let pass = pwg.generate();
assert_eq!(pass.len(), 10);
assert_eq!(pass.to_ascii_lowercase(), pass);
assert_eq!(pwg.entropy(), 10);

let pass_vec = pwg.length(2).generate_n(2);
assert_eq!(pass_vec.len(), 2);
let permutations = vec![
    "aa".to_string(),
    "ab".to_string(),
    "ba".to_string(),
    "bb".to_string(),
];
assert!(permutations.contains(&pass_vec[0]));
assert!(permutations.contains(&pass_vec[1]));

Future ideas

• creating passphrases from syllables or words

Structs

CharsetSpec

Represents a specification for a charset

PasswordGenerator

Encapsulates RNG and set of characters. See crate documentation for more.

Enums

CharsetName

Translation layer between chars (e.g. for cli flags) and the actual character sets.

Statics

CHARSET_ALPHA_LOWER

Contains all lower-case latin letters

CHARSET_ALPHA_UPPER

Contains all upper-case latin letters.

CHARSET_DELIM

Contains ‘(’, ‘)’, ‘[’, ‘]’, ‘{’, and ‘}’.

CHARSET_MATHOPS

Contains ‘+’, ‘-’, ‘*’, ‘/’, ‘=’, ‘<’, and ‘>’.

CHARSET_MISC_SPECIAL

Contains ‘#’, ‘@’, ‘$’, ‘%’, ‘&’, ‘|’, ‘\’, ‘~’, ‘^’, ‘_’, and ‘`’.

CHARSET_NUMERIC

Contains all digits.

CHARSET_PROSE

Contains ‘.’, ‘:’, ‘,’, ‘;’, ‘!’, ‘?’, ’ ’, ‘'’, and ‘“’.