অটোমেশন আর CLI টুল — argparse আর ফাইলের কাজ

১ · কোন কাজ অটোমেট করবেন — বিরক্তি থেকে স্ক্রিপ্ট

আপনার বোনের বিয়ে শেষ। ফটোগ্রাফার একটি পেনড্রাইভে দিয়েছেন ৬৪০টি ছবি, নাম IMG_0001.jpg থেকে IMG_0640.jpg. আপনি চান নামগুলো হোক biye_2026_001.jpg, biye_2026_002.jpg… যাতে পরে খুঁজে পাওয়া যায়। হাতে করলে প্রতিটি ছবিতে রাইট-ক্লিক, Rename, টাইপ, Enter — ধরুন ১০ সেকেন্ড করে, মোট প্রায় পৌনে দুই ঘণ্টা। মাঝখানে একটি নম্বর বাদ পড়বে বা দুবার বসবে, প্রায় নিশ্চিত। Python-এ একটি ছোট স্ক্রিপ্ট এই কাজ করে এক সেকেন্ডেরও কম সময়ে, আর ভুল করে না।

এই পর্বের বিষয় হলো automation — কম্পিউটারে যে একঘেয়ে কাজ আপনি বারবার হাতে করেন, সেটি একটি script-কে দিয়ে করানো। অফিসে প্রতি মাসে ১২টি শাখার বিক্রির ফাইল জোড়া লাগানো, ডাউনলোড ফোল্ডারের হাজারো ফাইল সাজানো, প্রতি রাতে থিসিসের ফোল্ডারের ব্যাকআপ — এসবই একেকটি স্ক্রিপ্টের অপেক্ষায় আছে।

লাভ-ক্ষতির হিসাব: কতবার × কত সময় × ভুলের ঝুঁকি

সব কাজ অটোমেট করা লাভজনক নয়। স্ক্রিপ্ট লিখতে, পরীক্ষা করতে আর পরে ঠিক রাখতে সময় লাগে। webcomic xkcd-র বিখ্যাত ছবি “Is It Worth the Time?” (নং ১২০৫) একটি টেবিলে দেখায়: একটি কাজ কতবার করেন আর প্রতিবার কত সময় বাঁচবে, তার ভিত্তিতে পাঁচ বছরে মোট কত সময় বাঁচে — অর্থাৎ অটোমেশনে সর্বোচ্চ কত সময় দেওয়া যুক্তিসংগত। যেমন দিনে একবার করা কাজে ৫ মিনিট বাঁচলে পাঁচ বছরে বাঁচে প্রায় ৬ দিন। তিনটি প্রশ্ন জিজ্ঞেস করুন:

স্ক্রিপ্ট থেকে টুল

প্রথম সংস্করণ সাধারণত একটি দ্রুত স্ক্রিপ্ট — ফোল্ডারের নাম, prefix সব কোডের ভেতরে লেখা। নিজের জন্য একবার চালাতে এটুকুই যথেষ্ট। কিন্তু পরের মাসে আরেকটি ফোল্ডারে চালাতে কোড খুলে বদলাতে হয়, আর আপনার সহকর্মী তো কোড খুলতেই ভয় পান। তখন স্ক্রিপ্টটিকে বানাতে হয় একটি CLI টুল: কমান্ড লাইন থেকে আর্গুমেন্ট নেবে, -h দিলে নিজের ব্যবহারবিধি বলবে, ভুল ইনপুটে পরিষ্কার বার্তা দেবে, আর ডিফল্ট আচরণ হবে নিরাপদ। পর্ব ২১-এর মাঝপথের প্রজেক্টে আপনি একটি ইন্টারঅ্যাকটিভ CLI বানিয়েছিলেন, যা প্রশ্ন করে উত্তর পড়ত; এই পর্বের টুল চলবে একবারে, আর্গুমেন্ট নিয়ে — যাতে অন্য স্ক্রিপ্ট বা cron-ও তাকে চালাতে পারে।

২ · কমান্ড লাইন কীভাবে কথা বলে — argv, stdout, stderr, exit code

আপনি terminal-এ লেখেন python rename.py photos --dry-run. Shell এই লাইনটি ফাঁকা জায়গায় ভেঙে শব্দের একটি তালিকা বানায় আর Python-কে দেয়। Python সেটি রাখে sys.argv নামের list-এ: ['rename.py', 'photos', '--dry-run']. প্রথম ঘরে স্ক্রিপ্টের নাম, বাকিগুলো command-line argument — সবই str, সংখ্যা দিলেও। এটুকু আপনি আগেও দেখেছেন। একটি CLI প্রোগ্রামের সাথে বাইরের জগতের যোগাযোগের আসলে চারটি পথ:

• stdout — আসল ফল: রিপোর্ট, তালিকা, হিসাব। print() ডিফল্টে এখানেই লেখে। ব্যবহারকারী চাইলে > report.txt দিয়ে ফাইলে পাঠাতে পারেন, বা | দিয়ে আরেকটি প্রোগ্রামে।
• stderr — সতর্কতা, error, অগ্রগতির খবর: print("ফাইল পাওয়া যায়নি", file=sys.stderr). stdout ফাইলে পাঠালেও stderr পর্দায় থেকে যায় — তাই রিপোর্টের ভেতরে error-এর লেখা মিশে যায় না।
• exit code — প্রোগ্রাম শেষে OS-কে দেওয়া একটি সংখ্যা। প্রথা অনুযায়ী 0 মানে সফল, অন্য যেকোনো সংখ্যা মানে কোনো সমস্যা। Python-এ sys.exit(1). অন্য স্ক্রিপ্ট, cron বা CI এই সংখ্যা দেখেই ঠিক করে পরের ধাপ চলবে কি না। Linux/macOS-এ শেষ exit code দেখতে echo $?, Windows PowerShell-এ $LASTEXITCODE.

সরাসরি sys.argv ঘাঁটা ছোট কাজে চলে, কিন্তু দ্রুত জট পাকায়: কোন আর্গুমেন্ট বাধ্যতামূলক, কোনটি ঐচ্ছিক, --start 5-এর 5-কে int বানানো, ভুল দিলে বার্তা, -h দিলে ব্যবহারবিধি — সব নিজে লিখতে হয়। এই সব কাজ করে দেয় standard library-র argparse.

৩ · argparse — আর্গুমেন্ট, flag, type, choices আর help

argparse-এর কাজের ধারা তিন ধাপের: একটি ArgumentParser বানান, তাকে বলুন কোন কোন আর্গুমেন্ট আশা করবেন (add_argument), তারপর parse_args() ডাকুন। ফল আসে একটি Namespace object-এ, যার প্রতিটি attribute একটি আর্গুমেন্টের মান। আর্গুমেন্ট দুই জাতের:

প্রতিটি add_argument-এ কয়েকটি গুরুত্বপূর্ণ বিকল্প দেওয়া যায়: type=int — string-কে রূপান্তর করো, না পারলে পরিষ্কার error; choices=[...] — শুধু এই মানগুলোর একটি চলবে; default=... — না দিলে কী হবে; help="..." — ব্যবহারবিধিতে কী লেখা থাকবে; আর একটি ছোট নাম (-v) ও একটি লম্বা নাম (--verbose) একসাথে। লম্বা নামের মাঝের - attribute-এ হয়ে যায় _: --dry-run থেকে args.dry_run. সবচেয়ে বড় উপহার: আপনি -h বা --help নিজে লেখেন না — argparse আপনার দেওয়া help লেখা থেকে নিজেই সুন্দর help text বানায়।

নিচের কোডে বিয়ের ছবির নাম বদলানোর টুলের parser বানানো হয়েছে। খেয়াল করুন, parse_args()-কে একটি list দেওয়া হয়েছে — না দিলে সে sys.argv[1:] পড়ে। list দিলে terminal ছাড়াই, টেস্টে বা এই পাতায় parser পরীক্ষা করা যায়:

import argparse

def build_parser() -> argparse.ArgumentParser:
    p = argparse.ArgumentParser(prog="rename_photos", description="ছবির নাম একসাথে বদলায়")
    p.add_argument("folder", help="ছবির ফোল্ডার")
    p.add_argument("--prefix", default="photo", help="নতুন নামের শুরু")
    p.add_argument("--start", type=int, default=1, help="প্রথম নম্বর")
    p.add_argument("--case", choices=["lower", "upper"], default="lower")
    p.add_argument("--dry-run", action="store_true", help="শুধু দেখাও, কিছু বদলিও না")
    p.add_argument("-v", "--verbose", action="store_true")
    return p

parser = build_parser()
args = parser.parse_args(["photos", "--prefix", "biye", "--dry-run"])
print(args)
print(args.folder, args.prefix, args.start, args.dry_run)
print(type(args.start).__name__, parser.parse_args(["x", "--start", "7"]).start + 1)
parser.print_help()

terminal-এ টাইপ করা একটি লাইন কীভাবে ধাপে ধাপে Namespace হয়, আর -h দিলে কী ঘটে, দেখুন:

৪ · টুলের কাঠামো — main(), exit code আর subcommand

পর্ব ২২-এ দেখেছেন, ফাইলের শেষে if __name__ == "__main__": (main guard) থাকলে একই ফাইল সরাসরি চালানো যায়, আবার অন্য ফাইল import-ও করতে পারে। CLI টুলের জন্য এর ওপর একটি প্রচলিত কাঠামো দাঁড়িয়েছে:

1. build_parser() — শুধু parser বানায়। আলাদা রাখলে টেস্টে বা ডকুমেন্টেশনে আবার ব্যবহার করা যায়।
2. main(argv=None) -> int — আর্গুমেন্ট parse করে, কাজ করে, আর একটি exit code ফেরত দেয়। argv না দিলে argparse নিজেই sys.argv[1:] পড়ে; টেস্টে দেন একটি list.
3. শেষে if __name__ == "__main__": sys.exit(main()) — main()-এর ফেরত দেওয়া সংখ্যাটিই প্রোগ্রামের exit code.

main()-এর ভেতরে sys.exit() না ডেকে সংখ্যা ফেরত দেওয়ার সুবিধা হলো, টেস্ট সহজে লেখা যায়: assert main(["done", "9"]) == 1. প্রোগ্রাম থামে না, শুধু একটি মান আসে। এবার একটু বড় উদাহরণ — একটি ছোট্ট “todo” টুল, যার তিনটি subcommand: add, list, done. git যেমন git add, git commit — একটি টুল, অনেক কাজ, প্রতিটি কাজের নিজের আর্গুমেন্ট:

import argparse
import json
import sys
from pathlib import Path

DB = Path("todo.json")

def build_parser() -> argparse.ArgumentParser:
    parser = argparse.ArgumentParser(prog="todo", description="ছোট্ট কাজের তালিকা")
    sub = parser.add_subparsers(dest="command", required=True)
    add = sub.add_parser("add", help="নতুন কাজ যোগ করে")
    add.add_argument("text", help="কাজের বিবরণ")
    sub.add_parser("list", help="সব কাজ দেখায়")
    done = sub.add_parser("done", help="কাজ শেষ বলে চিহ্নিত করে")
    done.add_argument("number", type=int, help="কাজের নম্বর (১ থেকে)")
    return parser

def main(argv: list[str] | None = None) -> int:
    args = build_parser().parse_args(argv)
    tasks = json.loads(DB.read_text(encoding="utf-8")) if DB.exists() else []
    match args.command:
        case "add":
            tasks.append({"text": args.text, "done": False})
        case "list":
            for i, task in enumerate(tasks, start=1):
                mark = "x" if task["done"] else " "
                print(f"{i}. [{mark}] {task['text']}")
            return 0
        case "done":
            if not 1 <= args.number <= len(tasks):
                print(f"ভুল নম্বর: {args.number}", file=sys.stderr)
                return 1
            tasks[args.number - 1]["done"] = True
    DB.write_text(json.dumps(tasks, ensure_ascii=False, indent=2), encoding="utf-8")
    return 0

if __name__ == "__main__":
    sys.exit(main())

$ python todo.py add "বিদ্যুৎ বিল দেওয়া"
$ python todo.py add "থিসিসের ব্যাকআপ"
$ python todo.py done 1
$ python todo.py list
1. [x] বিদ্যুৎ বিল দেওয়া
2. [ ] থিসিসের ব্যাকআপ
$ python todo.py done 9          # ভুল নম্বর → stderr-এ বার্তা
ভুল নম্বর: 9
$ echo $?                        # Windows PowerShell-এ: $LASTEXITCODE
1
$ python todo.py done abc        # type=int ভুল ধরল, exit code 2
usage: todo done [-h] number
todo done: error: argument number: invalid int value: 'abc'

কয়েকটি জিনিস লক্ষ করুন। add_subparsers(dest="command", required=True) — কোন subcommand এসেছে তা থাকে args.command-এ, আর কিছুই না দিলে argparse error দেয়। প্রতিটি subcommand-এর নিজের help আছে: python todo.py done -h. subcommand বাছাইয়ে পর্ব ১১-এর match খুব মানানসই। বার্তা বাংলায় লিখতে ensure_ascii=False (পর্ব ২৬)। আর done 1 দুবার চালালেও ফল একই — কাজটি idempotent; কিন্তু add দুবার চালালে একই কাজ দুবার যোগ হয়। কোন কমান্ড দুবার চালানো নিরাপদ, তা ব্যবহারকারীকে জানানো ভালো টুলের লক্ষণ (অংশ ৬-এ বিস্তারিত)।

৫ · ফাইলের অটোমেশন — pathlib আর shutil

অটোমেশনের সবচেয়ে বড় অংশ ফাইল নিয়ে। পর্ব ২৫-এ pathlib দিয়ে path বানানো, glob দিয়ে খোঁজা আর ফাইল পড়া-লেখা দেখেছেন। এবার যোগ হলো shutil (“shell utilities”) — কপি, সরানো, পুরো ফোল্ডার কপি, archive বানানো:

বিয়ের ছবির নাম বদল — আগে dry-run

নাম বদলের স্ক্রিপ্টে একটি ভুল (যেমন সব ছবির নতুন নাম একই হয়ে যাওয়া) মানে ৬৪০টি ছবির ৬৩৯টি একটির ওপর আরেকটি লিখে হারিয়ে যাওয়া। তাই পেশাদার টুলের প্রথম নিয়ম: dry run — আসল কাজের আগে শুধু দেখানো কী করা হবে, কিছু না বদলে। --dry-run দিয়ে তালিকা দেখুন, মিলিয়ে নিন, তারপর আসল রান। দেখুন একই ফোল্ডারে দুই ধরনের রানে কী ঘটে:

IMG_0001.jpg
IMG_0002.jpg
IMG_0003.jpg
biye_2026_002.jpg   ← আগে কেউ হাতে একটি বদলে রেখেছিল

[dry-run] IMG_0001.jpg → biye_2026_001.jpg
[বাদ] IMG_0002.jpg - biye_2026_002.jpg আগেই আছে
[dry-run] IMG_0003.jpg → biye_2026_003.jpg
ফোল্ডারে এখনো: IMG_0001, IMG_0002, IMG_0003, biye_2026_002 — কিছুই বদলায়নি

নতুন নাম ঠিক আছে?            হ্যাঁ
দুটি ফাইলের নতুন নাম একই?     না
সংঘর্ষ (collision)?           ১টি — IMG_0002 বাদ যাবে, মুছবে না
সিদ্ধান্ত: আসল রান চালানো যায়

[করা হলো] IMG_0001.jpg → biye_2026_001.jpg
[বাদ] IMG_0002.jpg - biye_2026_002.jpg আগেই আছে
[করা হলো] IMG_0003.jpg → biye_2026_003.jpg
ফোল্ডারে এখন: IMG_0002, biye_2026_001, biye_2026_002, biye_2026_003

[বাদ] IMG_0002.jpg - biye_2026_002.jpg আগেই আছে
IMG_0001 আর IMG_0003 আর নেই, তাই তাদের ছোঁয়াই হলো না।
ফোল্ডার আগের মতোই — দ্বিতীয় রানে কোনো ক্ষতি নেই।

এবার সেই যুক্তি আসল কোডে। স্ক্রিপ্টটি নিজের working directory-তে একটি নকল ফোল্ডার বানায়, তিনবার চালায় (dry-run, আসল, আবার আসল), প্রতিবার ফোল্ডারের sorted তালিকা ছাপে, আর শেষে ফোল্ডার মুছে দেয়:

from pathlib import Path
import shutil

def rename_photos(folder: Path, prefix: str, dry_run: bool) -> list[str]:
    failed = []
    for old in sorted(folder.glob("IMG_*.jpg")):
        new = old.with_name(f"{prefix}_{int(old.stem[4:]):03d}.jpg")
        try:
            if new.exists():
                raise FileExistsError(f"{new.name} আগেই আছে")
            if not dry_run:
                old.rename(new)
            print("[dry-run]" if dry_run else "[করা হলো]", old.name, "->", new.name)
        except OSError as e:          # একটি ফাইলের সমস্যা, বাকিরা চলবে
            print("[বাদ]", old.name, "-", e)
            failed.append(old.name)
    return failed

demo = Path("demo_biye")
shutil.rmtree(demo, ignore_errors=True)
demo.mkdir()
for name in ["IMG_0001.jpg", "IMG_0002.jpg", "IMG_0003.jpg", "biye_2026_002.jpg"]:
    (demo / name).write_text("photo")
for dry in (True, False, False):
    print("ব্যর্থ:", rename_photos(demo, "biye_2026", dry))
    print(sorted(p.name for p in demo.iterdir()))
shutil.rmtree(demo)

ডাউনলোড ফোল্ডার সাজানো

পর্ব ২৫-এ extension অনুযায়ী ফাইল সাজানোর ধারণা দেখেছেন। টুল হিসেবে এর সাথে যোগ হয় dry-run আর সংঘর্ষের নিয়ম। extension-কে lower() করতে ভুলবেন না, নাহলে .JPG আর .jpg দুই জায়গায় যাবে:

import shutil
from pathlib import Path

KIND = {".pdf": "Documents", ".docx": "Documents", ".jpg": "Images",
        ".png": "Images", ".mp4": "Videos", ".zip": "Archives"}

def organize(folder: Path, dry_run: bool) -> int:
    problems = 0
    for f in sorted(folder.iterdir()):
        if not f.is_file():
            continue
        target_dir = folder / KIND.get(f.suffix.lower(), "Others")
        target = target_dir / f.name
        if target.exists():
            print(f"[বাদ] {f.name}: {target_dir.name}-এ একই নামের ফাইল আছে")
            problems += 1
            continue
        print(f"{'[dry-run] ' if dry_run else ''}{f.name} → {target_dir.name}/")
        if not dry_run:
            target_dir.mkdir(exist_ok=True)
            shutil.move(f, target)
    return problems

বড় আর পুরোনো ফাইল খোঁজা — মুছবেন না, শুধু দেখান

ল্যাপটপের ডিস্ক ভরে গেছে? rglob("*") দিয়ে সব ফাইল ঘুরে stat() থেকে আকার (st_size, বাইটে) আর শেষ বদলের সময় (st_mtime) দেখা যায়। ১০০ MB-র বড় বা ১৮০ দিনের বেশি না-ছোঁয়া ফাইলের একটি তালিকা বানান — কিন্তু স্ক্রিপ্টকে নিজে থেকে মুছতে দেবেন না। মোছার সিদ্ধান্ত মানুষের; স্ক্রিপ্টের কাজ তালিকা দেওয়া, বড় থেকে ছোট ক্রমে।

import time
from pathlib import Path

LIMIT = 100 * 1024 * 1024                    # 100 MB
cutoff = time.time() - 180 * 24 * 3600       # ১৮০ দিন আগের মুহূর্ত
found = []
for p in Path.home().joinpath("Downloads").rglob("*"):
    try:
        if p.is_file():
            st = p.stat()
            if st.st_size > LIMIT or st.st_mtime < cutoff:
                found.append((st.st_size, p))
    except OSError:                          # অনুমতি নেই বা ফাইল উধাও — বাদ দিন
        continue
for size, p in sorted(found, reverse=True):
    print(f"{size / 1e6:9.1f} MB  {p}")

থিসিস ফোল্ডারের ব্যাকআপ আর zip

থিসিস জমার দুই সপ্তাহ আগে ল্যাপটপ নষ্ট — এই দুঃস্বপ্নের ওষুধ একটি ছোট ব্যাকআপ স্ক্রিপ্ট। প্রতিবার সময়-চিহ্নসহ একটি নতুন archive বানান, যাতে পুরোনো ব্যাকআপ ওভাররাইট না হয়; বানানোর পর zip-টি ঠিক আছে কি না যাচাই করুন; আর শুধু শেষ ৭টি রেখে বাকিগুলো সরান। shutil.make_archive এক লাইনে পুরো ফোল্ডার zip করে, আর zipfile module দিয়ে zip খুলে পরীক্ষা করা যায়:

import shutil
import zipfile
from datetime import datetime
from pathlib import Path

def backup(src: Path, dest: Path, keep: int = 7) -> Path:
    dest.mkdir(parents=True, exist_ok=True)
    stamp = datetime.now().strftime("%Y-%m-%d_%H%M%S")
    archive = Path(shutil.make_archive(str(dest / f"{src.name}_{stamp}"), "zip", root_dir=src))
    with zipfile.ZipFile(archive) as z:
        if z.testzip() is not None:              # কোনো ফাইল নষ্ট হলে তার নাম আসে
            raise RuntimeError(f"ব্যাকআপ নষ্ট: {archive.name}")
    old = sorted(dest.glob(f"{src.name}_*.zip"))[:-keep]   # নাম = সময়, তাই sorted = পুরোনো আগে
    for p in old:
        print(f"পুরোনো ব্যাকআপ সরানো হলো: {p.name}")
        p.unlink()
    return archive

এখানে মোছা হচ্ছে, কিন্তু তিনটি শর্তে নিরাপদ: শুধু এই স্ক্রিপ্টের বানানো নামের ধাঁচ (thesis_*.zip) মেলে এমন ফাইল; নতুন ব্যাকআপ সফলভাবে যাচাই হওয়ার পরে; আর সবসময় অন্তত ৭টি থেকে যায়। গন্তব্য যেন আলাদা ডিস্ক, পেনড্রাইভ বা ক্লাউড-সিঙ্ক ফোল্ডার হয় — একই ডিস্কে ব্যাকআপ ডিস্ক নষ্ট হলে কোনো কাজে আসে না।

৬ · অটোমেশনের নিরাপত্তা — একটি ফাইলের ভুল যেন সব না থামায়

হাতে কাজ করলে আপনি প্রতিটি ধাপ চোখে দেখেন। স্ক্রিপ্ট দেখে না — হাজারটি ফাইলে এক সেকেন্ডে একই সিদ্ধান্ত নেয়। তাই অটোমেশন স্ক্রিপ্টের জন্য পাঁচটি নিয়ম মানুন:

1. আগে dry-run. যে স্ক্রিপ্ট কিছু বদলায়, মোছে বা সরায়, তাতে --dry-run থাকবে। আরও সাবধানী নকশা হলো উল্টোটা — ডিফল্টে শুধু দেখানো, আর আসল কাজের জন্য স্পষ্ট --apply লাগবে।
2. নিশ্চিত না হয়ে মোছা নয়। মোছার আগে তালিকা দেখিয়ে input("মুছব? (y/N) ")-এ স্পষ্ট y চান, ডিফল্ট “না”। cron-এর মতো মানুষ-ছাড়া পরিবেশে --yes flag দিয়ে সচেতনভাবে অনুমতি দিন। আরও ভালো: মোছার বদলে একটি trash/ ফোল্ডারে সরান।
3. যা করলেন তা লিখে রাখুন। পর্ব ৪০-এর logging দিয়ে প্রতিটি বদল (পুরোনো → নতুন) একটি log ফাইলে। কিছু ভুল হলে এই log-ই বলবে কী ঘটেছে, আর দরকারে উল্টো দিকে ফেরানোর তালিকা দেবে।
4. প্রতিটি ফাইলের error আলাদা করে ধরুন। লুপের ভেতরে try/except, বাইরে নয়। শেষে সারাংশ, আর কিছু ব্যর্থ হলে exit code 1.
5. দুবার চালালেও যেন ক্ষতি না হয়। স্ক্রিপ্ট মাঝপথে থেমে গেলে (বিদ্যুৎ গেল, ল্যাপটপ ঘুমিয়ে পড়ল) আবার চালানোই স্বাভাবিক সমাধান — তাই আবার চালানো নিরাপদ হতে হবে।

চতুর্থ নিয়মটি সবচেয়ে বেশি উপেক্ষিত। লুপের বাইরে একটি বড় try থাকলে প্রথম নষ্ট ফাইলেই পুরো কাজ থেমে যায় — আর অর্ধেক ফাইল বদলানো, অর্ধেক পুরোনো, এমন বিশৃঙ্খল অবস্থা থেকে যায়। ১০টি স্ক্যান করা কাগজের ছবি ছোট করার একটি কাজ দেখুন, যেখানে ৫ নম্বর ফাইলটি পড়া যায় না:

1ok, failed = 0, []2for f in sorted(folder.glob("*.jpg")):3    try:4        shrink(f)            # ছবি ছোট করা5        ok += 16    except OSError as e:7        log.error("%s: %s", f.name, e)8        failed.append(f.name)9print(f"{ok}টি সফল, {len(failed)}টি ব্যর্থ")10sys.exit(1 if failed else 0)

Idempotency — দ্বিতীয় রান নিরাপদ কীভাবে করবেন

কিছু কৌশল প্রায় সব অটোমেশনে কাজে লাগে: নতুন নাম আসুক তথ্য থেকে (পুরোনো নাম, তারিখ), গণনা থেকে নয়; “যোগ করো”-র বদলে “এমন অবস্থা নিশ্চিত করো” ভাবুন — mkdir(exist_ok=True), “ফাইল আছে কি না দেখে তারপর কপি”; আউটপুট ফাইল প্রতিবার পুরোটা নতুন করে বানান, পুরোনোর শেষে যোগ নয়; আর যা আগে করা হয়ে গেছে তা চিনে বাদ দিন। মাসিক রিপোর্ট জোড়ার স্ক্রিপ্ট দুবার চালালে যেন বিক্রি দ্বিগুণ না দেখায় — পরের অংশে ঠিক এটাই দেখবেন।

৭ · রিপোর্ট জোড়া — ১২ মাসের CSV এক ফাইলে

একটি পোশাক কোম্পানির ঢাকা, চট্টগ্রাম, সিলেট শাখা প্রতি মাসে একটি করে বিক্রির ফাইল পাঠায়: sales_2026_01.csv, sales_2026_02.csv… কলাম branch,product,amount. বছর শেষে হিসাবরক্ষক ১২টি ফাইল খুলে কপি-পেস্ট করে একটি বড় শিটে জোড়েন, তারপর শাখাভিত্তিক মোট বের করেন। এক দিনের কাজ, আর প্রতি বছর কোথাও না কোথাও একটি মাস দুবার পেস্ট হয়। পর্ব ২৬-এর csv module দিয়ে পুরোটা একটি স্ক্রিপ্ট:

import csv
import sys
from pathlib import Path

def merge(folder: Path, out_path: Path) -> int:
    totals: dict[str, int] = {}
    bad = 0
    with open(out_path, "w", newline="", encoding="utf-8") as out:   # প্রতিবার নতুন ফাইল
        writer = csv.writer(out)
        writer.writerow(["month", "branch", "product", "amount"])
        for path in sorted(folder.glob("sales_2026_*.csv")):
            month = path.stem.rsplit("_", 1)[-1]                       # sales_2026_03 → 03
            try:
                with open(path, newline="", encoding="utf-8-sig") as f:  # Excel-এর BOM সামলায়
                    rows = [(r["branch"], r["product"], int(r["amount"]))
                            for r in csv.DictReader(f)]
            except (OSError, KeyError, ValueError) as e:
                print(f"[বাদ] {path.name}: {e!r}", file=sys.stderr)
                bad += 1
                continue
            for branch, product, amount in rows:                       # পুরো ফাইল ঠিক হলে তবেই লেখা
                writer.writerow([month, branch, product, amount])
                totals[branch] = totals.get(branch, 0) + amount
    for branch in sorted(totals):
        print(f"{branch}: {totals[branch]:,} টাকা")
    return 1 if bad else 0

তিনটি নকশার সিদ্ধান্ত লক্ষ করুন। এক, প্রতিটি ফাইল আগে পুরোটা পড়ে list-এ রাখা হয়েছে; একটি সারিতে ভুল (amount-এ “১২হাজার”) হলে সেই ফাইলের কোনো সারিই লেখা হয় না — অর্ধেক ফাইল ঢুকে যাওয়ার চেয়ে পুরো ফাইল বাদ দিয়ে জানানো অনেক পরিষ্কার। দুই, আউটপুট "w" মোডে প্রতিবার নতুন করে বানানো হয়, তাই স্ক্রিপ্ট দুবার চালালেও কিছু দ্বিগুণ হয় না — idempotent. তিন, মাসের নম্বর ফাইলের নাম থেকে নেওয়া, যাতে জোড়া ফাইলেও বোঝা যায় কোন সারি কোন মাসের। {:,} হাজারের কমা বসায় (1,250,000).

Excel ফাইল হলে?

অফিসের রিপোর্ট প্রায়ই .xlsx. standard library-তে Excel পড়ার module নেই; প্রচলিত দুটি পথ হলো তৃতীয় পক্ষের openpyxl (সরাসরি শিট, সেল, ফরম্যাটিং) আর পর্ব ৪৬-এর pandas (যা ভেতরে openpyxl ব্যবহার করে)। pandas-এ ১২টি ফাইল জোড়া কয়েক লাইনের কাজ। এগুলো pip দিয়ে আলাদা ইনস্টল করতে হয় (পর্ব ২৩), তাই এই পাতায় চালানো যাবে না:

# pip install pandas openpyxl   (নিজের venv-এ)
from pathlib import Path
import pandas as pd

frames = [pd.read_excel(p).assign(month=p.stem[-2:])
          for p in sorted(Path("reports").glob("sales_2026_*.xlsx"))]
summary = pd.concat(frames, ignore_index=True)
summary.to_excel("summary_2026.xlsx", index=False)
print(summary.groupby("branch")["amount"].sum())

৮ · অন্য প্রোগ্রাম চালানো — subprocess.run

সব কাজ Python-এ নতুন করে লেখার দরকার নেই। git, ffmpeg (ভিডিও), ImageMagick (ছবি), pg_dump (ডেটাবেস ব্যাকআপ) — এসব প্রোগ্রাম আগেই আছে। Python স্ক্রিপ্ট এদের “আঠা” হিসেবে জুড়ে দিতে পারে subprocess module দিয়ে:

import subprocess

result = subprocess.run(
    ["git", "log", "--oneline", "-5"],     # প্রোগ্রাম আর আর্গুমেন্ট — list আকারে
    capture_output=True,                   # stdout/stderr ধরে রাখো, পর্দায় নয়
    text=True,                             # bytes নয়, str দাও
    check=True,                            # exit code অশূন্য হলে CalledProcessError
    timeout=30,                            # আটকে গেলে TimeoutExpired
)
print(result.returncode)                   # 0
print(result.stdout)

প্রতিটি আর্গুমেন্টের কারণ আছে। check=True না দিলে প্রোগ্রাম ব্যর্থ হলেও Python চুপচাপ পরের লাইনে চলে যায় — আপনার স্ক্রিপ্ট ভাববে ব্যাকআপ হয়ে গেছে। প্রোগ্রামটি কম্পিউটারে না থাকলে আসে FileNotFoundError. timeout না দিলে কোনো প্রোগ্রাম প্রশ্ন করে ইনপুটের অপেক্ষায় থাকলে আপনার cron-এর কাজ চিরকাল আটকে থাকতে পারে। subprocess.run এসেছে Python 3.5-এ; capture_output আর text 3.7-এ।

সবচেয়ে বড় বিপদ: shell=True আর ব্যবহারকারীর ইনপুট

subprocess.run("ping -c 1 " + host, shell=True) — দেখতে সহজ, AI-ও প্রায়ই লেখে। কিন্তু shell=True মানে পুরো string-টি একটি shell-কে দেওয়া হয়, আর shell ;, &&, |, $( )-এর মতো চিহ্নকে নির্দেশ হিসেবে পড়ে। ইনপুটটি যদি ব্যবহারকারী বা কোনো ফাইল থেকে আসে, তাহলে কী হয়, দেখুন:

host = "8.8.8.8; rm -rf ~"
দেখতে একটি IP ঠিকানা, কিন্তু শেষে একটি লুকানো নির্দেশ

shell যা পড়ল:  ping -c 1 8.8.8.8 ; rm -rf ~
নির্দেশ ১:      ping -c 1 8.8.8.8
নির্দেশ ২:      rm -rf ~      ← হোম ফোল্ডারের সব মুছে দেওয়ার নির্দেশ

argv[0] = "ping"
argv[1] = "-c"
argv[2] = "1"
argv[3] = "8.8.8.8; rm -rf ~"   ← পুরোটা একটি আর্গুমেন্ট, কোনো shell নেই
ping: 8.8.8.8; rm -rf ~: Name or service not known   (ক্ষতিহীন ব্যর্থতা)

ipaddress.ip_address(host)      # ভুল হলে ValueError — চালানোর আগেই থামুন
subprocess.run(["ping", "-c", "1", host],
               capture_output=True, text=True,
               check=True, timeout=10)
ইনপুট "-"-দিয়ে শুরু হলে ping সেটিকে option ভাবতে পারে — যাচাই সেটাও আটকায়

নিয়ম সহজ: সবসময় list আকারে। shell=True শুধু তখন, যখন পুরো নির্দেশটি আপনার নিজের লেখা, কোনো বাইরের অংশ নেই — আর তখনও প্রায়ই দরকার হয় না। পাইপ (|) বা wildcard (*.jpg)-এর জন্য shell লাগবে মনে হলে, Python-এই করুন: glob, আর এক প্রোগ্রামের ফল আরেকটিতে দিতে input=result.stdout. মনে রাখবেন, ping-এর -c Linux/macOS-এর; Windows-এ -n — বাইরের প্রোগ্রাম মানে প্ল্যাটফর্মের পার্থক্যও আপনার মাথাব্যথা।

৯ · সময়মতো চালানো আর সবার জন্য কমান্ড বানানো

প্রতি রাত ১০টায় থিসিসের ব্যাকআপ — এটা মনে রেখে প্রতিদিন হাতে চালানো তো অটোমেশন হলো না। কাজটি OS-এর scheduler-কে দিন। Linux/macOS-এ cron: crontab -e খুলে প্রতিটি লাইনে পাঁচটি সময়ের ঘর (মিনিট, ঘণ্টা, মাসের দিন, মাস, সপ্তাহের দিন) আর একটি কমান্ড:

# মিনিট ঘণ্টা দিন মাস সপ্তাহের-দিন  কমান্ড
0 22 * * *   /home/rafi/thesis-tools/.venv/bin/python /home/rafi/thesis-tools/backup.py --dest /media/rafi/USB >> /home/rafi/backup.log 2>&1
30 9 1 * *   /home/rafi/thesis-tools/.venv/bin/python /home/rafi/thesis-tools/merge_sales.py   # প্রতি মাসের ১ তারিখ সকাল ৯:৩০

Windows-এ একই কাজ করে Task Scheduler — গ্রাফিক্যাল অ্যাপে “Create Basic Task”, অথবা কমান্ডে:

schtasks /create /tn "ThesisBackup" /sc daily /st 22:00 /tr "C:\Users\Rafi\thesis-tools\.venv\Scripts\python.exe C:\Users\Rafi\thesis-tools\backup.py"

Python-এর ভেতরেই সময় ধরে চালাতে তৃতীয় পক্ষের schedule লাইব্রেরি জনপ্রিয়: schedule.every().day.at("22:00").do(backup), তারপর একটি অসীম লুপে schedule.run_pending(). সহজ, কিন্তু শর্ত হলো প্রোগ্রামটিকে সারাক্ষণ চালু থাকতে হবে — বন্ধ হলে বা কম্পিউটার রিস্টার্ট হলে সময়সূচিও শেষ। তাই নিয়মিত কাজে OS-এর scheduler সাধারণত বেশি নির্ভরযোগ্য; schedule মানায় এমন প্রোগ্রামে যা এমনিতেই সারাক্ষণ চলে (যেমন একটি ছোট সার্ভার)।

স্ক্রিপ্টকে আসল কমান্ড বানানো

python /path/to/rename_photos.py ... লেখা ঝামেলার। পর্ব ২৩-এ দেখেছেন, pyproject.toml-এর [project.scripts] অংশ একটি entry point ঘোষণা করে — ইনস্টলের পর terminal-এ শুধু টুলের নাম লিখলেই চলে:

[project]
name = "biye-rename"
version = "0.1.0"
requires-python = ">=3.10"

[project.scripts]
biye-rename = "biye_rename.cli:main"     # কমান্ডের নাম = "package.module:function"

$ python -m pip install -e .          # নিজের venv-এ, ডেভেলপমেন্টের সময়
$ biye-rename photos --prefix biye_2026 --dry-run
$ pipx install .                      # সব জায়গা থেকে চালাতে, আলাদা পরিবেশে

pip যে ছোট চালানোর ফাইলটি বানায়, সেটি sys.exit(main()) ডাকে — তাই main()-এর ফেরত দেওয়া সংখ্যাই exit code হয়। অংশ ৪-এর কাঠামো এখানে সরাসরি কাজে লাগল। pipx প্রতিটি টুলকে নিজের venv-এ ইনস্টল করে, কিন্তু কমান্ডটি সবখানে পাওয়া যায় — নিজের বানানো টুল বা ruff-এর মতো টুলের জন্য আদর্শ।

argparse ছাড়া বিকল্প: click আর typer

বড় CLI-তে তৃতীয় পক্ষের দুটি লাইব্রেরি জনপ্রিয়। click (Flask-এর নির্মাতা Armin Ronacher-এর প্রকল্প থেকে আসা) decorator দিয়ে কমান্ড ঘোষণা করে, আর রঙিন আউটপুট, নিশ্চিতকরণ প্রশ্ন, progress bar-এর সুবিধা দেয়। typer (FastAPI-র নির্মাতা Sebastián Ramírez-এর) click-এর ওপর তৈরি, আর আপনার ফাংশনের type hint (পর্ব ৩৭) পড়েই আর্গুমেন্ট বানায়:

# pip install typer   (নিজের venv-এ)
import typer

def main(folder: str, prefix: str = "photo", dry_run: bool = False) -> None:
    """ছবির নাম একসাথে বদলায়।"""
    typer.echo(f"{folder=} {prefix=} {dry_run=}")

if __name__ == "__main__":
    typer.run(main)          # folder → positional, prefix → --prefix, dry_run → --dry-run

কোনটি বাছবেন? ছোট টুল, কোনো ইনস্টল ছাড়া যেকোনো কম্পিউটারে চলতে হবে, বা স্ক্রিপ্ট একটি ফাইলে কাউকে পাঠাবেন — argparse. অনেক subcommand-এর বড় টুল, যেখানে আগে থেকেই dependency আছে — typer বা click লেখা কমায়। ধারণাগুলো (positional, flag, default, help, exit code) সবখানে একই; argparse বুঝলে বাকিগুলো এক বিকেলের কাজ।

১০ · AI-এর যুগে — AI-এর লেখা অটোমেশন স্ক্রিপ্ট যাচাই

“আমার ফোল্ডারের সব ছবির নাম বদলে দাও” — AI এক সেকেন্ডে একটি স্ক্রিপ্ট দেয়, আর সেটি সাধারণত চলেও। বিপদ হলো, অটোমেশন স্ক্রিপ্ট আপনার আসল ফাইল ছোঁয়, আর AI আপনার ফোল্ডারের বাস্তব অবস্থা জানে না: আগে থেকে থাকা নাম, নষ্ট ফাইল, Windows-এর path, ১০,০০০ ফাইলের পরিমাণ। AI-এর লেখা অটোমেশনে এই ভুলগুলো বারবার দেখা যায়:

AI-এর অটোমেশন স্ক্রিপ্ট আসল ফাইলে চালানোর আগে — চেকলিস্ট

• কোডটি পুরো পড়েছি: কোথায় rename, move, unlink, rmtree, "w" মোড আছে, চিহ্নিত করেছি
• dry-run বা শুধু-দেখানোর ডিফল্ট আছে, আর তার আউটপুট আগে মিলিয়ে দেখেছি
• লক্ষ্যে একই নাম থাকলে ওভাররাইট হয় না; কোনো মোছা নিশ্চিতকরণ ছাড়া হয় না
• কোনো absolute path কোডে লেখা নেই — সব আর্গুমেন্ট থেকে আসে, -h কাজ করে
• subprocess list আকারে, shell=True নেই, check=True আছে
• প্রতিটি ফাইলের error আলাদা করে ধরা, log ও সারাংশ আছে, ব্যর্থ হলে exit code অশূন্য
• প্রথমে নকল ফোল্ডারে (কয়েকটি খালি ফাইল, একটি সংঘর্ষ, একটি বাংলা নাম) চালিয়েছি, দুবার চালিয়ে দেখেছি, আর আসল ফোল্ডারের ব্যাকআপ রেখেছি