passGen

This Python script generates random passwords based on user-defined criteria, providing a flexible and interactive way to create secure passwords you can run it interactively by just running it or supply arguments. If no arguments are supplied it will run in interactive mode.

passGen

Features

Password Length Customization: Choose the desired length of the generated passwords.
Character Set Control: Control the inclusion of uppercase letters, lowercase letters, digits, and symbols in the passwords.
Exclusion of Ambiguous Characters: Improve readability by excluding ambiguous characters.
Password Saving: Save generated passwords to a file for easy access.
Password Strength Checking: Check password strength based on length, character types, and repeating patterns.
Interactive User Prompts: Easily customize password generation options through interactive prompts.
Argument User Prompts: Easily customize password generation options using arguments.
Custom Character Set: Now you can provide a custom character set to be included in password generation.

Installation

To use the Password Generator, you'll need to have Python installed on your system. Download and install Python from python.org.

Once Python is installed, follow these steps:

Clone the repository to your local machine:

git clone https://github.com/0rgis/passGen.git

Change into the project directory:
```
cd passGen
```
Run the script:
```
python passGen.py
```

You can also choose to run the script within a virtual environment to manage dependencies and ensure isolation from your system's Python installation.

Installing and Running in a Virtual Environment

Create a new directory for your project:

mkdir passGen_project
cd passGen_project

Create a virtual environment within the project directory:
```
python3 -m venv venv
```
Activate the virtual environment:

On macOS and Linux:
```
source venv/bin/activate
```
On Windows:
```
venv\Scripts\activate
```
Your terminal prompt should now indicate that you are working within the virtual environment.
Clone the passGen repository into the project directory:
```
git clone https://github.com/0rgis/passGen.git
```
Change into the passGen directory:
```
cd passGen
```
You can now run the passGen script as usual:
```
python passGen.py
```
When you're finished using passGen, you can deactivate the virtual environment:
```
deactivate
```

This setup allows you to keep passGen and its dependencies isolated from other projects on your system.

Usage

Interactive Mode

The Password Generator script offers an interactive command-line interface. Follow these steps to use the script:

Open a terminal or command prompt.
Navigate to the directory where you cloned the repository:
```
cd path/to/passGen
```
Run the script:
```
python3 passGen.py
```
Enter options for password generation, such as length, minimum uppercase letters, minimum lowercase letters, minimum digits, minimum symbols, whether to include ambiguous characters, and optionally provide a custom character set.
The script will generate the specified number of passwords and save them to a file (default: passwords.txt), no need for a file extension either.
If you choose to repeat the password generation, the script will prompt you to enter the number of passwords for each run.
The generated passwords will be appended to the specified file.
Example

Command-Line Arguments

Alternatively, you can use command-line arguments to customize password generation without the need for interactive prompts, also you do not need to enter all arguments, Here's the list of available arguments:

-l, --length: Specify the length of the generated passwords.
-u, --min_uppercase: Specify the minimum number of uppercase letters.
-w, --min_lowercase: Specify the minimum number of lowercase letters.
-d, --min_digits: Specify the minimum number of digits.
-s, --min_symbols: Specify the minimum number of symbols.
-a, --ambiguous: Include ambiguous characters (use 'y' for yes, 'n' for no).
-c, --custom_set: Provide a custom character set for password generation.
-n, --num_passwords: Specify the number of passwords to generate.
-f, --file_path: Specify the file path to save passwords if no directory supplied it will be saved in the working dir (default: passwords.txt).

Example usage:

Generate 5 passwords of length 12 with at least 2 uppercase letters, 2 lowercase letters, 2 digits, and 2 symbols (including ambiguous characters) using the custom set "!@#$%", and save them to the file my_passwords.txt.

python3 passGen.py -l 12 -u 2 -w 2 -d 2 -s 2 -a -n 5 -f my_passwords.txt

Generate 3 passwords of length 16, including ambiguous characters, and save to my_passwords.txt:

python passGen.py -n 3 -l 16 -a -f my_passwords.txt

Generate 2 passwords of length 10 using a custom character set:

python passGen.py -n 2 -l 10 -c
# You will be prompted to enter the custom character set interactively

0rgis / passGen