Criando e encadeando decoradores de funções em Python

Aprimorando funções Python com decoradores

Em Python, os decoradores são uma ferramenta poderosa para modificar o comportamento de funções ou métodos. Eles permitem que os desenvolvedores agrupem funcionalidades adicionais em torno de uma função existente de maneira limpa e legível. Ao entender como criar e encadear decoradores, você pode melhorar bastante a modularidade e a legibilidade do seu código.

Este artigo irá guiá-lo através do processo de criação de dois decoradores específicos: um para deixar o texto em negrito e outro para deixar o texto em itálico. Também demonstraremos como encadear esses decoradores para obter o resultado desejado. Ao final deste tutorial, você será capaz de chamar uma função simples e receber uma string formatada com tags HTML em negrito e itálico.

Compreendendo os decoradores de funções Python

Os scripts fornecidos demonstram como criar e encadear decoradores de funções em Python para modificar o comportamento das funções. Um decorador em Python é definido usando o def palavra-chave para criar uma função que recebe outra função como argumento e retorna uma nova função. O make_bold decorator envolve o resultado da função que decora com tags HTML em negrito usando formatação f-string: f"<b>{func()}</b>". Da mesma forma, o make_italic decorator envolve o resultado em tags em itálico: f"<i>{func()}</i>". Quando esses decoradores são aplicados a uma função usando o @decorator_name sintaxe, eles modificam a saída da função adicionando as respectivas tags HTML.

O segundo script introduz uma abordagem mais versátil criando uma função de ordem superior, add_html_tag, que gera decoradores para qualquer tag HTML especificada. Esta função recebe uma tag HTML como argumento e retorna um decorador que envolve a saída da função na tag especificada: f"<{tag}>{func()}</{tag}>". Usando @add_html_tag("b") e @add_html_tag("i"), podemos encadear esses decoradores para envolver a saída do say_hello funcionam em tags de negrito e itálico, resultando no desejado "Olá". Esses exemplos ilustram o poder e a flexibilidade dos decoradores Python em aprimorar e personalizar o comportamento da função de maneira limpa e reutilizável.

def make_bold(func):
    def wrapper():
        return f"<b>{func()}</b>"
    return wrapper

def make_italic(func):
    def wrapper():
        return f"<i>{func()}</i>"
    return wrapper

@make_bold
@make_italic
def say():
    return "Hello"

print(say())

def add_html_tag(tag):
    def decorator(func):
        def wrapper():
            return f"<{tag}>{func()}</{tag}>"
        return wrapper
    return decorator

@add_html_tag("b")
@add_html_tag("i")
def say_hello():
    return "Hello"

print(say_hello())

Técnicas avançadas de decorador Python

Além da simples modificação de funções, os decoradores Python oferecem uma maneira poderosa de aprimorar a capacidade de reutilização e manutenção do código. Um caso de uso avançado são os decoradores parametrizados, que permitem que os decoradores aceitem argumentos. Esta técnica foi ilustrada com o add_html_tag decorador nos exemplos anteriores. Ao definir um decorador que gera outros decoradores, podemos criar estruturas de código altamente flexíveis e reutilizáveis. Decoradores parametrizados nos permitem passar parâmetros para o próprio decorador, permitindo modificações dinâmicas e específicas do contexto no comportamento da função.

Outro aspecto importante dos decoradores é a sua capacidade de manter metadados de funções. Quando uma função é encapsulada por um decorador, seus metadados, como nome e docstring, podem ser perdidos. Para preservar esses metadados, o Python functools.wraps é usado dentro do decorador. Ao aplicar @functools.wraps para a função wrapper, os metadados da função original são copiados, garantindo que as ferramentas que dependem desses metadados, como geradores de documentação, continuem a funcionar corretamente. Além disso, os decoradores podem ser empilhados, conforme mostrado na imagem @make_bold e @make_italic exemplos, para aplicar múltiplas camadas de modificação de comportamento de maneira limpa e legível.