ফুল-স্ট্যাক প্রজেক্টের জন্য CI/CD পাইপলাইন

STAGE_ORDER = ["lint", "test", "build", "deploy"]

def make_stage(stage_name, fail_stages, call_counts):
    """একটি স্টেজ ফাংশন তৈরি করে দেয়। এই ফাংশনটি আসলেই কল হলে
    call_counts[stage_name] বাড়ায় -- তাই এটি কতবার কল হয়েছে তা পরে যাচাইযোগ্য।
    fail_stages সেটে stage_name থাকলে False (ব্যর্থ), নাহলে True (সফল) রিটার্ন করে।"""
    def stage_fn():
        call_counts[stage_name] += 1
        return stage_name not in fail_stages
    return stage_fn

def run_pipeline(fail_stages):
    """STAGE_ORDER অনুযায়ী প্রতিটি স্টেজ ক্রমানুসারে চালায়। কোনো স্টেজ ব্যর্থ হলে
    সাথে সাথে থেমে যায় -- পরের স্টেজগুলোর ফাংশন একবারও কল করা হয় না, শুধু
    ফলাফলে "SKIPPED" হিসেবে চিহ্নিত করা হয়। রিটার্ন করে: (results, call_counts, failed_at)।"""
    call_counts = {name: 0 for name in STAGE_ORDER}
    stages = {name: make_stage(name, fail_stages, call_counts) for name in STAGE_ORDER}

    results = {}
    failed_at = None
    for name in STAGE_ORDER:
        if failed_at is not None:
            results[name] = "SKIPPED"
            continue                      # এই স্টেজের ফাংশন কখনো কল করা হচ্ছে না
        succeeded = stages[name]()
        results[name] = "SUCCESS" if succeeded else "FAILED"
        if not succeeded:
            failed_at = name

    return results, call_counts, failed_at

def print_report(label, fail_stages):
    results, call_counts, failed_at = run_pipeline(fail_stages)
    print(f"=== {label} ===")
    for name in STAGE_ORDER:
        print(f"  {name:8s} -> {results[name]:8s}  (call_count={call_counts[name]})")
    if failed_at is None:
        print("  ফলাফল: পাইপলাইন সবুজ -- সব ৪টি স্টেজ সফল হয়েছে\n")
    else:
        print(f"  ফলাফল: '{failed_at}' স্টেজে ব্যর্থতার কারণে থেমে গেছে -- পরের স্টেজগুলো কখনো চালানো হয়নি\n")
    return call_counts

# পরিস্থিতি ১ -- সব স্টেজ সফল
print_report("রান ১ -- সব স্টেজ পাস", fail_stages=set())

# পরিস্থিতি ২ -- 'test' স্টেজে ইচ্ছাকৃতভাবে ব্যর্থতা ইনজেক্ট করা হলো
call_counts_run2 = print_report("রান ২ -- 'test' স্টেজে ইনজেক্টেড ব্যর্থতা", fail_stages={"test"})

# --- যাচাই: skip করা 'build' ও 'deploy' স্টেজের ফাংশন সত্যিই কখনো কল হয়নি ---
assert call_counts_run2["build"] == 0, "build স্টেজ ভুলবশত কল হয়ে গেছে!"
assert call_counts_run2["deploy"] == 0, "deploy স্টেজ ভুলবশত কল হয়ে গেছে!"
print(
    f"যাচাই সফল: রান ২-এ build এর call_count={call_counts_run2['build']}, "
    f"deploy এর call_count={call_counts_run2['deploy']} -- অর্থাৎ এই দুটো ফাংশন "
    f"সত্যিই একবারও চালানো হয়নি, শুধু 'SKIPPED' হিসেবে দেখানো হয়েছে।"
)