الاختبار في مسار Rust

اكتب الكود في src/lib.rs. تأتي التمارين مع ملف مبدئي في src/lib.rs يعرض لك توقيعات الكود الذي ستحتاج إلى كتابته.

في معظم التمارين، من الأفضل أن تكتب كل الكود في الملف src/lib.rs. وإذا أردت تقسيم حلك إلى عدة ملفات، فراجع الفصل الخاص بالوحدات في كتاب Rust.

تشغيل الاختبارات

لتشغيل الاختبارات، كل ما عليك فعله هو تنفيذ الأمر التالي:

$ cargo test

لا يُفعَّل افتراضيًا سوى الاختبار الأول. وبعد أن تصبح جاهزًا لاجتياز الاختبار التالي، أزل علامة ignore من الاختبار التالي (#[ignore]). ويمكنك أيضًا إزالة العلامة من كل الاختبارات دفعة واحدة إن كنت تفضّل ذلك.

لا تتردد في كتابة أقل قدر ممكن من الكود لاجتياز الاختبارات. ستُرشدك إخفاقات الاختبارات إلى ما ينبغي كتابته بعد ذلك.

ولأن Rust يفحص كل الكود في وقت الترجمة، قد تجد أن اختباراتك لن تُترجم حتى تكتب الكود المطلوب. فحتى الاختبارات التي تحمل علامة ignore تُفحص في وقت الترجمة. يمكنك تحويل الاختبارات التي لا تُترجم إلى تعليقات بوضع // في بداية كل سطر. ثم، عندما تصبح جاهزًا للعمل على ذلك الاختبار، يمكنك إزالة التعليق عنه. وتحتوي Rust أيضًا على ماكرو خاص يُسمى todo!()، يمكنك استخدامه في مسارات الكود غير المكتملة لكي يُترجم برنامجك.

استخدام المكتبات

ينبغي أن تكون قادرًا على حل معظم التمارين دون استخدام أي مكتبات خارجية. ومع ذلك، يمكنك إضافة مكتبات (يسميها مجتمع Rust crates) بتشغيل cargo add crate-name في مجلد التمرين.

لا تدعم الاختبارات التلقائية على الموقع إلا مجموعة محددة مسبقًا من crates، تجدها هنا تحت القسم [dependencies]. ولا تتردد في فتح issue أو pull request إذا أردت إضافة دعم لـ crate معيّن.