Noctyra

Noctyra هو إطار عمل قائم على AST مصمم لتحويل الشيفرات وإزالة التعتيم عنها. يوفر مسارًا معياريًا لتحليل وتبسيط شيفرة بايثون المصدرية عن طريق حل التعبيرات والمنطق المعقدين.

نظرة عامة

يهدف المشروع إلى توفير بيئة مرنة لمعالجة شجرة بناء الجملة المجردة (AST) الخاصة بلغة بايثون. باستخدام سلسلة من المحولات القابلة للربط، يمكن لـ Noctyra:

• تبسيط المنطق والشروط المتداخلة.
• حل القيم الثابتة وأنماط الترميز الشائعة.
• فك كتل التنفيذ الديناميكية إلى شيفرة قابلة للقراءة.
• تحسين وتنظيف الإنشاءات المبهمة (obfuscated constructs).

البدء

المتطلبات الأساسية

تأكد من تثبيت uv لإدارة التبعيات.

uv sync

تشغيل المسار

لمعالجة سكريبت مستهدف، استخدم الأمر التالي:

python main.py <input_file> [options]

الخيارات:

• file: مسار ملف بايثون المدخل (مطلوب).
• --output: اسم ملف الشيفرة المحولة (الافتراضي: out.py).
• --iterations: تعيين عدد ثابت من مراحل التحويل (الافتراضي: 0 للكشف التلقائي).
• --max-iterations: الحد الأقصى لمراحل التحويل في الوضع التلقائي (الافتراضي: 100).
• --debug: تفعيل التسجيل المفصل لتصحيح أخطاء التحويل (يبدو رائعًا).

التطوير

يستخدم هذا المشروع uv لإدارة التبعيات وملف Makefile للمهام الشائعة.

الإعداد

uv sync --all-extras --dev

مراقبة الجودة

قبل تقديم طلب سحب (PR) أو دفع التغييرات، تأكد من اجتياز جميع الفحوصات:

• تشغيل الاختبارات: make test
• التنسيق والتحقق من الأسلوب: make format
• التحقق من الأنواع: make typecheck

(مستخدمو Windows: تعمل هذه الأوامر تلقائيًا عبر make.bat.)

CI/CD

يتم إجراء فحوصات تلقائية عند كل دفع عبر GitHub Actions، تشمل التدقيق اللغوي باستخدام Ruff، والتحقق من الأنواع باستخدام Mypy، واختبارات الوحدة باستخدام Pytest.

إشعار أمني

يتضمن Noctyra محرك تقييم داخلي مع حدود أساسية للموارد. ومع ذلك، عند التعامل مع شيفرات غير موثوقة، يُوصى بشدة بتشغيل المسار داخل بيئة معزولة (مثل حاوية أو صندوق رمل) لمنع الآثار الجانبية المحتملة أو استنزاف الموارد.