مقدمة إلى Decorators

تُعد Decorators ميزة قوية في Python تتيح لكم تعديل سلوك الدوال أو الأساليب. وغالبًا ما تُستخدم لإضافة وظائف إلى الدوال دون تعديل الكود الخاص بها.

في هذا الدرس، ستتعلمون ماهية Decorators، وكيفية استخدامها، وكيفية إنشاء Decorators خاصة بكم.

ما هو Decorator؟

Decorator هو دالة تأخذ دالة أخرى كإدخال، وتُرجع دالة جديدة بوظائف إضافية. وغالبًا ما يُستخدم مع الصياغة @decorator_name.

# Basic example of a decorator
def decorator(func):
    def wrapper():
        print("Before the function call")
        func()
        print("After the function call")
    return wrapper

@decorator
def say_hello():
    print("Hello!")

say_hello()

كيفية عمل Decorators

عند استخدام Decorator، تستبدل Python الدالة الأصلية بالدالة المغلّفة التي يُرجعها Decorator.

# How decorators work
def decorator(func):
    def wrapper():
        print("Wrapper called")
        func()
    return wrapper

@decorator
def greet():
    print("Greetings!")

print(greet.__name__)  # Outputs: wrapper
greet()

استخدام Decorators مع المعاملات

يمكن أن تعمل Decorators مع الدوال التي تستقبل معاملات باستخدام *args و**kwargs في الدالة المغلّفة:

# Decorator for functions with arguments
def decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Arguments: {args}, {kwargs}")
        return func(*args, **kwargs)
    return wrapper

@decorator
def add(a, b):
    return a + b

print(add(3, 5))

تسلسل عدة مزخرفات

يمكنك استخدام عدة مزخرفات مع دالة واحدة. وتُطبَّق بالترتيب الذي تظهر به، من الأعلى إلى الأسفل:

# Chaining multiple decorators
def decorator1(func):
    def wrapper():
        print("Decorator 1")
        func()
    return wrapper

def decorator2(func):
    def wrapper():
        print("Decorator 2")
        func()
    return wrapper

@decorator1
@decorator2
def greet():
    print("Hello!")

greet()

إنشاء مزخرفات ذات معلمات

تقبل المزخرفات ذات المعلمات وسائط، وتتيح وظائف أكثر مرونة:

# Parameterized decorator
def repeat(times):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(times):
                func(*args, **kwargs)
        return wrapper
    return decorator

@repeat(3)
def say_hello():
    print("Hello!")

say_hello()

حالات الاستخدام الشائعة للمزخرفات

تُستخدم المزخرفات عادةً في:

• تسجيل استدعاءات الدوال ووسائطها.
• قياس زمن تنفيذ الدوال.
• التحكم في الوصول، مثل التحقق من أذونات المستخدمين.
• تخزين النتائج مؤقتًا لتحسين الأداء.

المزخرفات المضمنة في Python

توفر Python بعض المزخرفات المضمنة، ومنها:

• @staticmethod: يعرّف طريقة ثابتة.
• @classmethod: يعرّف طريقة صنف.
• @property: يعرّف خاصية.

الأخطاء الشائعة في استخدام المزخرفات

إليك بعض الأخطاء التي ينبغي تجنبها:

• عدم الحفاظ على اسم الدالة الأصلية وسلسلة توثيقها (استخدم functools.wraps).
• استخدام المزخرفات دون داعٍ للمهام البسيطة.
• نسيان معالجة الوسائط في الدالة المُغلِّفة.

ما الذي تعلمناه؟

في هذا الدرس، تعلمت:

• ما المزخرفات وكيف تعمل في Python.
• كيفية إنشاء المزخرفات الأساسية وذات المعلمات والمتسلسلة واستخدامها.
• حالات الاستخدام الشائعة والمزخرفات المضمنة في Python.

أحسنتم! لننتقل إلى الموضوع التالي.