المنهج الدراسي الدرس 63 من 250 · كود Pythonic، والاختبار، ومشروع التخرج
كود Pythonic، والاختبار، ومشروع التخرج

المزخرفات

A decorator هي دالة تغلف دالة أخرى لإضافة سلوك معين، دون تغيير جسم الدالة الأصلية. أنت تطبق واحدة باستخدام صيغة @ الموضوعة فوق def.

الشكل هو نفسه دائما: خذ function، عرف wrapper داخلي يقوم بعمل إضافي ثم يستدعي original، وأرجع 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 بقبول أي arguments تأخذها الدالة الأصلية، ثم يقوم بتمريرها. هذا يحافظ على الـ decorator عاما.

functools.wraps

يقوم

Wrapping باستبدال الدالة، لذا يختفي اسم الدالة الأصلية و docstring خلف wrapper. أصلح ذلك عن طريق تزيين wrapper نفسه بـ functools.wraps(func)، والذي يقوم بنسخ metadata. افعل هذا دائما على decorators الحقيقية:

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 يضاعف قيمة الإرجاع لأي function يقوم بتغليفها. استخدم functools.wraps لكي تحتفظ الـ function المغلفة بـ __name__ الخاصة بها. ثم طبقها باستخدام @double على function باسم add(a, b) تعيد a + b، بحيث تعيد add(3, 4) قيمة 14 وتظل add.__name__ هي "add".

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.