Skip to content
Command line random password generator
Python
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
img
password_creator
.gitignore
.travis.yml
LICENSE.txt
MANIFEST.in
README.md
_config.yml
password_creator_runner.py
requirements.txt
setup.py

README.md

password-creator banner

Build Statuspython 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
# Add random numbers from 1 - 1000 to the password (at a 1:10 ratio)
$ password_creator --with_specials
# Adds random characters from {"!", "@", "#", "$", "%", "^", "&", "*", "("}
# to the password (at a 1:10 ratio)

Note that the ratio for --with_specials and --with_numbers is shared

  • 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

Contribute

PRs accepted.

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

License

MIT © Patrick Harris

You can’t perform that action at this time.