nupass

Generate readable, typable passwords


License
GPL-2.0
Install
pip install nupass==1.0.0

Documentation

NuPass

Readable, typable password generator script. Because your users can't deal with pwmake.

PyPI Version Build Status Downloads Stats Release Status

NuPass provides the nupass package and a command-line script for generating temporary passwords that your users can read and type. Passwords are provided by the gen_pass() function and are in the following format:

{number}{Capitalized_word}{special_character}{Capitalized_word}{number}

For example, 4Toffee@Buttercream7.

Installation

OS X & Linux:

pip install nupass

Windows:

python -m pip install nupass

Usage example

Generate a single password:

$ nupass

Generate five passwords:

$ nupass 5

Development setup

Using NuPass in your projects:

import nupass
temp_pass = nupass.gen_pass() # returns a string containing your password

If you want to change the length of the words used in the password, you can set the parameters of gen_pass().

import nupass
temp_pass = nupass.gen_pass(min_w_len=4, max_w_len=10)
# functionally the same as nupass.genpass(4, 10)

Release History

  • 1.0.0
    • ADD: Include README as long description on PyPI.
    • CHANGE: Use native setuptools method for script installation.
  • 0.2.1
    • ADD: Word length now set by function parameters.
    • CHANGE: Fixed an issue where the wordlist wasn't being closed.
    • CHANGE: Fixed an issue with invalid command-line arguments.
  • 0.2.0
    • CHANGE: Converted to package
    • ADD: Script added to path when installed via setup.py
  • 0.1.0
    • The first proper release

Meta

Sean Callaway – @smcallaway – seancallaway@gmail.com

Distributed under the GNU GPL v2 license. See LICENSE for more information.

https://github.com/NuPass/NuPass

Contributing

  1. Fork it (https://github.com/NuPass/NuPass/fork)
  2. Create your feature branch (git checkout -b feature/fooBar)
  3. Commit your changes (git commit -am 'Add some fooBar')
  4. Push to the branch (git push origin feature/fooBar)
  5. Create a new Pull Request