عرض مقاييس تغطية الكود Coverlet في وحدة التحكم باستخدام C#

تعتبر اختبارات الكود من الخطوات الحيوية في تطوير البرمجيات، حيث تساهم في تحسين جودة الكود وضمان عمله كما هو متوقع. ومن الأدوات الشائعة التي تستخدم في هذا المجال هي Coverlet، التي تُستخدم لجمع مقاييس التغطية للكود أثناء اختبارات .NET. لكن في بعض الأحيان، قد يواجه المطورون مشكلة تتعلق بعدم عرض نتائج تغطية الكود في وحدة التحكم بعد إجراء الاختبارات. في هذا المقال، سنستعرض كيفية إخراج مقاييس تغطية كود Coverlet إلى وحدة التحكم بشكل صحيح، مما يسهل التحقق من هذه المقاييس محليًا.

بداية استخدام Coverlet

Coverlet هي مكتبة مفتوحة المصدر تدعم مختلف أنواع مشروع .NET لأغراض قياس تغطية الكود. عادة ما يستخدمها المطورون مع أدوات اختبار مثل xUnit أو NUnit. إذا كنت ترغب في إخراج مقاييس تغطية الكود من Coverlet إلى وحدة التحكم، يمكنك القيام بذلك بسهولة عبر إعدادات معينة.

الإعدادات الأساسية

للقيام بذلك، تحتاج أولاً إلى إعداد مشروعك ليقوم بجمع تغطية الكود. يمكن إضافة التهيئة المطلوبة في ملف المشروع الخاص بك، ولكن يمكن أيضًا فعل ذلك عن طريق تنفيذ أمر dotnet في سطر الأوامر.

يمكنك استخدام الأمر التالي:

dotnet test /p:CollectCoverage=true /p:ExcludeByFile="**/*Migrations/*.cs" ./src/XYZ.IAM.AssetGovernance.sln

هذا الأمر سيقوم بتشغيل اختباراتك مع جمع تغطية الكود، كما أنه يستبعد ملفات الهجرة (Migrations) من قياس التغطية، مما يساعد في ضغط حجم النتائج المعروضة.

تحليل النتائج في وحدة التحكم

ستظهر نتائج الاختبارات والتغطية في وحدة التحكم بعد تنفيذ الأمر. في حال تشغيل الأمر أعلاه، يمكنك توقع الحصول على ملخص يوضح حالة الاختبارات، مثل عدد الاختبارات الناجحة والمُفشلَة، بالإضافة إلى معلومات إضافية عن مدة التنفيذ.

في بعض الأحيان، قد لا تُظهر وحدة التحكم تفاصيل تغطية الكود كما هو متوقع. هنا يمكن استخدام خيارات إضافية لعرض النتائج بشكل يدوي. قد تستدعي بعض المكتبات إضافات مثل Coverlet.Console، مما يمكن من إخراج المزيد من التفاصيل مباشرة إلى وحدة التحكم.

طباعة معلومات تغطية الكود

لإخراج تغطية الكود بشكل واضح، يمكنك تنفيذ الأمر التالي:

dotnet test --collect:"XPlat Code Coverage"

هذا سيؤدي إلى جمع البيانات الخاصة بتغطية الكود وإصدار تقرير مناسب. يمكنك استخدام أداة مثل ReportGenerator لتحويل البيانات إلى تنسيق HTML، ولكن إذا كنت ترغب فقط في معرفة القيم بشكل سريع، فإن استخدام الأمر السابق سيساعدك كثيرًا.

لتحسين تجربة التطوير باستخدام Coverlet

من المهم أن نؤكد أنه عند استخدام Coverlet، يجب أن تكون جاهزًا للتعامل مع مجموعة من المقاييس التي يمكن أن تساعد في تحسين جودة الكود. لا تتردد في تنفيذ اختبارات متعددة لمعرفة أي الأجزاء من كودك بحاجة إلى تحسين أو إعادة كتابة. هذا سيساهم في رفع كفاءة البرمجيات التي تعمل عليها.

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

في النهاية، يُعتبر إخراج مقاييس تغطية كود Coverlet إلى وحدة التحكم من العمليات الأساسية التي تسهل على المطورين التحقق من جودة برامجهم. اتبع الخطوات المذكورة أعلاه لتحسين تجربتك في تطوير البرمجيات وأداء الكود.

تذكر أن تتأكد من مجموعة الأدوات المستخدمة وأحدث الممارسات للحصول على أفضل النتائج وأدق التفاصيل في قياس التغطية.