preservando as assinaturas das funções decoradas

decoradores são uma ferramenta poderosa para aprimorar a funcionalidade das funções python. No entanto, às vezes eles podem obscurecer a assinatura da função original. Isso pode ser problemático para documentação, depuração e ferramentas automatizadas. def G (*args, ** kwargs): args = [int (x) para x em args] kwargs = dict ((k, int (v)) para k, v em kwargs.items ()) Retornar f (*args, ** kwargs) Retornar g

Enquanto a decoração funciona conforme o esperado, a assinatura da função decorada é substituída por " args, *kwargs", perdendo informações sobre os argumentos originais. Satisfactory:

copiando manualmente a assinatura no docstring.

def args_as_ints(f):
    def g(*args, **kwargs):
        args = [int(x) for x in args]
        kwargs = dict((k, int(v)) for k, v in kwargs.items())
        return f(*args, **kwargs)
    return g

importar decorador @decorator.Decorator def args_as_ints (f, *args, ** kwargs): args = [int (x) para x em args] kwargs = dict ((k, int (v)) para k, v em kwargs.items ()) Retornar f (*args, ** kwargs)

Este decorador preserva a assinatura da função original, passando -a como argumentos para a função embrulhada. def funny_function (x, y, z = 3): "" "Calcula x*y 2*z" "" Retornar x*y 2*z

agora, a função decorada engraçada_function mantém sua assinatura original:

>> Ajuda (Funny_function) Ajuda na função Funny_function no módulo __main__: Funny_function (x, y, z = 3) Calcula x*y 2*z

python 3.4:
• para python 3.4 e acima, functools.wraps fornece uma solução semelhante:
importar functools def args_as_ints (func): @functools.wraps (func) DEF Wrapper (*args, ** kwargs): args = [int (x) para x em args] kwargs = dict ((k, int (v)) para k, v em kwargs.items ()) Retornar func (*args, ** kwargs) Return wrapper

usando essas técnicas, os decoradores podem aprimorar a funcionalidade da função enquanto preservam suas assinaturas originais, garantindo clareza e consistência na base de código.