Avoid Unnecessary Complexity

মাঝে মাঝে আমরা প্রোগ্রামাররা নিজেদের অজান্তেই কোডকে অযথাই জটিল (Unnecessarily Complex) করে ফেলি। এর পেছনে সাধারণত কয়েকটি কারণ থাকে—একটু "Clever" বা বুদ্ধিমান সাজার চেষ্টা, কোডকে অতিরিক্ত "Future-proof" বা ভবিষ্যতের জন্য প্রস্তুত করার প্রবণতা, অথবা শুধুমাত্র Over-engineering করার ইচ্ছা।

এর চূড়ান্ত ফলাফল কী হয়? কোডটি এমন এক গোলকধাঁধায় পরিণত হয়, যা পড়ে বোঝা যায় না, ডিবাগ করা দুঃসাধ্য হয়ে ওঠে এবং কয়েক মাস পর মেইনটেইন করা আক্ষরিক অর্থেই একটি দুঃস্বপ্নে পরিণত হয়।

অপ্রয়োজনীয় কমপ্লেক্সিটির প্রধান লক্ষণসমূহ

ক্লিন কোডের দুনিয়ায় ওভার-ইঞ্জিনিয়ারিং একটি বড় ব্যাধি। তোমার কোড জটিল হয়ে যাচ্ছে কি না, তা নিচের লক্ষণগুলো দেখে বুঝতে পারবে:

  • Clever Tricks বা কোড গলফিং: এমন লজিক ব্যবহার করা যা দেখতে খুব স্মার্ট লাগে (যেমন এক লাইনে বিশাল কাজ করা), কিন্তু অন্য কেউ পড়লে বুঝতে অনেক সময় লাগে।

  • YAGNI (You Aren't Gonna Need It) লঙ্ঘন: "ভবিষ্যতে লাগতে পারে" ভেবে অতিরিক্ত Generic বা সাধারণ সমাধান তৈরি করা, অথচ বর্তমানে যার কোনো প্রয়োজনই নেই।

  • Premature Optimization: পারফরম্যান্স ইস্যু আসার আগেই কোডকে অতিরিক্ত অপ্টিমাইজ করার চেষ্টা করা, যার ফলে রিডেবিলিটি পুরোপুরি নষ্ট হয়ে যায়।

  • Arrow Anti-pattern (Deep Nesting): if-else বা লুপের ভেতরে আরও লুপ বা কন্ডিশন দিয়ে কোডের স্ট্রাকচারকে তীরের (Arrow) মতো ডানে সরিয়ে নেওয়া।

উদাহরণসহ ব্যাখ্যা (Python Implementation)

চলো কিছু বাস্তব উদাহরণ দেখি, যেখানে কোডকে অপ্রয়োজনীয়ভাবে জটিল করা হয়েছে এবং কীভাবে তা সহজ করা যায়।

উদাহরণ ১: অতিরিক্ত জেনেরিক বানানো (YAGNI Principle)

অনেক সময় আমরা এমন ফাংশন বানাই, যা অনেক কিছু হ্যান্ডেল করতে পারে, অথচ প্রজেক্টে হয়তো তার মাত্র ১০% ব্যবহার হচ্ছে।

# Bad: Over-engineered and trying to predict the future
def operate(operation_type: str, a: float, b: float) -> float:
    if operation_type == "add":
        return a + b
    elif operation_type == "multiply":
        return a * b
    # Anticipating future needs that might never come
    elif operation_type == "divide":
        return a / b
    elif operation_type == "modulo":
        return a % b
    else:
        raise ValueError("Unknown operation")

# Good: Simple, focused, and exactly what is needed right now
def add(a: float, b: float) -> float:
    return a + b

def multiply(a: float, b: float) -> float:
    return a * b

ব্যাখ্যা: বর্তমানে তোমার শুধু যোগ আর গুণ দরকার। অযথাই operate ফাংশন বানিয়ে কমপ্লেক্সিটি বাড়ানোর কোনো মানে নেই। যখন ভাগ বা মডুলো দরকার হবে, তখন নতুন ফাংশন যোগ করে নিলেই হবে।

উদাহরণ ২: Cleverness বা এক লাইনে সব করার প্রবণতা

পাইথনে List Comprehension খুব সুন্দর একটি ফিচার, কিন্তু অতিরিক্ত কন্ডিশন জুড়ে দিলে এটি পড়ার অযোগ্য হয়ে যায়।

# Bad: Too clever, hard to read at a glance
def get_valid_numbers(data: list) -> list:
    return [x for x in data if x % 2 == 0 if x > 10 if x < 100]

# Good: Step-by-step, explicit and highly readable
def get_valid_numbers(data: list) -> list:
    valid_numbers = []
    
    for x in data:
        if x % 2 == 0 and 10 < x < 100:
            valid_numbers.append(x)
            
    return valid_numbers

ব্যাখ্যা: প্রথম কোডটি "স্মার্ট" মনে হলেও, দ্বিতীয় কোডটি যে কেউ এক পলকে বুঝতে পারবে। ক্লিন কোড সবসময় Cleverness এর চেয়ে Clarity কে প্রাধান্য দেয়।

উদাহরণ ৩: Deep Nesting (The Arrow Anti-Pattern)

একের পর এক নেস্টেড কন্ডিশন কোডের রিডেবিলিটি ধ্বংস করে দেয়।

# Bad: Deeply nested logic makes the brain stack overflow
def execute_admin_task(user) -> None:
    if user:
        if user.is_active:
            if user.has_permission('admin'):
                # Core logic deeply buried
                print("Doing admin task")

# Good: Using Guard Clauses (Return Early)
def execute_admin_task(user) -> None:
    if not user or not user.is_active or not user.has_permission('admin'):
        return

    # Core logic is flat and immediately visible
    print("Doing admin task")

ব্যাখ্যা: Guard Clause ব্যবহার করে আমরা অবাঞ্ছিত কন্ডিশনগুলোকে শুরুতেই ফিল্টার করে দিয়েছি, ফলে মূল লজিকটি কোনো ইনডেন্টেশন ছাড়াই সোজা এবং ক্লিন রয়েছে।

উদাহরণ ৪: অতিরিক্ত Abstraction এবং Magic Parameters

*args এবং **kwargs এর মতো ম্যাজিক প্যারামিটার ব্যবহার করে সবকিছুকে এক ফাংশনে ঢোকানোর চেষ্টা করা।

# Bad: God function losing type safety and readability
def execute_task(task_type: str, *args, **kwargs) -> None:
    if task_type == 'email':
        send_email(*args, **kwargs)
    elif task_type == 'log':
        log_data(*args, **kwargs)
    elif task_type == 'notify':
        notify_user(*args, **kwargs)

# Good: Distinct, predictable, and strongly typed functions
def send_email(to_address: str, message: str) -> None:
    pass

def log_data(data_payload: dict) -> None:
    pass

def notify_user(user_id: int, alert_message: str) -> None:
    pass

ব্যাখ্যা: প্রথম পদ্ধতিতে তোমার এডিটর (IDE) জানতেই পারবে না execute_task এর ভেতর কী আর্গুমেন্ট পাঠাতে হবে। আলাদা ফাংশন রাখলে টাইপ হিন্টিং এবং অটো-কমপ্লিশন ঠিকভাবে কাজ করে।

Simplicity is NOT Stupidity (সহজ মানেই বোকা নয়)

অনেকে ভাবেন কোড সহজ করে লিখলে হয়তো তাকে জুনিয়র বা অদক্ষ ভাবা হবে। এটি সম্পূর্ণ ভুল ধারণা।

"Everything should be made as simple as possible, but not simpler." — Albert Einstein

সফটওয়্যার ইঞ্জিনিয়ারিংয়ে KISS (Keep It Simple, Stupid) একটি অত্যন্ত জনপ্রিয় নীতি। এর মানে হলো—সিস্টেম যত সহজ থাকবে, তা তত ভালোভাবে কাজ করবে। সহজ কোড লেখা একজন সিনিয়র এবং দক্ষ ডেভেলপারের সবচেয়ে বড় বৈশিষ্ট্য।

তোমার কোড কি অতিরিক্ত জটিল? (Self-Check)

কোড লেখার সময় নিজেকে নিচের প্রশ্নগুলো করো। যদি কোনোটির উত্তর "হ্যাঁ" হয়, তবে কোডটি রিফ্যাক্টর করার সময় এসেছে:

  • আমি কি এমন কোনো সমস্যার সমাধান করছি, যা এখনও ঘটেইনি (Future-proofing)?

  • এই এক লাইনের কোডটি বুঝতে কি আমার নিজেরই দুইবার পড়তে হচ্ছে?

  • আমার কোডে কি ২টির বেশি নেস্টেড if বা for লুপ চলে এসেছে?

  • আমি কি *args বা **kwargs ব্যবহার করে লজিক হাইড করার চেষ্টা করছি?

  • কোডটি কি ডোমেইন লজিকের চেয়ে টেকনিক্যাল জার্গনে বেশি ভর্তি?

ক্লিন ও সিম্পল কোডের সারমর্ম (Summary)

  • Write for humans first: কোড আগে মানুষের পড়ার জন্য লেখো, তারপর মেশিনের এক্সিকিউট করার জন্য।

  • Break things down: বড় সমস্যাকে ছোট ছোট ও স্বাধীন ফাংশনে ভাগ করো।

  • Avoid unnecessary abstraction: যেখানে সরাসরি কাজ করা যায়, সেখানে অযথাই অ্যাবস্ট্রাক্ট ক্লাস বা ইন্টারফেস তৈরি করে জটিলতা বাড়িও না।

  • Return Early: নেস্টেড ব্লক কমাতে ফাংশনের শুরুতেই ভুল ইনপুটগুলো ফিল্টার করে রিটার্ন করে দাও।

  • Do the simplest thing that could possibly work: বর্তমানে তোমার যা রিকোয়ারমেন্ট, শুধু সেটুকু মেটানোর জন্য সবচেয়ে সহজ লজিকটি লেখো। অদেখা ভবিষ্যতের জন্য বর্তমানের কোডকে জটিল কোরো না।