Skip to content

2bndy5/mk-pass

Repository files navigation

Comprehensive Password Generator

This cross-platform compatible software will generate a password comprehensively.

rust-ci-badge cpp-ci-badge python-ci-badge node-ci-badge codecov-badge rtd-badge CHANGELOG

crates-io-badge pypi-badge npm-badge

Features

Admittedly, the word "comprehensive" is not a scientific term. In this software, the term "comprehensive" boasts the following features when generating a password:

  1. No characters are repeated (unless explicitly allowed).
  2. Ensure at least one of each type of character is present:
    • uppercase letters
    • lowercase letters
    • decimal integers (if permitted)
    • special characters (if permitted)
  3. Ensure the first character is a letter (if enabled). When enabled, the first character will be either a uppercase or lowercase alphabetical letter.

What is a "special" character?

This software uses the following set of characters to generate special characters in a password:

- . / \ : ` + & , @ $ ! _ # % ~

The space character is not actually considered a special character, but spaces are used to make the above set more readable.

Obviously, this is not an exhaustive list of all printable, non-alphanumeric characters. However, these are special characters that are widely accepted by most sign-on services.

Command Line Interface

While this software can be used as a library, a binary executable is also provided for each release.

A document generated from the rust sources details the CLI options. See the hosted CLI doc.

The following command will print the available options and their default values.

mk-pass -h