ڈیکوریٹرز کیا ہیں اور آپ کیسے ایک لکھتے ہیں؟

Question

Accepted Answer

ایک **decorator** ایک فنکشن ہے جو **ایک اور فنکشن کو لپیٹتا ہے** رویہ شامل کرنے کے لیے، بغیر اصل کوڈ کو تبدیل کیے۔ یہ ایک فنکشن کے اوپر `@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 خصوصیت ہے — پار کاٹنے والی فکریں کو بنیادی منطق سے علیحدہ کریں۔

وہ حقیقی Python میں ہر جگہ ہیں: ویب فریم ورک (`@app.route`)، کیشنگ (`@lru_cache`)، کلاسز (`@property`)، اور ٹیسٹنگ۔

سمجھنا کہ انہیں کیسے لکھا جائے (ایک wrapper فنکشن، `*args/**kwargs`, `functools.wraps`) اور پیرامیٹرائزڈ شکل آپ کو ماحول کے ڈیکوریٹرز کو صحیح طریقے سے استعمال کرنے اور اپنی دوبارہ استعمال کے قابل تجریدات بنانے کی اجازت دیتا ہے۔