passgenerator

A secure password generator with a CLI utility


Keywords
password generator
License
MIT
Install
pip install passgenerator==1.0.3

Documentation

PassGenerator

Python Build Status Issues License

PassGenerator is a secure password generator with a CLI utility.

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 a single method:

passgenerator.generate(length=32, upper=True, lower=True, numbers=True, special=True)

Sample code:

>>> import passgenerator
>>> passgenerator.generate()
'qq*6opDb45;o~;6jWy4U-A5V.*cbHp1Z'
>>> passgenerator.generate(14, numbers=False)
"N'VJXGQ'Sj)Cj-"

Command Line Utility

PassGenerator includes a command line utility for generating passwords.

passgenerator --help
usage: passgenerator [-h] [-l] [-L] [-n] [-N] [-s] [-S] [-u] [-U] [length]

Generates secure random passwords

positional arguments:
  length                number of characters of length (default=32)

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
  -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

Generating a default password:

passgenerator
zT0Q9tyfcAx.S2d8*pXGxen86ipSL_;E

Generating a 14 character password with no special characters:

passgenerator -S 14
pocUvtR0RyZ9jd

License

This project is licensed under the MIT License