استراتيجيات جعل الدوال الداخلية في Kotlin مرئية لوحدات الاختبار

باستمرارية تطور لغات البرمجة وظهور تقنيات جديدة، يعتبر لغة Kotlin واحدة من الخيارات المتقدمة والمحبوبة بين مطوري البرمجيات في الوقت الحالي. ومن بين التحديات التي قد يواجهها المطورون عند كتابة وحدات الاختبار (Unit Tests) هي كيفية جعل الدوال الداخلية (internal functions) مرئية لوحدات الاختبار عندما تكون هذه الوحدات في وحدة منفصلة عن الشيفرة الأساسية.

إذا كانت وحدات الاختبار تقع في وحدة (module) مختلفة عن الشيفرة الأساسية (production code)، يمكن أن تكون هناك طرق مختلفة لجعل الدوال الداخلية مرئية للوحدات الاختبارية. في Java، كان من الممارسات الشائعة وضع الشيفرة الأساسية ووحدات الاختبار في نفس الحزمة (package) وجعل الدوال التي يجب اختبارها package-private. ومع ذلك، لا يتبع Kotlin نفس المفهوم الخاص بالحزم (package-private) الذي يتبعه Java.

لتحقيق هذا الهدف في Kotlin، يمكن استخدام تعليمة “internal” لجعل الدوال والخصائص ظاهرة داخل نفس الوحدة (module)، لكن هذا لن يكون كافياً عندما تكون الوحدات الاختبارية في وحدة منفصلة.

لحل هذه المشكلة، يمكن استخدام التعليمة “@TestInternal” المتاحة في مكتبة Kotlin Test Annotations لجعل الدوال الداخلية مرئية لوحدات الاختبار. يمكن تضمين هذه التعليمة قبل الدالة أو الخاصية التي تحتاج إلى أن تكون مرئية أثناء الاختبار.

kotlinCopy code
@TestInternal
internal fun internalFunctionToBeTested() {
    // Implementation of the internal function
}

باستخدام هذا النهج، يصبح بإمكان الوحدات الاختبارية الوصول إلى الدوال الداخلية للاختبار. ومن المهم أن يتم تضمين مكتبة Kotlin Test Annotations كتابية تبعيات (dependency) في ملف البناء (build.gradle) الخاص بوحدات الاختبار.

kotlinCopy code
testImplementation("org.jetbrains.kotlin:kotlin-test-annotations-common:1.6.10")

هذا النهج يوفر توازناً بين الحفاظ على الدوال كـ internal للحفاظ على نطاق الرؤية المحدود داخل الوحدة، وفي الوقت نفسه يتيح لوحدات الاختبار الوصول الكامل لاختبار تلك الدوال.

التحدي الذي يطرأ عند العمل مع الوحدات الاختبارية في Kotlin يعكس التوازن بين حماية الشيفرة الأساسية وتوفير إمكانيات الاختبار الكافية. في Kotlin، يُعتبر النطاق الافتراضي للوصول هو “internal”، وهذا يعني أن الدوال والخصائص التي تُعلن كـ internal يمكن الوصول إليها داخل نفس الوحدة (module).

لتحقيق الفصل بين الشيفرة الأساسية ووحدات الاختبار في وحدات منفصلة، يمكن استخدام كلمة المرور “friend” للوحدات الاختبارية. يمكنك تحديد الوحدات الاختبارية كأصدقاء للوحدة الأساسية باستخدام كلمة المرور “@TestFriend” كمثال:

kotlinCopy code
@TestFriend
class MyClass {
    internal fun internalFunctionToBeTested() {
        // Implementation of the internal function
    }
}

باستخدام هذا النهج، يمكن للوحدات الاختبارية الوصول إلى الدوال والخصائص التي تم تعليمها بـ internal في الوحدة الأساسية. هذا يحافظ على نطاق الرؤية الداخلي للدوال للحفاظ على أمان الشيفرة الأساسية، في حين يسمح بإمكانية اختبار فعالة وشاملة لتلك الدوال.

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