# Clonar el repositorio
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# Instalar dependencias (colorama, cryptography, pyperclip, etc.)
pip install -r requirements.txt

# Generar una contraseña aleatoria de 20 caracteres
python main.py random -l 20

# Generar una frase de contraseña de 4 palabras
python main.py phrase -w 4 --capitalize

# Generar una frase de contraseña leetspeak
python main.py leet -w 3 -s _

# Generar con análisis de entropía
python main.py --show-entropy random -l 16

# Iniciar modo interactivo
python main.py --interactive

# Usar un perfil predefinido (Fuerte)
python main.py --preset strong --show-entropy

# Contraseña básica de 16 caracteres
python main.py random

# 24 caracteres, solo letras
python main.py random -l 24 --no-symbols --no-digits

# Fácil de leer (sin 0/O, 1/l/I)
python main.py --easy-read random -l 20

# Con requisitos mínimos
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# Modo equilibrado (mayormente letras, menos símbolos)
python main.py random -l 24 --balanced

# Frase de contraseña estándar de 4 palabras
python main.py phrase -w 4

# Capitalizada con separador de guion bajo
python main.py phrase -w 5 -s _ --capitalize

# Mayúsculas/minúsculas alternadas (Alta Entropía)
python main.py phrase -w 4 -s . --alternate
# Salida: aPpLe.bAnAnA.cHeRrY.dAtE

# Todo en mayúsculas con separador de guion (Alta Entropía)
python main.py phrase -w 4 -s . --uppercase
# Salida: APPLE-BANANA-CHERRY-DATE

# Versión leetspeak (Sustitución inteligente 50%)
python main.py leet -w 4 -s -
# Salida: 4PPl3.8@N@[email protected]

# Frase temática (usando 'animals.txt')
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# Salida: Tiger-Falcon-Shark-Wolf

# 5 segmentos de 5 caracteres
python main.py license --segments 5 --segment-length 5

# 4 segmentos de 8 caracteres
python main.py license --segments 4 --segment-length 8

# Secreto JWT para HS256
python main.py jwt --bits 256

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

# Token UUID (v4 Aleatorio)
python main.py uuid --upper

# UUID v7 (Basado en tiempo, ordenable)
python main.py uuid --ver 7
# O acceso directo
python main.py uuid --v7

# UUID corto (codificado en Base58, ~22 caracteres)
python main.py uuid --short

# Generar un UUID v7 usando el acceso directo
python main.py u --v7

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

# Conversión Fonética OTAN
python main.py phonetic --text "PassForge"
# Salida: Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

# Analizar una contraseña existente
python main.py analyze "p@ssword123"

# Registrar en el historial
python main.py --log random -l 16

# Ver las últimas 10 entradas del historial (predeterminado)
python main.py history

# Ver todas las entradas del historial (descifradas sobre la marcha)
python main.py history --all

# Ver historial con contraseñas redactadas
python main.py history --redact

# Exportar historial (Redactado por defecto)
python main.py history --export backup.json

# Exportar historial (Texto plano - requiere precaución)
python main.py history --export secrets.csv --no-redact

# Salida JSON para scripts
python main.py --json jwt --bits 256

password_generator/
├── main.py                 # Punto de entrada
├── requirements.txt        # Dependencias
├── src/
│   ├── __init__.py
│   ├── cli.py                # Analizador de argumentos y banner
│   ├── command_handler.py    # Enrutamiento de comandos
│   ├── interactive.py        # Menú interactivo
│   ├── generators/           # Todos los generadores de contraseñas
│   │   ├── base.py           # Clase base abstracta
│   │   ├── random_password.py # Generador de contraseñas aleatorias
│   │   ├── passphrase.py     # Generador de frases de contraseña
│   │   ├── leetspeak.py      # Generador de leetspeak
│   │   ├── pin.py            # Generador de PIN
│   │   ├── pronounceable.py  # Generador de contraseñas pronunciables
│   │   ├── uuid_token.py     # Generador de tokens UUID
│   │   ├── base64_secret.py  # Generador de secretos Base64
│   │   ├── jwt_secret.py     # Generador de secretos JWT
│   │   ├── wifi_key.py       # Generador de claves WiFi
│   │   ├── license_key.py    # Generador de claves de licencia
│   │   ├── recovery_codes.py # Generador de códigos de recuperación
│   │   ├── otp.py            # Generador OTP
│   │   ├── pattern.py        # Generador de patrones
│   │   └── phonetic.py       # Generador fonético OTAN
│   ├── security/
│   │   ├── entropy.py        # Calculadora de entropía
│   │   ├── strength_checker.py # Integración zxcvbn
│   │   └── vault.py          # Cifrado seguro del historial
│   ├── output/
│   │   ├── formatter.py      # Salida con códigos de colores
│   │   ├── logger.py         # Registro de historial
│   │   ├── clipboard.py      # Manejo seguro del portapapeles
│   │   └── qrcode_gen.py     # Generación de códigos QR para OTP
│   ├── config/
│   │   ├── loader.py         # Cargador de configuración YAML/JSON
│   │   └── presets.py        # Perfiles de seguridad predefinidos
├── data/
│   └── wordlists/            # Listas de palabras temáticas (animals.txt, biology.txt, etc.)
└── tests/

# Ejecutar todas las pruebas
python -m pytest tests/ -v

# Ejecutar una clase de prueba específica
python -m pytest tests/test_generators.py::TestRandomPasswordGenerator -v

# Ejecutar con cobertura
python -m pytest tests/ --cov=src --cov-report=html

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

# Usando el script de compilación
passforge_build.bat

# O manualmente
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py

# Usando el script de compilación
chmod +x passforge_build.sh
./passforge_build.sh

# O manualmente
pip install pyinstaller
pyinstaller --onefile --name passforge --console main.py