عن المشروع

GDScript Toolkit هو مجموعة أدوات مستقلة للغة GDScript، لغة البرمجة النصية المستخدمة في محرك الألعاب Godot. يتضمن محللاً يولد شجرة تحليل لأغراض التصحيح والتعليم، ومصححاً للتحليل الثابت بناءً على قواعد قابلة للتكوين، ومنسقاً يعيد تنسيق الكود وفقاً لقواعد نمط محددة مسبقاً، وآلة حاسبة لمقاييس الكود تحسب التعقيد السيكلوماتيكي للدوال والفئات. يتم التثبيت عبر pip أو pipx، مع إصدارات حزم منفصلة لـ Godot 4 (`gdtoolkit==4.*`) وGodot 3 (`gdtoolkit==3.*`). يمكن تثبيت أحدث إصدار تطويري مباشرة من مستودع Git. الأدوات الرئيسية لسطر الأوامر هي: - `gdlint`: يفحص ملفات GDScript ويبلغ عن مشاكل النمط والمشاكل المحتملة. - `gdformat`: ينسق ملفات GDScript وفقاً لقواعد نمط الأداة. يُنصح باستخدامه مع التحكم في الإصدارات بسبب احتمال فقدان البيانات. - `gdparse`: يحلل ملفات GDScript ويخرج تمثيلاً شجرياً لبنية الكود. - `gdradon`: يحسب التعقيد السيكلوماتيكي، مشابهاً لـ Radon للغة بايثون. توفر الأداة أيضاً إجراء GitHub Action لسهولة التكامل في سير عمل CI، ويمكن استخدامها كخطاف pre-commit عبر التكوين المقدم. التطوير مفتوح للمساهمات، مع طلب الرجوع إلى أو إنشاء مشكلة قبل تنفيذ التغييرات.