Erhalt von Unterschriften dekorierter Funktionen

Dekoratoren sind ein mächtiges Werkzeug zur Verbesserung der Funktionalität von Python -Funktionen. Sie können jedoch manchmal die Signatur der ursprünglichen Funktion verdecken. Dies kann für Dokumentation, Debugging und automatisierte Tools problematisch sein.

Problem:

betrachten einen generischen Dekorateur, der alle Argumente in Abgänge umgeht:

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

definiten_as_ints (f): def g (*args, ** kwargs): args = [int (x) für x in args] kwargs = dict ((k, int (v)) für k, v in kwargs.items ()) Rückgabe f (*args, ** kwargs) return g

Während die Dekoration wie erwartet funktioniert, wird die Unterschrift der dekorierten Funktion durch " args,

*kwargs" ersetzt, in dem Informationen über die ursprünglichen Argumente verlieren. Befriedigend:

kopieren Sie die Unterschrift manuell in den Dokument.

Erstellen eines neuen Dekorators für jede bestimmte Unterschrift.

manuell die dekorierte Funktion mit dem Execing. Elegante Lösung:
• importieren Dekorateur @Decorator.Decorator def args_as_ints (f, *args, ** kwargs): args = [int (x) für x in args] kwargs = dict ((k, int (v)) für k, v in kwargs.items ()) return f (*args, ** kwargs)
• Dieser Dekorateur bewahrt die Unterschrift der Originalfunktion, indem sie sie als Argumente an die verpackte Funktion übergeben. Def Funny_function (x, y, z = 3): "" "Berechnet x*y 2*z" "" " Rückgabe x*y 2*z

Jetzt behält die dekorierte Funktion Funny_function ihre ursprüngliche Signatur:

>>> help (Funny_function) Hilfe bei der Funktion Funny_function im Modul __main__: Funny_function (x, y, z = 3) Berechnet x*y 2*z

python 3.4:

import decorator

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

functools importieren Def args_as_ints (func): @functools.wraps (func) Def -Wraper (*args, ** kwargs): args = [int (x) für x in args] kwargs = dict ((k, int (v)) für k, v in kwargs.items ()) Rückgabefunktion (*args, ** kwargs) Return Wrapper

Durch die Verwendung dieser Techniken können Dekorateure die Funktionsfunktionalität verbessern und gleichzeitig ihre ursprünglichen Unterschriften bewahren und Klarheit und Konsistenz in der Codebasis sicherstellen.