password_generator.py

import secrets
import random
import string


# Source: https://www.geeksforgeeks.org/generating-strong-password-using-python/
def generate_password(length: int, use_symbols: bool = False):
    ALL_CANDIDATES = string.ascii_letters + string.digits
    password = [
        secrets.choice(string.digits),
        secrets.choice(string.ascii_lowercase),
        secrets.choice(string.ascii_uppercase),
    ]

    if use_symbols:
        SYMBOLS = "@#$%=:?./|~>*()<"
        ALL_CANDIDATES += SYMBOLS
        password.append(secrets.choice(SYMBOLS))

    for _ in range(length - len(password)):
        password += secrets.choice(ALL_CANDIDATES)

    # Prevent the generated password from having a consistent pattern
    random.shuffle(password)

    return "".join(password)