Command Line Parsing এর Unit Test তৈরি করা

Unit Testing এর ভূমিকা

Unit testing হল একটি প্রক্রিয়া যেখানে আপনি আপনার কোডের ছোট ছোট ইউনিট বা ফাংশনগুলি পরীক্ষা করেন, যাতে নিশ্চিত করা যায় যে প্রতিটি অংশ সঠিকভাবে কাজ করছে। Command Line Parsing-এর ক্ষেত্রে, ইউনিট টেস্ট তৈরি করা গুরুত্বপূর্ণ, কারণ এটি নিশ্চিত করে যে আপনার কমান্ড লাইন অপশনগুলি সঠিকভাবে পার্স করা হচ্ছে এবং সঠিক আউটপুট প্রদান করছে। বিশেষ করে Apache Commons CLI ব্যবহার করলে, আপনার CLI অপশন এবং আর্গুমেন্টগুলির বৈধতা পরীক্ষা করা প্রয়োজন।

Apache Commons CLI এর মাধ্যমে কমান্ড লাইন অপশন পার্স করার জন্য আপনি JUnit বা অন্যান্য টেস্ট ফ্রেমওয়ার্ক ব্যবহার করে ইউনিট টেস্ট তৈরি করতে পারেন। এখানে, আমরা দেখব কিভাবে JUnit ব্যবহার করে Apache Commons CLI এর কমান্ড লাইন পার্সিংয়ের জন্য ইউনিট টেস্ট তৈরি করা যায়।

1. Apache Commons CLI Parsing কোড

প্রথমে, একটি সিম্পল কমান্ড লাইন পার্সিং কোড তৈরি করি, যেটি পরে ইউনিট টেস্ট করা হবে।

import org.apache.commons.cli.*;

public class CommandLineApp {

    public static void main(String[] args) {
        // অপশন তৈরি করা
        Options options = new Options();
        options.addOption("f", "file", true, "File to process");
        options.addOption("v", "verbose", false, "Enable verbose output");

        CommandLineParser parser = new DefaultParser();
        HelpFormatter formatter = new HelpFormatter();

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);

            // --file অপশন চেক করা
            if (cmd.hasOption("f")) {
                String filePath = cmd.getOptionValue("f");
                System.out.println("File to process: " + filePath);
            }

            // --verbose অপশন চেক করা
            if (cmd.hasOption("v")) {
                System.out.println("Verbose output enabled");
            }

        } catch (ParseException e) {
            System.out.println("Parsing failed. Reason: " + e.getMessage());
            formatter.printHelp("CommandLineApp", options);
        }
    }
}

এটি একটি সিম্পল কমান্ড লাইন অ্যাপ্লিকেশন যেখানে -f এবং -v অপশন আছে। -f অপশনটি একটি ফাইল পাথ নেয় এবং -v অপশনটি ভের্বোস আউটপুট সক্ষম করে।

2. JUnit দিয়ে Unit Test তৈরি করা

এখন আমরা JUnit ব্যবহার করে উপরের কমান্ড লাইন পার্সিং কোডের জন্য টেস্ট তৈরি করব। এখানে, আমরা দুটি টেস্ট তৈরি করব:

1. -f অপশনটি সঠিকভাবে পার্স হচ্ছে কিনা পরীক্ষা করা।
2. -v অপশনটি সঠিকভাবে পার্স হচ্ছে কিনা পরীক্ষা করা।

JUnit 5 এ টেস্ট তৈরি করা

এটি করার জন্য প্রথমে আপনার pom.xml (Maven) বা build.gradle (Gradle) ফাইলে JUnit ডিপেনডেন্সি যোগ করতে হবে।

Maven ডিপেনডেন্সি:

<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-api</artifactId>
    <version>5.7.0</version>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>org.junit.jupiter</groupId>
    <artifactId>junit-jupiter-engine</artifactId>
    <version>5.7.0</version>
    <scope>test</scope>
</dependency>

Gradle ডিপেনডেন্সি:

testImplementation 'org.junit.jupiter:junit-jupiter-api:5.7.0'
testImplementation 'org.junit.jupiter:junit-jupiter-engine:5.7.0'

এখন, আমরা JUnit ব্যবহার করে Unit Test তৈরি করব:

import org.apache.commons.cli.*;
import org.junit.jupiter.api.Test;
import static org.junit.jupiter.api.Assertions.*;

public class CommandLineAppTest {

    @Test
    public void testFileOption() {
        // অপশন তৈরি
        Options options = new Options();
        options.addOption("f", "file", true, "File to process");
        options.addOption("v", "verbose", false, "Enable verbose output");

        // কাস্টম আর্গুমেন্ট
        String[] args = {"-f", "input.txt"};

        CommandLineParser parser = new DefaultParser();

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);

            // --file অপশন চেক করা
            assertTrue(cmd.hasOption("f"));
            assertEquals("input.txt", cmd.getOptionValue("f"));
        } catch (ParseException e) {
            fail("Parsing failed. Reason: " + e.getMessage());
        }
    }

    @Test
    public void testVerboseOption() {
        // অপশন তৈরি
        Options options = new Options();
        options.addOption("f", "file", true, "File to process");
        options.addOption("v", "verbose", false, "Enable verbose output");

        // কাস্টম আর্গুমেন্ট
        String[] args = {"-v"};

        CommandLineParser parser = new DefaultParser();

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);

            // --verbose অপশন চেক করা
            assertTrue(cmd.hasOption("v"));
        } catch (ParseException e) {
            fail("Parsing failed. Reason: " + e.getMessage());
        }
    }

    @Test
    public void testMissingFileArgument() {
        // অপশন তৈরি
        Options options = new Options();
        options.addOption("f", "file", true, "File to process");

        // কাস্টম আর্গুমেন্ট
        String[] args = {"-f"};

        CommandLineParser parser = new DefaultParser();

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            CommandLine cmd = parser.parse(options, args);
            fail("Expected ParseException not thrown.");
        } catch (ParseException e) {
            assertEquals("Missing argument for option: f", e.getMessage());
        }
    }

    @Test
    public void testUnknownOption() {
        // অপশন তৈরি
        Options options = new Options();
        options.addOption("f", "file", true, "File to process");

        // কাস্টম আর্গুমেন্ট
        String[] args = {"-x"};

        CommandLineParser parser = new DefaultParser();

        try {
            // কমান্ড লাইন আর্গুমেন্ট পার্স করা
            parser.parse(options, args);
            fail("Expected ParseException not thrown.");
        } catch (ParseException e) {
            assertEquals("Unrecognized option: -x", e.getMessage());
        }
    }
}

3. Unit Test এর ব্যাখ্যা

1. testFileOption(): এই টেস্টটি পরীক্ষা করে যে, -f অপশনটি সঠিকভাবে পার্স হচ্ছে কিনা এবং তার মান হিসেবে "input.txt" সেট করা হচ্ছে কিনা।
2. testVerboseOption(): এখানে, -v অপশনটি সঠিকভাবে পার্স হচ্ছে কিনা এবং এটি সক্রিয় হচ্ছে কিনা তা পরীক্ষা করা হয়।
3. testMissingFileArgument(): এই টেস্টে, যদি -f অপশন দেওয়া হয় কিন্তু তার মান না দেওয়া হয়, তাহলে ParseException হওয়া উচিত।
4. testUnknownOption(): এখানে, -x অপশনটি একটি অজানা অপশন হিসেবে পরীক্ষা করা হয়, এবং এর ফলে ParseException হওয়া উচিত।

4. JUnit টেস্ট রান করা

আপনি যদি Maven ব্যবহার করেন, তাহলে নিচের কমান্ড দিয়ে টেস্ট চালাতে পারেন:

mvn test

অথবা যদি Gradle ব্যবহার করেন, তাহলে:

gradle test

এটি সমস্ত টেস্ট চালাবে এবং প্রতিটি টেস্টের ফলাফল দেখাবে।

সারাংশ

Apache Commons CLI লাইব্রেরি ব্যবহার করে কমান্ড লাইন অপশন পার্সিংয়ের জন্য ইউনিট টেস্ট তৈরি করা গুরুত্বপূর্ণ। এটি নিশ্চিত করে যে আপনার কমান্ড লাইন আর্গুমেন্ট সঠিকভাবে পার্স হচ্ছে এবং প্রত্যাশিত ফলাফল প্রদান করছে। JUnit ব্যবহার করে আপনি সহজেই CLI অপশন পার্সিংয়ের জন্য টেস্ট তৈরি করতে পারেন, যেমন আর্গুমেন্টের উপস্থিতি পরীক্ষা করা, ত্রুটির শর্ত চেক করা, এবং অজানা অপশনগুলির জন্য সঠিক ত্রুটি বার্তা নিশ্চিত করা।