سرفصل‌ها درس 63 از 250 · کد Pythonic، آزمون‌نویسی و پروژهٔ پایانی
کد Pythonic، آزمون‌نویسی و پروژهٔ پایانی

Decoratorها

یک decorator تابعی است که تابع دیگری را می‌پیچد تا رفتاری اضافه کند، بدون تغییر بدنهٔ اصلی. آن را با نحو @ بالای یک def به کار می‌برید.

شکل همیشه یکی است: یک تابع بگیرید، یک wrapper درونی تعریف کنید که کاری اضافه انجام می‌دهد و سپس اصلی را فرا می‌خواند، و wrapper را برگردانید.

def shout(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        return result.upper()
    return wrapper

@shout
def greet(name):
    return f"hi {name}"

print(greet("ada"))   # HI ADA

نوشتن @shout بالای greet فقط کوتاه‌نوشت greet = shout(greet) است. از آن به بعد، نام greet به wrapper اشاره می‌کند.

*args, **kwargs در wrapper اجازه می‌دهد هر آرگومانی را که اصلی می‌گیرد بپذیرد، سپس آن‌ها را جلو بفرستد. این decorator را عمومی نگه می‌دارد.

functools.wraps

پیچیدن تابع را جایگزین می‌کند، پس نام و docstring اصلی پشت wrapper پنهان می‌شوند. این را با تزیین خود wrapper با functools.wraps(func) درست کنید، که فراداده را کپی می‌کند. همیشه روی decoratorهای واقعی این کار را بکنید:

import functools

def double(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs) * 2
    return wrapper

@double
def add(a, b):
    """Add two numbers."""
    return a + b

print(add(3, 4))        # 14
print(add.__name__)     # 'add'  (preserved by wraps)
نوبت شما

یک decorator به نام double بنویسید که مقدار برگشتی هر تابعی را که می‌پیچد دو برابر کند. از functools.wraps استفاده کنید تا تابع پیچیده‌شده __name__ خود را نگه دارد. سپس آن را با @double روی تابعی به نام add(a, b) که a + b را برمی‌گرداند به کار ببرید، تا add(3, 4) مقدار 14 بدهد و add.__name__ همچنان "add" باشد.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.