ডেকোরেটর কী এবং আপনি কীভাবে একটি লিখবেন?

Question

Accepted Answer

একটি **ডেকোরেটর** হল একটি ফাংশন যা **অন্য একটি ফাংশনকে মোড়ায়** মূল কোড সংশোধন না করে আচরণ যোগ করার জন্য। এটি একটি ফাংশনের উপরে `@decorator` সিনট্যাক্স দিয়ে প্রয়োগ করা হয় — লগিং, টাইমিং, ক্যাশিং বা অ্যাক্সেস কন্ট্রোল এর মতো ক্রস-কাটিং উদ্বেগ যোগ করার একটি পরিষ্কার উপায়।

## ডেকোরেটর কীভাবে কাজ করে

```python
def my_decorator(func):
    def wrapper(*args, **kwargs):       # wraps the original function
        print("before")
        result = func(*args, **kwargs)  # call the original
        print("after")
        return result
    return wrapper                       # return the wrapped version

@my_decorator
def greet(name):
    print(f"Hello {name}")

greet("Ann")
# Output: before / Hello Ann / after
```

`@my_decorator` সিনট্যাক্স হল `greet = my_decorator(greet)` এর জন্য সুগার — এটি `greet` কে `wrapper` দিয়ে প্রতিস্থাপন করে, যা মূল কলের চারপাশে অতিরিক্ত কোড চালায়। `*args, **kwargs` wrapper কে যেকোনো ফাংশন সিগনেচারের জন্য কাজ করে তোলে।

## একটি ব্যবহারিক উদাহরণ: টাইমিং

```python
import time, functools

def timed(func):
    @functools.wraps(func)        # preserves func's name/docstring (important!)
    def wrapper(*args, **kwargs):
        start = time.perf_counter()
        result = func(*args, **kwargs)
        print(f"{func.__name__} took {time.perf_counter() - start:.3f}s")
        return result
    return wrapper

@timed
def slow_task():
    time.sleep(1)
```

`@functools.wraps(func)` গুরুত্বপূর্ণ — এটি ছাড়া, মোড়ানো ফাংশন তার আসল নাম এবং docstring হারায়।

## যুক্তি সহ ডেকোরেটর

```python
def repeat(times):               # outer takes the decorator's argument
    def decorator(func):
        @functools.wraps(func)
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(times=3)
def hello(): print("hi")  # prints "hi" three times
```

একটি প্যারামিটারযুক্ত ডেকোরেটরের একটি অতিরিক্ত স্তর প্রয়োজন (একটি ফাংশন যা একটি ডেকোরেটর ফেরত দেয়)।

## সাধারণ বিল্ট-ইন / লাইব্রেরি ডেকোরেটর

```text
@property            → turn a method into a computed attribute
@staticmethod / @classmethod → method types
@functools.lru_cache → memoize results
@app.route("/")      → web framework routing (Flask)
@pytest.fixture      → test fixtures
```

## কেন এটি গুরুত্বপূর্ণ

ডেকোরেটর হল ফাংশনে পুনরায় ব্যবহারযোগ্য আচরণ যোগ করার জন্য **শক্তিশালী, স্বতন্ত্রভাবে-পাইথনিক বৈশিষ্ট্য** (লগিং, টাইমিং, ক্যাশিং, প্রমাণীকরণ, যাচাইকরণ, রুটিং) পরিষ্কারভাবে এবং ঘোষণামূলকভাবে — মূল যুক্তি থেকে ক্রস-কাটিং উদ্বেগ বিভক্ত করা।

তারা বাস্তব Python এ সর্বত্র রয়েছে: ওয়েব ফ্রেমওয়ার্ক (`@app.route`), ক্যাশিং (`@lru_cache`), ক্লাস (`@property`), এবং পরীক্ষা।

তাদের লিখতে কীভাবে বুঝুন (একটি wrapper ফাংশন, `*args/**kwargs`, `functools.wraps`) এবং প্যারামিটারযুক্ত ফর্ম আপনাকে ইকোসিস্টেমের ডেকোরেটর সঠিকভাবে ব্যবহার করতে এবং আপনার নিজস্ব পুনরায় ব্যবহারযোগ্য অ্যাবস্ট্রাকশন তৈরি করতে দেয়।