View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
View All
  1. Home
python

Python Tutorials - Elevate Your Coding Skills with Comprehensive Tutorials

Discover Python tutorials covering everything from the basics to advanced topics. Whether you're new to programming or looking to level up your skills, our tutorials will guide you every step of the way

  • 201 Lessons
  • 33 Hours
right-top-arrow

Tutorial Playlist

200 Lessons
78

Python Decorators

Updated on 23/03/20241,936 Views

Introduction

Python decorators are a powerful and elegant programming technique used to change or improve the behavior of functions or methods. They are executed as functions and are frequently used to encapsulate basic operations like logging, authentication, and memoization. Decorators work by enveloping the target function, allowing for the smooth insertion of pre- and post-processing logic.

A decorator is a function that takes a function as input and returns a new function that generally extends or modifies the original functionality. This is accomplished by constructing a wrapper function within the decorator that calls the original function while potentially modifying it. Decorators are called by placing the "@" symbol followed by the name of the decorator function above the function to be modified.

This strategy promotes code modularity by allowing developers to isolate concerns and reuse code across multiple functions without duplicating code. Decorators also improve readability by condensing common portions of code and supporting a clean and orderly structure. Their adaptability lends itself to a wide range of applications, from access control to execution time measurement.

In this tutorial, let's delve into detail about Python built-in decorators, decorators and generators in Python, Python multiple decorator, and other Python decorators example.

Overview

Decorators in Python are functions that alter the behavior of other functions or methods. They enclose the target function and allow you to include pre- or post-processing logic. Decorators improve code modularity by isolating concerns and encouraging reuse. They are identified by "@" followed by the name of the decorator function above the target function. This method automates functions such as logging, authentication, and caching, resulting in cleaner, more structured code.

What is a Decorator in Python?

In Python, a Decorator is a dynamic and adaptable programming construct that actively enhances the behavior of functions or methods. It works by enclosing additional functionality around the main logic, improving code modularity, and encouraging concern separation.

Decorators are skilled at dealing with cross-cutting issues including logging, caching, access control, and performance optimization. For example, by using a logging decorator, one can easily implement consistent logging capability across several methods without duplicating code.

Furthermore, decorators are critical in increasing reusability. This is accomplished by enabling developers to isolate and combine frequently used capabilities into independent decorators that are applied to various functions. This removes redundancy while also improving code maintainability and readability.

Decorators' intrinsic flexibility allows for the implementation of complicated customizations while retaining a clean and uncluttered core function. This is especially useful in situations when changing the basic logic directly might result in complex code. Developers can implement sophisticated features or behaviors without sacrificing the original function's clarity by wrapping the target function with a decorator.

Python decorators are a dynamic programming method that enables developers to actively modify and improve the behavior of functions. Decorators provide a substantial contribution to the maintenance of modular, legible, and efficient codebases by encapsulating auxiliary capabilities and fostering reusability.

Types of Decorators in Python and Examples

Before we delve into the different types of decorators, let us first check out a simple function decorator:

Code:

def my_decorator(func):
    def wrapper():
        print("Something is happening before the function is called.")
        func()
        print("Something is happening after the function is called.")
    return wrapper
@my_decorator
def say_hello():
    print("Hello!")
say_hello()

In this example, my_decorator is a simple function decorator that adds behavior before and after the decorated function say_hello is called.

Chaining Decorators

Code:

def decorator1(func):
    def wrapper():
        print("Decorator 1 before function.")
        func()
        print("Decorator 1 after function.")
    return wrapper
def decorator2(func):
    def wrapper():
        print("Decorator 2 before function.")
        func()
        print("Decorator 2 after function.")
    return wrapper
@decorator1
@decorator2
def my_function():
    print("My function")
my_function()

You can chain multiple decorators by stacking them on top of a function using the @ symbol. The order in which decorators are applied matters.

Decorators With Arguments

Code:

def repeat(n):
    def decorator(func):
        def wrapper(*args, **kwargs):
            for _ in range(n):
                func(*args, **kwargs)
        return wrapper
    return decorator
@repeat(3)
def say_hello(name):
    print(f"Hello, {name}!")
say_hello("Alice")

Decorators can accept arguments. In this example, the repeat decorator takes an argument n and repeats the decorated function's execution n times.

Class Decorators

Code:

class MyDecorator:
    def __init__(self, func):
        self.func = func
    def __call__(self):
        print("Something is happening before the function is called.")
        self.func()
        print("Something is happening after the function is called.")
@MyDecorator
def say_hello():
    print("Hello!")
say_hello()

Decorators can also be implemented as classes. A decorator class must define a __init__ method to accept the decorated function and a __call__ method to define the additional behavior.

Stateful Decorators

Code:

def counter(func):
    def wrapper(*args, **kwargs):
        wrapper.count += 1
        print(f"Function {func.__name__} has been called {wrapper.count} times.")
        func(*args, **kwargs)
    wrapper.count = 0
    return wrapper
@counter
def say_hello():
    print("Hello!")
say_hello()
say_hello()

Stateful decorators can maintain and update internal state. In this example, the counter decorator counts how many times the decorated function is called.

Classes as Decorators

Code:

class MyClassDecorator:
    def __init__(self, func):
        self.func = func
    def __call__(self, *args, **kwargs):
        print("Before the function is called.")
        self.func(*args, **kwargs)
        print("After the function is called.")
@MyClassDecorator
def say_hello():
    print("Hello!")
say_hello()

Class decorators can also be used with class methods. The class must define a __call__ method to achieve this.

What if a Function Returns Something or an Argument is Passed to the Function?

When you're working with decorators in Python, you may encounter situations where the decorated function returns something or takes arguments. Decorators can handle these scenarios, and here's how:

Function Returns Something

If the decorated function returns a value, the decorator should capture and return that value. You can do this by using the *args and **kwargs syntax in the wrapper function to accept any arguments and keyword arguments that the decorated function might return.

Code:

def my_decorator(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)  # Call the decorated function
        return result  # Return the result
    return wrapper
@my_decorator
def add(a, b):
    return a + b
result = add(3, 5)
print(result)  # Output: 8
In this example, the my_decorator decorator wraps the add function. It captures the result returned by add and returns it from the wrapper function.

Arguments Passed to the Function

If the decorated function takes arguments, the decorator should accept those arguments and pass them to the decorated function. You can do this by using the *args and **kwargs syntax in the wrapper function.

Code:

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print(f"Arguments passed: {args}, {kwargs}")
        result = func(*args, **kwargs)  # Call the decorated function with arguments
        return result
    return wrapper
@my_decorator
def multiply(a, b):
    return a * b
result = multiply(3, 5)
# Output:
# Arguments passed: (3, 5), {}

In this example, the my_decorator decorator captures the arguments (3, 5) passed to the multiply function and prints them before calling multiply.

So, decorators can seamlessly handle functions that return values or accept arguments. The *args and **kwargs syntax allow decorators to work with functions of varying signatures, making them flexible and versatile for a wide range of use cases.

Conclusion

Decorators are a testimony to Python's versatility and elegance in the programming world. These dynamic structures have shown to be important tools for improving function behavior and structure, demonstrating their value in a plethora of circumstances.

Decorators are excellent at encouraging code modularity and separation of concerns, allowing developers to encapsulate common operations in a concise and reusable manner. Decorators decrease code duplication while simultaneously improving codebase maintainability by abstracting away cross-cutting issues such as logging, caching, and access control.

Decorators remain a robust tool for solving a combination of programming difficulties as Python continues to be a language of choice for different applications. Their ability to smoothly incorporate additional functionality, encourage code reusability, and maintain a clean and structured codebase highlights their importance. Decorators are a tribute to Python's versatility and its community's resourcefulness in building beautiful solutions in the ever-changing world of software development.

FAQs

1. What is the best use of a decorator in Python?

Decorators are most commonly used in Python to address cross-cutting issues such as logging, authentication, and caching. They allow for the modular addition of functionality to functions or methods, which improves code readability and reusability while keeping the core logic focused and clean.

2. What are the most important decorators in Python?

Some of the most prominent decorators in Python are:

  • **@staticmethod**: Defines a static method within a class that may be invoked directly on the class without the need for an instance.
  • **@classmethod**: Defines a class method that may access and alter class-level attributes.
  • **@property**: Converts a method into a read-only attribute, allowing restricted access to an object's internal state while hiding implementation details.
  • **@abstractmethod**: Marks a method inside an abstract base class as abstract, requiring subclasses to implement it.
  • **@decorator_name**: Custom decorators can be built to meet particular needs.

3. When not to use Python decorators?

Use Python decorators sparingly in cases where their complexity may obfuscate code clarity, especially for simple and easy procedures. Overuse of decorators in a codebase with few cross-cutting issues may result in excessive abstraction and impede code understanding. Furthermore, if the decorator logic has a substantial influence on performance, it is recommended to examine alternate techniques to accomplish the needed functionality while maintaining execution efficiency.

Ready to challenge yourself? Take our Free Python Quiz!

image
right-top-arrowright-top-arrow
Need More Help? Talk to an Expert
form image
+91
*
By clicking, I accept theT&Cand
Privacy Policy
image
Join 10M+ Learners & Transform Your Career
Learn on a personalised AI-powered platform that offers best-in-class content, live sessions & mentorship from leading industry experts.
right-top-arrowleft-top-arrow

upGrad Learner Support

Talk to our experts. We’re available 24/7.

text

Indian Nationals

1800 210 2020

text

Foreign Nationals

+918045604032

Disclaimer

upGrad does not grant credit; credits are granted, accepted or transferred at the sole discretion of the relevant educational institution offering the diploma or degree. We advise you to enquire further regarding the suitability of this program for your academic, professional requirements and job prospects before enrolling. .