إنشاء وتسلسل ديكورات الوظائف في بايثون

تعزيز وظائف بايثون مع الديكور

في بايثون، تعتبر أدوات الديكور أداة قوية لتعديل سلوك الوظائف أو الأساليب. إنها تسمح للمطورين بتغليف وظائف إضافية حول وظيفة موجودة بطريقة نظيفة وقابلة للقراءة. من خلال فهم كيفية إنشاء أدوات تزيين وتسلسلها، يمكنك تحسين نمطية وسهولة قراءة التعليمات البرمجية الخاصة بك بشكل كبير.

سترشدك هذه المقالة خلال عملية إنشاء اثنين من أدوات الديكور المحددة: أحدهما لجعل النص غامقًا والآخر لجعل النص مائلًا. سنوضح أيضًا كيفية ربط هذه الديكورات لتحقيق النتيجة المطلوبة. بحلول نهاية هذا البرنامج التعليمي، ستكون قادرًا على استدعاء دالة بسيطة وتلقي سلسلة منسقة تحتوي على علامات HTML العريضة والمائلة.

فهم مصممي وظائف بايثون

توضح البرامج النصية المقدمة كيفية إنشاء وتسلسل أدوات تزيين الوظائف في بايثون لتعديل سلوك الوظائف. يتم تعريف الديكور في بايثون باستخدام def الكلمة الأساسية لإنشاء دالة تأخذ دالة أخرى كوسيطة وترجع دالة جديدة. ال make_bold يغلف الديكور نتيجة الوظيفة التي يزينها بعلامات HTML العريضة باستخدام تنسيق f-string: f"<b>{func()}</b>". وبالمثل، فإن make_italic يقوم الديكور بتغليف النتيجة بعلامات مائلة: f"<i>{func()}</i>". عندما يتم تطبيق هذه الديكورات على دالة باستخدام @decorator_name بناء الجملة، يقومون بتعديل مخرجات الوظيفة عن طريق إضافة علامات HTML المعنية.

يقدم البرنامج النصي الثاني نهجا أكثر تنوعا من خلال إنشاء وظيفة ذات ترتيب أعلى، add_html_tag، الذي يقوم بإنشاء أدوات تزيين لأي علامة HTML محددة. تأخذ هذه الوظيفة علامة HTML كوسيطة وتقوم بإرجاع مصمم يغلف مخرجات الوظيفة في العلامة المحددة: f"<{tag}>{func()}</{tag}>". باستخدام @add_html_tag("b") و @add_html_tag("i")، يمكننا ربط هذه الديكورات لتغليف مخرجات الملف say_hello وظيفة في كل من العلامات الغامقة والمائلة، مما يؤدي إلى المطلوب "مرحبًا". توضح هذه الأمثلة قوة ومرونة مصممي بايثون في تعزيز وتخصيص سلوك الوظيفة بطريقة نظيفة وقابلة لإعادة الاستخدام.

def make_bold(func):
    def wrapper():
        return f"<b>{func()}</b>"
    return wrapper

def make_italic(func):
    def wrapper():
        return f"<i>{func()}</i>"
    return wrapper

@make_bold
@make_italic
def say():
    return "Hello"

print(say())

def add_html_tag(tag):
    def decorator(func):
        def wrapper():
            return f"<{tag}>{func()}</{tag}>"
        return wrapper
    return decorator

@add_html_tag("b")
@add_html_tag("i")
def say_hello():
    return "Hello"

print(say_hello())

تقنيات بايثون للديكور المتقدمة

إلى جانب التعديل البسيط للوظيفة، توفر أدوات تزيين Python طريقة قوية لتعزيز إمكانية إعادة استخدام التعليمات البرمجية وقابلية صيانتها. إحدى حالات الاستخدام المتقدمة هي أدوات الديكور ذات المعلمات، والتي تسمح لمصممي الديكور بقبول الوسائط. تم توضيح هذه التقنية باستخدام add_html_tag مصمم الديكور في الأمثلة السابقة. من خلال تحديد مصمم ديكور يقوم بإنشاء ديكورات أخرى، يمكننا إنشاء هياكل تعليمات برمجية مرنة للغاية وقابلة لإعادة الاستخدام. تمكننا أدوات الديكور ذات المعلمات من تمرير المعلمات إلى مصمم الديكور نفسه، مما يسمح بإجراء تعديلات ديناميكية ومحددة السياق على سلوك الوظيفة.

جانب آخر مهم من مصممي الديكور هو قدرتهم على الحفاظ على البيانات الوصفية للوظيفة. عندما يتم تغليف دالة بواسطة أحد مصممي الديكور، فمن الممكن أن يتم فقدان البيانات الوصفية الخاصة بها، مثل اسمها وسلسلة المستندات الخاصة بها. للحفاظ على هذه البيانات الوصفية، يجب استخدام Python functools.wraps يستخدم داخل الديكور. عن طريق التقديم @functools.wraps إلى وظيفة التغليف، يتم نسخ البيانات التعريفية للوظيفة الأصلية، مما يضمن استمرار الأدوات التي تعتمد على هذه البيانات التعريفية، مثل مولدات الوثائق، في العمل بشكل صحيح. بالإضافة إلى ذلك، يمكن تكديس أدوات الديكور، كما هو موضح مع @make_bold و @make_italic أمثلة، لتطبيق طبقات متعددة من تعديل السلوك بطريقة نظيفة وقابلة للقراءة.