# Clone the repository
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# Install dependencies (colorama, cryptography, pyperclip, etc.)
pip install -r requirements.txt

# Generate a 20-character random password
python main.py random -l 20

# Generate a 4-word passphrase
python main.py phrase -w 4 --capitalize

# Generate a leetspeak passphrase
python main.py leet -w 3 -s _

# Generate with entropy analysis
python main.py --show-entropy random -l 16

# Launch interactive mode
python main.py --interactive

# Use a preset profile (Strong)
python main.py --preset strong --show-entropy

# Basic 16-character password
python main.py random

# 24-character, letters only
python main.py random -l 24 --no-symbols --no-digits

# Easy to read (no 0/O, 1/l/I)
python main.py --easy-read random -l 20

# With minimum requirements
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# Balanced mode (mostly letters, fewer symbols)
python main.py random -l 24 --balanced

# Standard 4-word passphrase
python main.py phrase -w 4

# Capitalized with underscore separator
python main.py phrase -w 5 -s _ --capitalize

# Alternate case (High Entropy)
python main.py phrase -w 4 -s . --alternate
# Output: aPpLe.bAnAnA.cHeRrY.dAtE

# Uppercase with hyphen separator (High Entropy)
python main.py phrase -w 4 -s . --uppercase
# Output: APPLE-BANANA-CHERRY-DATE

# Leetspeak version (Smart 50% substitution)
python main.py leet -w 4 -s -
# Output: 4PPl3.8@N@[email protected]

# Themed Passphrase (using 'animals.txt')
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# Output: Tiger-Falcon-Shark-Wolf

# 5 segments of 5 characters
python main.py license --segments 5 --segment-length 5

# 4 segments of 8 characters
python main.py license --segments 4 --segment-length 8

# JWT secret for HS256
python main.py jwt --bits 256

# Base64 API key
python main.py base64 -b 32 --url-safe

# UUID token (v4 Random)
python main.py uuid --upper

# UUID v7 (Time-based, sortable)
python main.py uuid --ver 7
# Or shortcut
python main.py uuid --v7

# Short UUID (Base58 encoded, ~22 chars)
python main.py uuid --short

# Generate a v7 UUID using the shortcut
python main.py u --v7

# Generate 10 short v4 UUIDs
python main.py uuid --v4 --short -n 10

# NATO Phonetic Conversion
python main.py phonetic --text "PassForge"
# Output: Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

# Analyze an existing password
python main.py analyze "p@ssword123"

# Log to history
python main.py --log random -l 16

# View last 10 history entries (default)
python main.py history

# View all history entries (decrypted on the fly)
python main.py history --all

# View history with redacted passwords
python main.py history --redact

# Export history (Redacted by default)
python main.py history --export backup.json

# Export history (Plaintext - requires caution)
python main.py history --export secrets.csv --no-redact

# JSON output for scripts
python main.py --json jwt --bits 256

password_generator/
├── main.py                 # प्रवेश बिंदु
├── requirements.txt        # निर्भरताएँ
├── src/
│   ├── __init__.py
│   ├── cli.py                # तर्क पार्सर और बैनर
│   ├── command_handler.py    # कमांड रूटिंग
│   ├── interactive.py        # इंटरैक्टिव मेनू
│   ├── generators/           # सभी पासवर्ड जनरेटर
│   │   ├── base.py           # अमूर्त बेस क्लास
│   │   ├── random_password.py # रैंडम पासवर्ड जनरेटर
│   │   ├── passphrase.py     # पासफ्रेज़ जनरेटर
│   │   ├── leetspeak.py      # लीटस्पीक जनरेटर
│   │   ├── pin.py            # PIN जनरेटर
│   │   ├── pronounceable.py  # उच्चारण योग्य पासवर्ड जनरेटर
│   │   ├── uuid_token.py     # UUID टोकन जनरेटर
│   │   ├── base64_secret.py  # Base64 सीक्रेट जनरेटर
│   │   ├── jwt_secret.py     # JWT सीक्रेट जनरेटर
│   │   ├── wifi_key.py       # WiFi कुंजी जनरेटर
│   │   ├── license_key.py    # लाइसेंस कुंजी जनरेटर
│   │   ├── recovery_codes.py # रिकवरी कोड जनरेटर
│   │   ├── otp.py            # OTP जनरेटर
│   │   ├── pattern.py        # पैटर्न जनरेटर
│   │   └── phonetic.py       # NATO फ़ोनेटिक जनरेटर
│   ├── security/
│   │   ├── entropy.py        # एंट्रॉपी कैलकुलेटर
│   │   ├── strength_checker.py # zxcvbn एकीकरण
│   │   └── vault.py          # सुरक्षित इतिहास एन्क्रिप्शन
│   ├── output/
│   │   ├── formatter.py      # रंग-कोडित आउटपुट
│   │   ├── logger.py         # इतिहास लॉगिंग
│   │   ├── clipboard.py      # सुरक्षित क्लिपबोर्ड हैंडलिंग
│   │   └── qrcode_gen.py     # OTP के लिए QR कोड जनरेशन
│   ├── config/
│   │   ├── loader.py         # YAML/JSON कॉन्फ़िग लोडर
│   │   └── presets.py        # पूर्वनिर्धारित सुरक्षा प्रोफाइल
├── data/
│   └── wordlists/            # थीम आधारित शब्द सूचियाँ (animals.txt, biology.txt, आदि)
└── tests/

# सभी परीक्षण चलाएँ
python -m pytest tests/ -v

# विशिष्ट परीक्षण क्लास चलाएँ
python -m pytest tests/test_generators.py::TestRandomPasswordGenerator -v

# कवरेज के साथ चलाएँ
python -m pytest tests/ --cov=src --cov-report=html

{
  "random": {
    "length": 20,
    "easy_read": true
  },
  "passphrase": {
    "words": 5,
    "capitalize": true
  },
  "output": {
    "show_entropy": true
  }
}

# बिल्ड स्क्रिप्ट का उपयोग करके
passforge_build.bat

# या मैन्युअल
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py

# बिल्ड स्क्रिप्ट का उपयोग करके
chmod +x passforge_build.sh
./passforge_build.sh

# या मैन्युअल
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py