MockK: یہ کیا ہے، کلیدی تصورات اور نحو

MockK کیا ہے؟

MockK موک آبجیکٹ بنانے کے لیے ایک لائبریری ہے، جو Kotlin میں لکھی گئی ہے اور اس کے نحو کے لیے بہتر بنائی گئی ہے۔ یہ وہی مسائل حل کرتی ہے جو Mockito حل کرتا ہے — ٹیسٹ شدہ کوڈ کو انحصار سے الگ کرنا — لیکن یہ Kotlin کے مخصوص تعمیرات استعمال کرکے کرتی ہے: لیمبڈا، DSL، reified generics اور suspend فنکشنز۔

پورٹ کیے گئے حل پر MockK کا بنیادی فائدہ مقامی Kotlin سپورٹ ہے۔ Mockito میں، final کلاس کو موک کرنے کے لیے opt-in (mockito-inline) کی ضرورت ہوتی ہے، اور جامد طریقوں کے لیے mockStatic کی ضرورت ہوتی ہے۔ MockK ڈیفالٹ طور پر اس کی حمایت کرتا ہے، کیونکہ Kotlin کلاسیں ڈیفالٹ طور پر final ہوتی ہیں، اور اس حد کو نظرانداز کرنا لائبریری کے فن تعمیر میں شامل ہے۔

ورژن 1.13.12 (2024) ایک مستحکم ریلیز ہے جو Kotlin 2.0، K2 کمپائلر اور ملٹی پلیٹ فارم پروجیکٹس (KMP) کو سپورٹ کرتی ہے۔ MockK Kotlin/Native اور Kotlin/JS کے ساتھ بھی کام کرتا ہے، جو اسے KMP پروجیکٹس کے لیے واحد انتخاب بناتا ہے جہاں نہ تو Mockito اور نہ ہی EasyMock لاگو ہوتے ہیں۔

MockK کو Kotlin کی خصوصیات کو مدنظر رکھتے ہوئے ڈیزائن کیا گیا ہے اور کارکردگی کی قربانی کے بغیر ایک جامع اور type-safe API فراہم کرنے کے لیے زبان کی خصوصیات — reified generics، لیمبڈا کے ساتھ DSL، ان لائن فنکشنز — استعمال کرتا ہے۔

MockK کیسے کام کرتا ہے

MockK کا طریقہ کار ByteBuddy لائبریری (Mockito کی طرح) کے ذریعے بائٹ کوڈ انسٹرومینٹیشن پر مبنی ہے، لیکن اسے Kotlin دوست DSL میں لپیٹتا ہے۔ when().thenReturn() زنجیروں کے بجائے، MockK لیمبڈا بلاکس every { } اور coEvery { } استعمال کرتا ہے جو زبان کی قدرتی توسیع کی طرح نظر آتے ہیں۔ ہڈ کے نیچے، MockK لیمبڈا کے اندر کال کو روکتا ہے، ریفلیکشن کے ذریعے طریقہ اور دلائل کا تجزیہ کرتا ہے اور انہیں ریکارڈ شدہ سٹیبنگ قوانین سے ملاتا ہے۔

MockK بنیادی نحو

بلاک every { mock.method() } returns value کو “جب بھی طریقہ بلایا جائے، قدر لوٹائیں” کے طور پر پڑھا جاتا ہے۔ یہ اعلانیہ نحو Kotlin انداز کے قریب ہے اور when() میں دلیل کی ترتیب کے ساتھ الجھن کو ختم کرتا ہے۔ Kotlin کے reified generics کی بدولت، موک کی قسم کلاس کو واضح طور پر بتائے بغیر خود بخود معلوم ہو جاتی ہے۔

val repository = mockk<UserRepository>()

// Stubbing: findById(1) کی ہر کال صارف کو لوٹاتی ہے
every { repository.findById(1) } returns User("Alice")

// کال اور تصدیق
val result = repository.findById(1)
assertEquals("Alice", result.name)

ریلیکسڈ موک: کم بوائلر پلیٹ

Mockito کے برعکس، جہاں ہر طریقہ کو واضح طور پر ترتیب دینا ضروری ہے، MockK relaxed mock کو سپورٹ کرتا ہے — ایک موک جو کسی بھی طریقے کے لیے “مناسب” ڈیفالٹ اقدار لوٹاتا ہے: List کے لیے خالی فہرست، Int کے لیے 0، String کے لیے خالی سٹرنگ۔ یہ سیٹ اپ کوڈ کی مقدار کو ڈرامائی طور پر کم کرتا ہے۔

// Relaxed mock — تمام طریقے ڈیفالٹ اقدار لوٹاتے ہیں
val api = mockk<ApiService>(relaxed = true)

// سٹیبنگ کی ضرورت نہیں — خالی فہرست لوٹاتا ہے
println(api.getUsers()) // []

موک اور ریلیکسڈ موک بنانا

MockK موک آبجیکٹ بنانے کے کئی طریقے فراہم کرتا ہے: سخت موک کے لیے mockk<T>() (ہر طریقہ کو واضح طور پر ترتیب دیا جانا چاہیے)، ریلیکسڈ موک کے لیے mockk<T>(relaxed = true) اور حقیقی آبجیکٹ پر جاسوس بنانے کے لیے spyk(obj)۔

سخت اور ریلیکسڈ موک کے درمیان انتخاب سیاق و سباق پر منحصر ہے۔ سخت موک اس بات کی ضمانت دیتا ہے کہ ٹیسٹ ان طریقوں کو استعمال نہیں کرتا جن کا رویہ متعین نہیں ہے — یہ وشوسنییتا بڑھاتا ہے۔ ریلیکسڈ موک فوری ٹیسٹ پروٹو ٹائپنگ کے لیے آسان ہے جہاں تمام انحصار اہم نہیں ہوتے۔ عملی طور پر، سخت موک سے شروع کرنے اور صرف اس وقت ریلیکسڈ پر سوئچ کرنے کی سفارش کی جاتی ہے جب سٹیبنگ ٹیسٹ سے زیادہ لائنیں لے۔

Stubbing: every بلاک کے ساتھ رویے کی ترتیب

Every بلاک MockK میں مرکزی سٹیبنگ تعمیر ہے۔ لیمبڈا کے اندر، مخصوص دلائل کے ساتھ ایک طریقہ کال بیان کی جاتی ہے، اور پھر returns کے ذریعے ایک قدر لوٹائی جاتی ہے، throws کے ذریعے استثنا پھینکا جاتا ہے، یا answers کے ذریعے جواب کا حساب لگایا جاتا ہے۔

سٹیبنگ کے مختلف طریقے

MockK ٹیسٹنگ کے لیے تمام ضروری منظرناموں کو سپورٹ کرتا ہے: قدر لوٹانا، استثنا پھینکنا، دلائل کی بنیاد پر جواب کا حساب لگانا، اور ترتیب میں متعدد جوابات (کال ترتیب)۔

// قدر لوٹانا
every { repo.findById(1) } returns User("Alice")

// استثنا پھینکنا
every { repo.findById(999) } throws NotFoundException()

// متحرک جواب
every { repo.save(any()) } answers {
    val user = firstArg<User>()
    user.copy(id = 42)
}

// جوابات کی ترتیب
every { repo.findAll() } returnsMany listOf(
    listOf(User("Alice")),
    listOf(User("Bob")),
    emptyList()
)

کوریوٹینز کے لیے Verify اور coVerify

Verify MockK میں مقصد میں Mockito.verify() سے ملتا جلتا ہے، لیکن Kotlin DSL استعمال کرتا ہے: verify { mock.method() }۔ Suspend فنکشنز کے لیے coVerify { mock.suspendMethod() } استعمال ہوتا ہے، جو کوریوٹینز کے ساتھ صحیح طریقے سے کام کرتا ہے اور کسی خاص رنر کی ضرورت نہیں ہے۔

کال کی تعداد کی تصدیق

MockK وہی موڈیفائر سپورٹ کرتا ہے جو Mockito کرتا ہے: exactly(1), atLeast(2), atMost(5), wasNot(Called)。 نحو کم سے کم ہے — موڈیفائر کو verify { } میں پہلی دلیل کے طور پر پاس کیا جاتا ہے۔

// تصدیق: طریقہ بالکل 1 بار بلایا گیا
verify(exactly = 1) { repo.save(any()) }

// کال کی ترتیب کی تصدیق
verifySequence {
    repo.save(any())
    repo.flush()
}

// Suspend فنکشنز کے لیے coVerify
coVerify { api.fetchUsers() }

Slot: دلائل کو پکڑنا

دلائل کی تصدیق کے لیے slot() استعمال ہوتا ہے — ArgumentCaptor کا ایک مشابہ۔ Slot کال سے پہلے اعلان کیا جاتا ہے، every یا verify میں پاس کیا جاتا ہے، اور ٹیسٹ کے نفاذ کے بعد پکڑی گئی قدر پر مشتمل ہوتا ہے۔

val userSlot = slot<User>()

verify { repo.save(capture(userSlot)) }

assertEquals("Alice", userSlot.captured.name)

MockK تشریحات اور JUnit انضمام

MockK JUnit 5 میں ابتدا کے ذریعے موک بنانے کے لیے @MockK اور @RelaxedMockK تشریحات فراہم کرتا ہے۔ MockKExtension ہر ٹیسٹ سے پہلے خود بخود موک بناتا ہے اور بعد میں صاف کرتا ہے — MockitoExtension کی طرح، لیکن ریلیکسڈ موڈ سپورٹ کے ساتھ۔

MockKExtension کے ساتھ مثال

@InjectMockKs تشریح (یا واضح آبجیکٹ تخلیق کے ساتھ متبادل @MockK) ٹیسٹ شدہ مثال میں موک انجیکٹ کرتی ہے۔ یہ بوائلر پلیٹ کو کم کرتی ہے اور ٹیسٹ کوڈ کو صاف بناتی ہے۔

@ExtendWith(MockKExtension::class)
class UserServiceTest {

    @MockK
    lateinit var repository: UserRepository

    @InjectMockKs
    lateinit var service: UserService

    @Test
    fun `getUser returns user from repository`() {
        every { repository.findById(1) } returns User("Alice")
        assertEquals("Alice", service.getUser(1)?.name)
    }
}

MockK بمقابلہ Mockito: Kotlin کے لیے کیا منتخب کریں

انتخاب کا انحصار ٹیم کی تشکیل اور پروجیکٹ کی قسم پر ہے۔ Mockito کا ماحولیاتی نظام بڑا ہے، زیادہ مثالیں اور انضمام ہیں، لیکن MockK صاف ستھرا Kotlin نحو اور زبان کی خصوصیات کے لیے مقامی سپورٹ فراہم کرتا ہے۔ نئے Kotlin پروجیکٹس کے لیے، MockK کو زیادہ محاوراتی حل کے طور پر تجویز کیا جاتا ہے۔

خالص Kotlin پروجیکٹس کے لیے (Java کلاسز کے بغیر)، MockK افضل ہے: کم بوائلر پلیٹ، مقامی کوریوٹین سپورٹ، final کلاسز کے ساتھ کوئی حیرانی نہیں۔ ہائبرڈ پروجیکٹس یا Java پس منظر والی ٹیموں کے لیے، Mockito ایک کام کرنے والا آپشن ہے — دونوں لائبریریاں مختلف ماڈیولز کے ذریعے ایک ہی پروجیکٹ میں استعمال کی جا سکتی ہیں۔ Mockito سے MockK میں منتقلی کرتے وقت، @Mock تشریحات کو @MockK سے بدلنا اور when().thenReturn() بلاکس کو every { } فارمیٹ میں دوبارہ لکھنا کافی ہے۔