Error Handling ও Logging

def get_price(products: dict[str, int], name: str) -> int:
    return products[name]

def checkout(cart: list[str]) -> int:
    products = {"burger": 250, "coke": 40}
    return sum(get_price(products, item) for item in cart)

checkout(["burger", "pizza"])

Traceback (most recent call last):
  File "shop.py", line 8, in <module>
    checkout(["burger", "pizza"])
  File "shop.py", line 6, in checkout
    return sum(get_price(products, item) for item in cart)
  File "shop.py", line 2, in get_price
    return products[name]
KeyError: 'pizza'

def read_age(raw: str) -> int | None:
    try:
        age = int(raw)                    # এখানে ValueError হতে পারে
    except ValueError:
        print(f"'{raw}' কোনো সংখ্যা না")
        return None
    else:
        # try তে কোনো error না হলে চলে
        print("সংখ্যা পাওয়া গেছে")
        return age
    finally:
        # সবসময় চলে, error হোক বা না হোক (cleanup এর জন্য)
        print("যাচাই শেষ")

# ❌ খারাপ: সব কিছু চুপচাপ গিলে ফেলা
try:
    process_payment(order)
except Exception:
    pass                     # কী হলো কেউ জানবে না। টাকা কাটলো কিনা? 😱

# ✓ ভালো: যেটা আশা করছো আর সামলাতে পারো, শুধু সেটা ধরো
try:
    process_payment(order)
except PaymentDeclinedError as e:
    notify_user(order.user, f"Payment হয়নি: {e.reason}")
except GatewayTimeoutError:
    schedule_retry(order)
# অন্য অপ্রত্যাশিত error উপরে যাক, যাতে log হয় আর আমরা জানতে পারি

class AppError(Exception):
    """আমাদের app এর সব error এর মূল।"""

class NotFoundError(AppError):
    def __init__(self, resource: str, resource_id: int) -> None:
        self.resource = resource
        self.resource_id = resource_id
        super().__init__(f"{resource} #{resource_id} পাওয়া যায়নি")

class InsufficientBalanceError(AppError):
    def __init__(self, needed: int, available: int) -> None:
        self.needed = needed
        self.available = available
        super().__init__(f"দরকার {needed}, আছে {available}")

class PermissionDeniedError(AppError):
    pass


def withdraw(balance: int, amount: int) -> int:
    if amount > balance:
        raise InsufficientBalanceError(needed=amount, available=balance)
    return balance - amount

import httpx

class PaymentGatewayError(AppError):
    pass

def charge(amount: int) -> dict:
    try:
        r = httpx.post("https://gateway.example/charge", json={"amount": amount}, timeout=10)
        r.raise_for_status()
        return r.json()
    except httpx.HTTPError as e:
        raise PaymentGatewayError("Payment gateway তে সমস্যা") from e   # from e!

# LBYL
if "email" in data and data["email"] is not None:
    send(data["email"])

# EAFP (Python এ বেশি প্রচলিত)
try:
    send(data["email"])
except KeyError:
    log_missing_email()

import logging

logging.basicConfig(
    level=logging.INFO,
    format="%(asctime)s %(levelname)s [%(name)s] %(message)s",
)
logger = logging.getLogger(__name__)      # প্রতিটা module এ নিজের logger


def place_order(order_id: int, amount: int) -> None:
    logger.info("Order শুরু: id=%s amount=%s", order_id, amount)
    try:
        charge(amount)
    except PaymentGatewayError:
        logger.exception("Payment ব্যর্থ: order_id=%s", order_id)   # traceback সহ
        raise
    logger.info("Order সম্পন্ন: id=%s", order_id)

2026-10-29 10:15:02,114 INFO [orders] Order শুরু: id=42 amount=55000
2026-10-29 10:15:12,301 ERROR [orders] Payment ব্যর্থ: order_id=42
Traceback (most recent call last):
  ...

def main() -> None:
    try:
        run_app()
    except AppError as e:
        print(f"সমস্যা: {e}")          # user এর জন্য বোঝার মতো message
        raise SystemExit(1)
    except Exception:
        logger.exception("অপ্রত্যাশিত error")
        print("অপ্রত্যাশিত সমস্যা হয়েছে, log দেখুন")
        raise SystemExit(2)