डेकोरेटर

decorator पाइथन की एक शक्तिशाली सुविधा है, जो आपको फ़ंक्शन या विधियों के व्यवहार को बदलने देती है। इनका उपयोग अक्सर फ़ंक्शन के कोड में बदलाव किए बिना उसमें नई कार्यक्षमता जोड़ने के लिए किया जाता है।

इस पाठ में आप सीखेंगे कि decorator क्या होते हैं, उनका उपयोग कैसे करें और अपने 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()

जब आप decorator का उपयोग करते हैं, तो पाइथन मूल फ़ंक्शन को decorator द्वारा लौटाए गए wrapper फ़ंक्शन से बदल देता है।

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

decorator ऐसे फ़ंक्शन के साथ काम कर सकते हैं, जो तर्क लेते हैं। इसके लिए wrapper फ़ंक्शन में *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))

आप एक ही फ़ंक्शन पर कई decorator का उपयोग कर सकते हैं। उन्हें ऊपर से नीचे तक, जिस क्रम में वे दिखाई देते हैं, उसी क्रम में लागू किया जाता है:

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

पैरामीटर वाले decorator तर्क स्वीकार करते हैं और अधिक लचीली कार्यक्षमता प्रदान करते हैं:

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

decorator का सामान्यतः इन कार्यों के लिए उपयोग किया जाता है:

• फ़ंक्शन कॉल और उनके तर्कों का लॉग दर्ज करना।
• फ़ंक्शन के निष्पादन समय को मापना।
• पहुँच नियंत्रण करना, जैसे उपयोगकर्ता की अनुमतियों की जाँच करना।
• प्रदर्शन सुधारने के लिए परिणामों को कैश में रखना।

Python में कुछ अंतर्निर्मित decorator उपलब्ध हैं, जिनमें ये शामिल हैं:

• @staticmethod: स्थैतिक विधि परिभाषित करता है।
• @classmethod: वर्ग विधि परिभाषित करता है।
• @property: गुण विधि परिभाषित करता है।

इन गलतियों से बचें:

• मूल फ़ंक्शन का नाम और दस्तावेज़-स्ट्रिंग सुरक्षित न रखना (functools.wraps का उपयोग करें)।
• सरल कार्यों के लिए अनावश्यक रूप से decorator का उपयोग करना।
• wrapper फ़ंक्शन में तर्कों को संभालना भूल जाना।

इस पाठ में आपने सीखा:

• decorator क्या होते हैं और Python में कैसे काम करते हैं।
• मूल, पैरामीटर वाले और श्रृंखलाबद्ध decorator कैसे बनाए और उपयोग किए जाते हैं।
• Python में decorator के सामान्य उपयोग और अंतर्निर्मित decorator।

बहुत अच्छा! अब अगले विषय पर चलते हैं।