MockK: এটি কী, মূল ধারণা এবং সিনট্যাক্স

MockK কী?

MockK হল একটি লাইব্রেরি মক অবজেক্ট তৈরির জন্য, যা Kotlin-এ লেখা এবং এর সিনট্যাক্সের জন্য অপ্টিমাইজ করা। এটি Mockito-এর মতো একই সমস্যার সমাধান করে — নির্ভরতা থেকে পরীক্ষিত কোডকে আলাদা করা — কিন্তু Kotlin-নির্দিষ্ট কনস্ট্রাক্ট ব্যবহার করে: ল্যাম্বডা, DSL, reified generics এবং suspend-ফাংশন।

পোর্ট করা সমাধানের তুলনায় MockK-এর প্রধান সুবিধা হল নেটিভ Kotlin সমর্থন। Mockito-তে, ফাইনাল ক্লাস মক করতে opt-in (mockito-inline) প্রয়োজন, এবং স্ট্যাটিক মেথডের জন্য mockStatic প্রয়োজন। MockK ডিফল্টভাবে এটি সমর্থন করে, কারণ Kotlin ক্লাস ডিফল্টভাবে ফাইনাল, এবং এই সীমাবদ্ধতা বাইপাস করা লাইব্রেরির আর্কিটেকচারে তৈরি।

সংস্করণ 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)

Relaxed mock: কম বয়লারপ্লেট

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-এর জন্য কী বেছে নেবেন

পছন্দ MockK এবং Mockito-এর মধ্যে টিমের গঠন এবং প্রজেক্টের ধরনের উপর নির্ভর করে। Mockito-এর বড় ইকোসিস্টেম, বেশি উদাহরণ এবং ইন্টিগ্রেশন রয়েছে, কিন্তু MockK ক্লিনার Kotlin সিনট্যাক্স এবং ভাষা বৈশিষ্ট্যের জন্য নেটিভ সমর্থন প্রদান করে। নতুন Kotlin প্রজেক্টের জন্য, MockK আরও ইডিওম্যাটিক সমাধান হিসাবে সুপারিশ করা হয়।

বিশুদ্ধ Kotlin প্রজেক্টের জন্য (Java ক্লাস ছাড়া), MockK ভাল: কম বয়লারপ্লেট, নেটিভ কোরুটিন সমর্থন, ফাইনাল ক্লাস নিয়ে কোন চমক নেই। হাইব্রিড প্রজেক্ট বা Java ব্যাকগ্রাউন্ডের টিমের জন্য, Mockito একটি কার্যকরী বিকল্প থাকে — উভয় লাইব্রেরি বিভিন্ন মডিউলের মাধ্যমে একই প্রজেক্টে ব্যবহার করা যেতে পারে। Mockito থেকে MockK-এ মাইগ্রেট করার সময়, @Mock অ্যানোটেশন @MockK দিয়ে প্রতিস্থাপন করা এবং when().thenReturn() ব্লক every { } ফর্ম্যাটে পুনরায় লেখা যথেষ্ট।