الإرشادات

تقدم هذه الوثيقة إرشادات عند تنفيذ محلل.

عام

• حلّل كل الملفات المُسلَّمة، باستثناء ملفات tests/invalidator/editor/example/exemplar
• لا تسعَ إلى دقة 100%، وهو أمر سيكون تحقيقه شبه مستحيل. لا بأس إذا لم يتمكن المحلل من العثور على كل المشكلات أو لم يستطع استنتاج وسوم معينة.

الترجمة

إذا كانت لغتك تتطلب خطوة ترجمة، فضع هذه النقاط في الاعتبار:

• عادةً ما تسمح ترجمة الحل بدقة أعلى. على سبيل المثال، لا يُعرف النوع النهائي لأي قيمة إلا بعد الترجمة. كن على دراية بالمقايضات (مثل بطء التنفيذ واستهلاك ذاكرة أكبر).
• فكّر في الترجمة داخل الذاكرة (إن أمكن) لتحسين الأداء.

الاختبار

• احرص على وجود مجموعة اختبارات شاملة
• استخدم اختبارات ذهبية للتحقق من سلوك المحلل. ينبغي أن تستخدم هذه الاختبارات صورة Docker التي ستُنشر للتحقق من المحلل.
• فكّر في امتلاك اختبارات لكل أسلوب. أنت تريد أن يعمل المحلل جيدًا مع هذه الحلول، وسيساعد ذلك في إسناد الوسوم إلى الأساليب لاحقًا.