WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

functools.wraps

Wird beim Schreiben eines Dekorators auf die innere Wrapperfunktion angewandt.

Version: Python 3.14; repository image, production runtime not attested

Syntax

@functools.wraps(wrapped)

Wird beim Schreiben eines Dekorators auf die innere Wrapperfunktion angewandt.

Über update_wrapper beziehen sich Name, Dokumentation und weitere Metadaten auf die umhüllte Funktion. Der Aufruf führt weiterhin den Wrapper aus, während __wrapped__ das direkte Original zur Inspektion zeigt.

Das Beispiel schreibt add, 8, 4.

from functools import wraps
from inspect import signature
def outer(f):
    @wraps(f)
    def wrapped(*args, **kw):
        return 2 * f(*args, **kw)
    return wrapped
@outer
def inc(x: int): return x+1
assert inc.__name__ == "inc" and str(signature(inc)) == "(x: int)"
assert inc(3) == 8 and inc.__wrapped__(3) == 4

Beispiele

import functools
def twice(func):
    @functools.wraps(func)
    def wrapper(n): return 2 * func(n)
    return wrapper

@twice
def add(n): return n + 1

print(add.__name__, add(3), add.__wrapped__(3))

Ergebnis

add 8 4

Das Beispiel schreibt add, 8, 4.

Quellen