مقدمة إلى المزخرفات

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

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

ما المزخرف؟

المزخرف هو دالة تأخذ دالة أخرى كإدخال وتعيد دالة جديدة بوظائف إضافية. وغالبًا ما يُستخدم مع الصياغة @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()

كيف تعمل المزخرفات

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

# 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()

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

يمكن للمزخرفات التعامل مع الدوال التي تأخذ معاملات، وذلك باستخدام *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()

إنشاء Decorators ذات معاملات

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

# 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()

حالات الاستخدام الشائعة لـ Decorators

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

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

Decorators المضمّنة في Python

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

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

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

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

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

ماذا تعلمنا؟

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

• ما decorators وكيف تعمل في Python.
• كيفية إنشاء واستخدام decorators أساسية ومُعامَلة ومتسلسلة.
• حالات الاستخدام الشائعة وdecorators المضمّنة في Python.

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