Unlock Python Power: Master Decorators in Simple Steps

1. What is a decorator

Decorators are compared to adding a longer, warmer layer over underwear: they keep the original function’s purpose while providing extra functionality, much like turning underwear into pants that also keep you warm.

2. Four steps to understand decorators

Understanding decorators requires four prerequisite concepts.

1) Functions are objects

def message(word='hello'):
    return word.upper() + '!'
print message()
# HELLO!
my_message = message
print my_message
# <function message at 0x...>
print my_message()
# HELLO!

2) Functions can be nested

def show():
    print 'Run in show()'
    def message(word='hello'):
        return word
    print message()
show()
# Run in show()
# hello

3) Functions can be returned

Functions can be returned as values from other functions (illustrated with an image in the original article).

4) Functions can be passed as arguments

Functions can be supplied to other functions as parameters (illustrated with an image in the original article).

3. The real nature of decorators

After the previous steps, it becomes clear that a decorator is a wrapper that adds behavior before or after a function runs without modifying the original function.

a_stand_alone_function()
# I am a stand alone function,don't you dare modify me
a_stand_alone_function_decorated = my_new_decorator(a_stand_alone_function)
a_stand_alone_function_decorated()
# Before the function runs
# I am a stand alone function,don't you dare modify me
# After the function runs

Using a decorator

Applying a decorator is as simple as prefixing a function with @my_new_decorator, which is Pythonic and concise.

another_stand_alone_function = my_new_decorator(another_stand_alone_function)

4. Why use decorators

Decorators improve code maintainability and aesthetics, promote encapsulation, reduce redundancy, and make future extensions easier. Web frameworks like Django and Flask heavily rely on decorators for clean code organization.

Example: combining bold and italic decorators to format a string.

@makeitalic
@makebold
def word():
    return "hello"
print word()
# Output: <i><b>hello</b></i>

The order of decorators matters; swapping them changes the output.

Overall, this summary provides a concise yet comprehensive guide to Python decorators, their underlying concepts, practical usage, and benefits.