Metadata-Version: 2.1
Name: hashwd
Version: 0.4.61
Summary: Quickly generate a strong, random password using common words
Home-page: https://github.com/stellarsu/hashwd
License: GPL-3.0
Keywords: password,generator,xkcd
Author: Jordan Langland
Author-email: root@gnom.me
Requires-Python: >=3.6,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Dist: argparse (>=1.4,<2.0)
Requires-Dist: pyperclip (>=1.8,<2.0)
Requires-Dist: requests (>=2.24,<3.0)
Project-URL: Repository, https://github.com/stellarsu/hashwd
Description-Content-Type: text/markdown

hashwd

Introduction
hashwd is a command-line application that generates strong, random passwords using a list of words and optional numbers and symbols. The password is generated by randomly selecting words from a dictionary file, capitalizing one of the words, and adding optional numbers and symbols at the beginning or end of the password.

Commands
generate: generates a new password using the default or custom parameters
clear: clears the OS clipboard
Arguments
-h, --help: Show the help message and exit
-d, --default: Use default values for number of words, numbers, and symbols
-w, --words: Number of words in the password (must be between 1 and 99)
-n, --numbers: Number of numbers in the password (must be between 0 and 9)
-s, --symbols: Number of symbols in the password (must be between 0 and 9)
-c, --copy: Copy the password to the clipboard
-S, --show: Print the password to the console
-P, --prompt: Prompt for number of words, numbers, and symbols
Usage
To use the script, run the following command in the terminal:

Copy code
python hashwd.py generate [-h] [-d] [-w W] [-n N] [-s S] [-c] [-S] [-P] [-C]
Generate a password with the default number of words, numbers, and symbols:
Copy code
python hashwd.py generate
Generate a password with 5 words, 2 numbers, and 3 symbols:
Copy code
python hashwd.py generate -w 5 -n 2 -s 3
Generate a password and prompt for the number of words, numbers, and symbols. Additionally, print the password to the terminal and copy it to the clipboard automatically:
Copy code
python hashwd.py -PSc
Clear the clipboard:
Copy code
python hashwd.py clear
Requirements
Python 3
pyperclip (for copying the password to the clipboard)
Note
The dictionary file is currently set to C:/hashwd/dictionary.txt. If you wish to use a different dictionary file, you can update the DICTIONARY_FILE constant in the script.

License
hashwd is released under the GNU General Public License v3.0.

Credits
hashwd was developed by Jordan Langland, 2023.
