Naveguei em alguns tutoriais online sobre decoradores. Estou tendo problemas para ver seus benefícios em exemplos simples. Aqui está um exemplo comum de uma função que precisa ser decorada, retirada desta página :
# Unelegant decoration
#---------------------
def make_pretty(func):
def inner():
print("I got decorated")
func()
return inner
def ordinary():
print("I am ordinary")
decorated_func = make_pretty(ordinary)
decorated_func()
# Output
#-------
# I got decorated
# I am ordinary
O benefício dos decoradores é descrito da seguinte forma: “Em vez de atribuir a chamada de função a uma variável, o Python fornece uma maneira muito mais elegante de obter essa funcionalidade”.
# Elegant decoration
#-------------------
@make_pretty
def ordinary():
print("I am ordinary")
ordinary()
# Output
#-------
# I got decorated
# I am ordinary
Outros tutoriais fornecem exemplos e motivações semelhantes, por exemplo, aqui .
A dificuldade que tenho com esta explicação é que ela não se enquadra exatamente na intenção de adicionar funcionalidade à função a ser decorada sem modificá-la (outra explicação frequente dos decoradores). No exemplo acima, "comum ()" não decorado não está mais disponível, portanto decorá-lo não deixa de fato a função original disponível para uso em situações onde a decoração não é necessária ou desejada.
O outro motivo mais específico é maior elegância ao "não atribuir a chamada de função a uma variável". Para o código "Decoração deselegante", entretanto, isso é facilmente alcançado sem o código de "Decoração elegante" acima:
make_pretty(ordinary)()
# Output
#-------
# I got decorated
# I am ordinary
Os tutoriais normalmente descrevem decoradores em casos em que funções recebem argumentos. Não consigo entender o motivo deles porque não consigo nem entender o benefício no caso mais simples acima. As perguntas e respostas do SO também falam sobre casos de uso práticos (por exemplo, aqui ), mas é difícil acompanhar o motivo para os decoradores, novamente quando o motivo no caso mais simples acima não é claro.
É possível afirmar em linguagem simples qual é o benefício no caso mais simples acima, sem argumentos de função? Ou será que o benefício só ficará claro se, de alguma forma, descobrirmos os casos mais complicados?
O objetivo dos decoradores é semelhante à maioria das outras funções: modularidade e “não se repita”.
Se você tiver um monte de funções que devem imprimir determinadas mensagens antes e depois de fazerem seu trabalho real, você poderá colocar
print()
chamadas em cada uma delas. Mas isso é tedioso e repetitivo. Então, em vez disso, você define um decorador que usa ao definir cada uma dessas funções, ele adicionará essasprint()
chamadas a todas elas automaticamente.Isso também fornece modularidade. Se quiser alterar as mensagens que são impressas, basta fazê-lo em um só lugar, o decorador, ao invés de ter que editar todas as funções.
Muitos decoradores são significativamente mais complexos do que o exemplo do brinquedo que você mostra. Considere o decorador embutido
@property
usado ao definir propriedades em classes, ele transforma o método nomeado em uma propriedade que pode ser usada como um atributo. Ou@functools.cache
adiciona cache automático à função que você está definindo. Decoradores em bibliotecas como essas facilitam a adição de recursos às funções que você está escrevendo.Observe que os decoradores nem sempre precisam aumentar o comportamento da função. Eles podem deixar o comportamento da função inalterado, mas fazer algum processamento adicional. Por exemplo, em Flask ou discord.py, você usa decoradores para definir rotas de servidor web e comandos discord. Eles adicionam a função decorada a uma tabela de roteamento usada pelas bibliotecas ao processar mensagens recebidas, mas você também pode chamá-las diretamente.