Skip to content

edrisranjbar/mypassmaker

Repository files navigation

MyPassMaker

MyPassMaker is a simple and secure password generator that can create both random passwords and memorable passphrases.

Downloads
GitHub stars

Features

  • Generate random passwords with customizable length and character sets
  • Generate memorable passphrases using a wordlist
  • Password safety evaluation
  • Command-line interface with various options
  • Save generated passwords to files (TXT, JSON, CSV)

Installation

Install the package via pip:

pip install mypassmaker

Usage

Generate Random Passwords

python -m mypassmaker [options]

Options for random password generation:

  • --length or -len: Password length (default: 8)
  • --upper_case or -u: Include uppercase letters
  • --lower_case or -l: Include lowercase letters
  • --special_char or -s: Include special characters
  • --digits or -d: Include digits
  • --count or -c: Number of passwords to generate (default: 1)
  • --output or -o: Save passwords to a file
  • --format or -f: Output format (txt, json, csv) (default: txt)

Example:

# Generate and display passwords
python -m mypassmaker --length 12 --upper_case --lower_case --special_char --digits

# Generate and save passwords to a file
python -m mypassmaker --length 16 --count 5 --output passwords.txt
python -m mypassmaker --length 16 --count 5 --output passwords.json --format json
python -m mypassmaker --length 16 --count 5 --output passwords.csv --format csv

Generate Passphrases

python -m mypassmaker --passphrase [options]

Options for passphrase generation:

  • --words or -w: Number of words in passphrase (default: 4)
  • --separator or -sep: Character to separate words (default: '-')
  • --count or -c: Number of passphrases to generate (default: 1)
  • --output or -o: Save passphrases to a file
  • --format or -f: Output format (txt, json, csv) (default: txt)

Example:

# Generate and display passphrases
python -m mypassmaker --passphrase --words 4 --separator "-"

# Generate and save passphrases to a file
python -m mypassmaker --passphrase --words 4 --count 5 --output passphrases.txt

This will generate passphrases like "correct-horse-battery-staple" using words from the built-in wordlist.

Password Safety

The tool includes a safety evaluation feature that checks:

  • Password length (>= 8)
  • Presence in common password lists
  • Use of special characters
  • Mix of uppercase and lowercase letters
  • Inclusion of numbers

License

MIT License

How to Contribute

We appreciate your interest in contributing to MyPassMaker! Here's how you can help:

  1. Fork the repository.
  2. Make your changes or add new features.
  3. Write tests to ensure your changes work as expected.
  4. Submit a Pull Request (PR) with a description of your changes.

We'll review your PR and merge it if it aligns with the project goals.

Contact Us

We'd love to hear from you! Whether you have feedback, suggestions, or questions, feel free to reach out:

Stay connected and help us make MyPassMaker even better!

About

make strong passwords

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 2

  •  
  •  

Languages