crypto-scanner

# التثبيت من PyPI
pip install crypto-scanner

# مسح مشروعك
crypto-scanner scan .

# إنشاء تقرير HTML تنفيذي
crypto-scanner scan . --html --output quantum-risk-report.html

pip install crypto-scanner

git clone https://github.com/mbennett-labs/crypto-scanner.git
cd crypto-scanner
pip install -e .

# مسح دليل (إخراج JSON إلى stdout)
crypto-scanner scan <directory>

# عرض أنواع الملفات المدعومة وتصنيفات المخاطر
crypto-scanner info

# عرض الإصدار
crypto-scanner --version

# مسح مع إخراج مفصل
crypto-scanner scan ./src --verbose

# حفظ تقرير JSON إلى ملف
crypto-scanner scan . --output crypto-audit.json

# إنشاء تقرير HTML ذي علامة تجارية لأصحاب المصلحة
crypto-scanner scan . --html --output quantum-assessment.html

# استبعاد أدلة محددة
crypto-scanner scan . --exclude vendor --exclude legacy

# استبعاد أنماط الملفات
crypto-scanner scan . --exclude "*.test.js" --exclude "*.spec.ts"

# دمج الخيارات
crypto-scanner scan ./backend -v --exclude node_modules -o report.json

.git, .svn, .hg          # التحكم في الإصدارات
node_modules, vendor     # تبعيات الحزم
__pycache__, .pytest_cache, .mypy_cache
.venv, venv, env         # البيئات الافتراضية
dist, build, out         # مخرجات البناء
.idea, .vscode           # أدلة IDE
site-packages, third_party

{
  "scan_directory": "/path/to/project",
  "scan_timestamp": "2026-02-06T10:30:00",
  "scanner_version": "0.1.0",
  "summary": {
    "total_files_scanned": 150,
    "total_findings": 23,
    "critical_count": 5,
    "high_count": 8,
    "medium_count": 7,
    "low_count": 3
  },
  "excluded_patterns": [".git", "node_modules", "..."],
  "findings": [
    {
      "file_path": "/path/to/auth.py",
      "line_number": 42,
      "algorithm": "RSA",
      "key_size": 2048,
      "risk_level": "critical",
      "description": "تم اكتشاف توليد مفتاح RSA",
      "recommendation": "خطط للترحيل إلى خوارزميات ما بعد الكم (ML-KEM, ML-DSA)",
      "context": "key = rsa.generate_private_key(public_exponent=65537, key_size=2048)"
    }
  ]
}

crypto-scanner scan . --html --output report.html

name: مسح الثغرات التشفيرية

on: [push, pull_request]

jobs:
  crypto-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: إعداد Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.12'

      - name: تثبيت Crypto Scanner
        run: pip install crypto-scanner

      - name: تشغيل المسح التشفيري
        run: crypto-scanner scan ./src --output crypto-report.json

      - name: التحقق من النتائج الحرجة
        run: |
          CRITICAL=$(jq '.summary.critical_count' crypto-report.json)
          if [ "$CRITICAL" -gt 0 ]; then
            echo "::error::تم العثور على $CRITICAL خوارزمية حرجة معرضة للكم!"
            jq '.findings[] | select(.risk_level == "critical")' crypto-report.json
            exit 1
          fi

      - name: رفع التقرير
        uses: actions/upload-artifact@v4
        if: always()
        with:
          name: crypto-vulnerability-report
          path: crypto-report.json

crypto-scan:
  stage: security
  image: python:3.12
  script:
    - pip install crypto-scanner
    - crypto-scanner scan . --output crypto-report.json
    - |
      CRITICAL=$(jq '.summary.critical_count' crypto-report.json)
      if [ "$CRITICAL" -gt 0 ]; then
        echo "تم اكتشاف تشفير حرج معرض للكم!"
        exit 1
      fi
  artifacts:
    reports:
      dotenv: crypto-report.json
    paths:
      - crypto-report.json
    when: always

repos:
  - repo: local
    hooks:
      - id: crypto-scanner
        name: ماسح التشفير
        entry: bash -c 'crypto-scanner scan . --output /tmp/crypto-scan.json && CRITICAL=$(jq ".summary.critical_count" /tmp/crypto-scan.json) && [ "$CRITICAL" -eq 0 ]'
        language: system
        pass_filenames: false
        always_run: true

#!/bin/bash
# crypto-check.sh - فشل إذا تم العثور على ثغرات حرجة

set -e

crypto-scanner scan . --output /tmp/crypto-report.json

CRITICAL=$(jq '.summary.critical_count' /tmp/crypto-report.json)
HIGH=$(jq '.summary.high_count' /tmp/crypto-report.json)

echo "اكتمل المسح: $CRITICAL حرجة، $HIGH عالية المخاطر"

if [ "$CRITICAL" -gt 0 ]; then
    echo "فشل: تم اكتشاف تشفير حرج معرض للكم!"
    exit 1
fi

crypto-scanner/
├── src/crypto_scanner/
│   ├── cli.py              # واجهة Typer CLI
│   ├── scanner.py          # منطق التنسيق الأساسي
│   ├── models.py           # نماذج بيانات Pydantic
│   ├── patterns.py         # 50+ نمط كشف بالتعبير النمطي
│   ├── analyzers/          # محللات أنواع الملفات
│   │   ├── base.py         # فئة أساسية مجردة
│   │   ├── source.py       # محلل الشيفرة المصدرية (14 لغة)
│   │   ├── config.py       # محلل ملفات التهيئة
│   │   └── certificate.py  # محلل شهادات X.509
│   └── reporters/          # مولدات الإخراج
│       ├── json_reporter.py
│       └── html_reporter.py
└── tests/                  # مجموعة اختبارات شاملة

git clone https://github.com/mbennett-labs/crypto-scanner.git
cd crypto-scanner
pip install -e ".[dev]"

# تشغيل جميع الاختبارات
pytest tests/ -v

# تشغيل مع التغطية
pytest tests/ -v --cov=crypto_scanner --cov-report=html