# استنساخ المستودع
git clone https://github.com/krishnakanthb13/password_generator.git
cd password_generator

# تثبيت التبعيات (colorama, cryptography, pyperclip, إلخ.)
pip install -r requirements.txt

# إنشاء كلمة مرور عشوائية بطول 20 حرفًا
python main.py random -l 20

# إنشاء عبارة مرور من 4 كلمات
python main.py phrase -w 4 --capitalize

# إنشاء عبارة مرور ليتسبيك
python main.py leet -w 3 -s _

# إنشاء مع تحليل الإنتروبيا
python main.py --show-entropy random -l 16

# تشغيل الوضع التفاعلي
python main.py --interactive

# استخدام ملف تعريف محدد مسبقًا (Strong)
python main.py --preset strong --show-entropy

# كلمة مرور أساسية بطول 16 حرفًا
python main.py random

# 24 حرفًا، أحرف فقط
python main.py random -l 24 --no-symbols --no-digits

# سهلة القراءة (بدون 0/O، 1/l/I)
python main.py --easy-read random -l 20

# مع الحد الأدنى من المتطلبات
python main.py random -l 16 --min-upper 2 --min-digits 2 --min-symbols 1

# الوضع المتوازن (معظمها أحرف، رموز أقل)
python main.py random -l 24 --balanced

# عبارة مرور قياسية من 4 كلمات
python main.py phrase -w 4

# مكتوبة بحرف كبير وفاصل شرطة سفلية
python main.py phrase -w 5 -s _ --capitalize

# حالة بديلة (إنتروبيا عالية)
python main.py phrase -w 4 -s . --alternate
# الإخراج: aPpLe.bAnAnA.cHeRrY.dAtE

# حروف كبيرة مع فاصل شرطة (إنتروبيا عالية)
python main.py phrase -w 4 -s . --uppercase
# الإخراج: APPLE-BANANA-CHERRY-DATE

# نسخة ليتسبيك (استبدال ذكي بنسبة 50٪)
python main.py leet -w 4 -s -
# الإخراج: 4PPl3.8@N@[email protected]

# عبارة مرور ذات سمة (باستخدام 'animals.txt')
python main.py phrase -w 4 --capitalize --wordlist data/wordlists/animals.txt
# الإخراج: Tiger-Falcon-Shark-Wolf

# 5 أجزاء كل منها 5 أحرف
python main.py license --segments 5 --segment-length 5

# 4 أجزاء كل منها 8 أحرف
python main.py license --segments 4 --segment-length 8

# سر JWT لـ HS256
python main.py jwt --bits 256

# مفتاح API بتنسيق Base64
python main.py base64 -b 32 --url-safe

# رمز UUID (v4 عشوائي)
python main.py uuid --upper

# UUID v7 (قائم على الوقت، قابل للفرز)
python main.py uuid --ver 7
# أو اختصار
python main.py uuid --v7

# UUID قصير (مشفر بـ Base58، ~22 حرفًا)
python main.py uuid --short

# إنشاء UUID v7 باستخدام الاختصار
python main.py u --v7

# إنشاء 10 UUID v4 قصيرة
python main.py uuid --v4 --short -n 10

# تحويل صوتي ناتو
python main.py phonetic --text "PassForge"
# الإخراج: Papa-Alpha-Sierra-Sierra-Foxtrot-Oscar-Romeo-Golf-Echo

# تحليل كلمة مرور موجودة
python main.py analyze "p@ssword123"

# التسجيل في السجل
python main.py --log random -l 16

# عرض آخر 10 إدخالات في السجل (افتراضي)
python main.py history

# عرض جميع إدخالات السجل (يتم فك تشفيرها فورًا)
python main.py history --all

# عرض السجل مع تنقيح كلمات المرور
python main.py history --redact

# تصدير السجل (بالتنقيح افتراضيًا)
python main.py history --export backup.json

# تصدير السجل (نص عادي - يتطلب الحذر)
python main.py history --export secrets.csv --no-redact

# إخراج JSON للبرمجة النصية
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            # مولد رقم التعريف الشخصي
│   │   ├── 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       # مولد ناتو الصوتي
│   ├── security/
│   │   ├── entropy.py        # حاسبة الإنتروبيا
│   │   ├── strength_checker.py # تكامل zxcvbn
│   │   └── vault.py          # تشفير السجل الآمن
│   ├── output/
│   │   ├── formatter.py      # إخراج ملون
│   │   ├── logger.py         # تسجيل السجل
│   │   ├── clipboard.py      # التعامل الآمن مع الحافظة
│   │   └── qrcode_gen.py     # توليد رمز QR لـ OTP
│   ├── 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