Password Generator

Description

A simple terminal-based password generator that gives you a fair bit of customisation. You can also make a passphrase with this one.

Note: The passwords shown in the screenshots below are demo examples generated by the program. Do not reuse them.

Getting Started

To get started, run project.py

Contains

Interface

Where you can call the password generators, to provide a password/passphrase for your use.

main() function

• Contains a welcome and farewell message. A while loop that gets and provides your password, with another prompt to end the program after generation, or to end it prematurely.

Constants

• Contains all the CONSTANTS that I've factored out to use across multiple files.

Exceptions

• QuitCommand, meant to signal that the user wants to quit the program.

• InvalidInputError, meant to signal that an input has an invalid value.
  • InvalidLengthError, meant to signal that an input has an invalid length.
  • InvalidTypeError, meant to signal that an input has an invalid type.

Password Generator

Functions grouped according to their categories.

Helper functions

• my_input() replaces the use of input() to handle quitting on command. Used to raise QuitCommand Exception.
• validate_length(): Provide simple input validation for password/passphrase length for get_valid_length().
• get_valid_length(): Gets the valid length from the user according to access_key_range.
• get_character_pool(): Asks the user for characters to include in their password and include them into the character pool.
• get_separator(): Gets a simple separator up to 3 characters in length. Defaults to "_".
• get_random_uppercase_flag(): Gets flags from the user for the Random Capitalisation feature for passphrases.
• randomly_capitalise(): Randomly capitalises each word according to get_random_uppercase_flag().

Main functions

• generate_password(): Prompts the user for features to include in their password and provides them with one.
• generate_passphrase(): Prompts the user for features to include in their passphrase and provides them with one.
• get_access_key(): Prompts the user to choose between generating a password and a passphrase.

Entry Point

• Contains main() that runs only if we are running the library itself. Right now it is the same as main() in password_generator.py.

Tests

• Contains some tests, not fully comprehensive as I do not know how to test password generation.
• Therefore it only contains length validation checks
• Uses pytest with parametrisation