Command line random password generator
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
img
password_creator
.gitignore
LICENSE.txt
MANIFEST.in
README.md
password_creator_runner.py
setup.py

README.md

password-creator banner

python pypi License standard-readme compliant

Random password generation from the command line

Create random passwords using a dictionary of close to one hundred thousand English words

Table of Contents

Security

  • password_creator is entirely hosted on the client machine, no internet connection is ever used after installation.

  • All words used in passwords are randomly sampled from a set of 99172 common english words, which can be found in password_creator/stuff.py.

  • If default settings are used, there are > 1.62 * 10^14 different possibilities for the output.

  • Randomness is provided by the python random.sample function.

  • Note: This project has not been security audited. Use passwords from here at your own risk.

Background

Project inspired by the 1password random password generator.

Install

$ pip install password-creator

Usage

$ password_creator
razors-snip-horsehairs # Just an example, your passwords will be different

API

  • By default, passwords are three random words long, delimited with dashes.

  • Numbers and special characters can be added if you want them

  • The number of characters in a password can also be set.

  • All, some, one, or none of these can be changed at will:

$ password_creator --set_length x
# Sets the number of words in the password to be integer x
$ password_creator --set_delimiter c
# Sets the delimiter between the words to be string c
$ password_creator --set_chars y
# Sets the total number of characters in the password to be integer y
$ password_creator --with_numbers
# Adds a random number from 1 - 1000 to the password
$ password_creator --with_specials
# Adds a random character from {"!", "@", "#", "$", "%", "^", "&", "*", "("}
# to the password
  • Examples:
$ password_creator --set_length 6 --set_delimiter /
stumbles/almanacs/weevils/exemplified/spiffy/mortises # An example
$ password_creator --set_chars 4
flou # An example
$ password_creator --with_specials --with_numbers                                    
mooch-kinsma6%25ns-handbags # An example
  • Notes
    • Any valid integer can be used as a length or number of characters.
    • Delimiters can be any string. The last character in the full password (this will be either the delimiter or the last character of the delimiter if the delimiter is a bigger string) is striped by default as to avoid having to use recursion. This cannot currently be changed
    • Any invalid inputs will result in the default values being used.

Contribute

PRs accepted.

Small note: If editing the Readme, please conform to the standard-readme specification.

License

MIT © Patrick Harris