passgenerator

A secure password generator with a CLI utility


Keywords
password, generator
License
MIT
Install
pip install passgenerator==1.0.4

Documentation

PassGenerator

Python Build Status Issues License

PassGenerator is a secure password generator with a CLI utility. It can generate random complex or phoenetic passwords.

Table of Contents

Prerequisites

You'll need to have Python installed in order to run PassGenerator. Start by downloading and installing Python.

Note: Python 3 is recommended, however PassGenerator has been successfully tested with Python 2.6+

Installation

pip install passgenerator

Usage

PassGenerator provides the following methods:

passgenerator.generate(length=32, upper=True, lower=True, numbers=True, special=True)
passgenerator.complexpass(length=32, upper=True, lower=True, numbers=True, special=True)
passgenerator.phoenetic(number_words=4, word_list='path/to/list')

*Note: The complexpass method calls the generate method - both methods provide identical output

Sample code:

>>> import passgenerator
>>> passgenerator.generate()
'qq*6opDb45;o~;6jWy4U-A5V.*cbHp1Z'
>>> passgenerator.generate(14, numbers=False)
"N'VJXGQ'Sj)Cj-"
>>> passgenerator.phoenetic()
('calliper delaying shrunken crednerite', 'calliperdelayingshrunkencrednerite')
>>> passgenerator.phoenetic(3)
('nonsensitization psittacinite floruits', 'nonsensitizationpsittacinitefloruits')

Command Line Utility

PassGenerator includes a command line utility for generating passwords.

passgenerator --help
usage: passgenerator.py [-h] [-l] [-L] [-n] [-N] [-p] [-s] [-S] [-u] [-U]
                        [-w <word list>]
                        [length]

Generates secure random passwords

positional arguments:
  length                length of password (default is 32 characters for
                        complex and 4 words for phoenetic)

optional arguments:
  -h, --help            show this help message and exit
  -l, --lower-enable    use lower case characters
  -L, --lower-disable   don't use lower case characters
  -n, --number-enable   use number characters
  -N, --number-disable  don't use number characters
  -p, --phoenetic       create phoenetic password using English words
  -s, --special-enable  use special characters
  -S, --special-disable
                        don't use special characters
  -u, --upper-enable    use upper case characters
  -U, --upper-disable   don't use upper case characters
  -w <word list>, --word-list <word list>
                        use provided word list (plaintext format, return
                        seperated

optional argument '-w/--word-list' assumes '-p/--phoenetic'

Generating a default complex password:

passgenerator
zT0Q9tyfcAx.S2d8*pXGxen86ipSL_;E

Generating a 14 character complex password with no special characters:

passgenerator -S 14
pocUvtR0RyZ9jd

Generating a phoenetic password

passgenerator -p
taurocol pandiabolism alkalinuria enfeeblish
taurocolpandiabolismalkalinuriaenfeeblish

Generating a phoenetic password using 3 words

passgenerator -p 3
overdevotedly evanesces perceivers
overdevotedlyevanescesperceivers

License

This project is licensed under the MIT License