Password-generator-V2

Password Generator Utility Manual (Expanded Version)

Overview

This utility generates passwords according to a given template and supports a CLI interface. It can work in PIPE and supports logging for detailed processing information (-vvv).

Features

Generation Based on Character Sets

1. Random Method:
   • Generates a password of a specified length from a set of characters.
2. Pattern-Based Generation:
   • Generates passwords that follow specific rules or conditions.

Defining a Character Set

• Define the character set directly in the command line argument.
• Optionally add commonly used character ranges.
• Manually specify characters using the \S option.

Supported Characters

• All Unicode characters in the ranges [U+0001, U+D7FF] and [U+E000, U+FFFF] are supported, except { U+0009 / '\t', U+000A / '\n', U+000D / '\r' }.
• Characters in the range [U+010000, U+10FFFF] are not supported.

Pattern-Based Generation

Create passwords using the following placeholders:

Placeholder	Type	Character Set
d	Digit	0123456789
l	Lower-Case Letter	abcdefghijklmnopqrstuvwxyz
L	Mixed-Case Letter	ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz
u	Upper-Case Letter	ABCDEFGHIJKLMNOPQRSTUVWXYZ
p	Punctuation	,.;:
\	Escape	Use following character as is
{n}	Repeat	Repeat the previous placeholder n times
[...]	Custom Char Set	Define a custom character set
a	Lower-Case Alphanumeric	abcdefghijklmnopqrstuvwxyz0123456789
A	Mixed-Case Alphanumeric	ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789
U	Upper-Case Alphanumeric	ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789
h	Lower-Case Hex Character	0123456789abcdef
H	Upper-Case Hex Character	0123456789ABCDEF
v	Lower-Case Vowel	aeiou
V	Mixed-Case Vowel	AEIOUaeiou
Z	Upper-Case Vowel	AEIOU
c	Lower-Case Consonant	bcdfghjklmnpqrstvwxyz
C	Mixed-Case Consonant	BCDFGHJKLMNPQRSTVWXYZbcdfghjklmnpqrstvwxyz
z	Upper-Case Consonant	BCDFGHJKLMNPQRSTVWXYZ
b	Bracket	()[]{}
s	Printable 7-Bit Special	!"#$%&'()*+,-./:;<=>?@[\]^_{
S	Printable 7-Bit ASCII	A-Z, a-z, 0-9, !"#$%&'()*+,-./:;<=>?@[\]^_{
x	Latin-1 Supplement	Range [U+00A1, U+00FF] except U+00AD
`	`	Char Set or Char Set

Examples of Patterns

• dddd generates passwords like: 41922, 12733, 43960, 07660, 12390, 74680, ...
• \H\e\x\:\ HHHHHH generates passwords like: Hex: 13567A, Hex: A6B99D, Hex: 02243C, ...

Common Password Patterns

• Hex Key - 40-Bit: H{10}
• Hex Key - 128-Bit: H{32}
• Hex Key - 256-Bit: H{64}
• MAC Address: HH\-HH\-HH\-HH\-HH\-HH

Rules for Pattern Generation

• Rule: Must consist of 10 alphanumeric characters, where at least 2 are upper-case letters and at least 2 are lower-case letters.
  • Pattern: uullA{6}
• Rule: Must consist of 9 characters of the set "ABCDEF" and an '@' symbol.
  • Pattern: \@[\A\B\C\D\E\F]{9}

CLI Commands

• -n: Set length of password and generate a random password from the set {small letter ASCII, big letter ASCII, digit}
• -t: Set template for generating passwords
• -f: Get a list of patterns from a file and generate random passwords for each
• -c: Specify the number of passwords to generate
• -vvv: Enable verbose mode (-v, -vv, -vvv)
• -h: Display help information
• -S: Define character set

Output

• The output can be redirected using pipe.

References

1. Command Line Interface:

   • argparse module — Parser for command-line options, arguments, and sub-commands
   • How to Build Command Line Interfaces in Python With argparse

2. Logging in Python:

   • Logging HOWTO
   • Advanced Logging Tutorial
   • Logging Cookbook
   • logging.config — Logging configuration
   • logging.handlers — Logging handlers
   • Python Logging Guide – Best Practices and Hands-on Examples
   • How to collect, customize, and centralize Python logs