Conteúdo do curso Lição 63 de 250 · Código pythônico, testes e projeto final
Código pythônico, testes e projeto final

Decorators

Um decorator é uma função que envolve outra função para acrescentar comportamento, sem mudar o corpo da original. Você aplica um com a sintaxe @ colocada em cima de um def.

O formato é sempre o mesmo: receba uma função, defina um wrapper interno que faz algo a mais e depois chama a original, e retorne o wrapper.

def shout(func):
    def wrapper(*args, **kwargs):
        result = func(*args, **kwargs)
        return result.upper()
    return wrapper

@shout
def greet(name):
    return f"hi {name}"

print(greet("ada"))   # HI ADA

Escrever @shout acima de greet é só um atalho para greet = shout(greet). A partir daí, o nome greet aponta para o wrapper.

O *args, **kwargs no wrapper permite que ele aceite quaisquer argumentos que a original recebe e os repasse. Isso mantém o decorator genérico.

functools.wraps

Envolver substitui a função, então o nome e a docstring da original ficam escondidos atrás de wrapper. Corrija isso decorando o próprio wrapper com functools.wraps(func), que copia os metadados. Sempre faça isso em decorators de verdade:

import functools

def double(func):
    @functools.wraps(func)
    def wrapper(*args, **kwargs):
        return func(*args, **kwargs) * 2
    return wrapper

@double
def add(a, b):
    """Add two numbers."""
    return a + b

print(add(3, 4))        # 14
print(add.__name__)     # 'add'  (preserved by wraps)
Sua vez

Escreva um decorator double que dobra o valor de retorno de qualquer função que ele envolve. Use functools.wraps para que a função envolvida mantenha seu __name__. Depois aplique-o com @double a uma função add(a, b) que retorna a + b, para que add(3, 4) dê 14 e add.__name__ continue sendo "add".

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.