WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

functools.update_wrapper

Ändert die Metadaten des Wrappers und gibt denselben Wrapper zurück.

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

Syntax

functools.update_wrapper(wrapper, wrapped, assigned=functools.WRAPPER_ASSIGNMENTS, updated=functools.WRAPPER_UPDATES)

Ändert die Metadaten des Wrappers und gibt denselben Wrapper zurück.

Seit 3.12 kopiert update_wrapper standardmäßig auch __type_params__ einer generischen Funktion. Dieselbe Regel gilt über wraps. assigned-Attribute werden kopiert, updated-Attribute, standardmäßig __dict__, mit ihren Gegenstücken zusammengeführt. __wrapped__ verweist auf die unmittelbar umhüllte Funktion.

Nach Übernahme des Namens source bleibt der Rumpf von proxy erhalten und liefert für 3 die 8, das Original 4.

from functools import update_wrapper
def origin(x): return x+1
origin.tag = "v1"
def proxy(x): return 2*origin(x)
assert update_wrapper(proxy, origin) is proxy
assert proxy.__name__ == "origin" and proxy.tag == "v1" and proxy.__wrapped__ is origin
assert proxy(3) == 8 and proxy.__wrapped__(3) == 4
from functools import wraps
def ident[T](x: T) -> T: return x
def proxy2(*args): return ident(*args)
update_wrapper(proxy2, ident)
@wraps(ident)
def proxy3(*args): return ident(*args)
assert proxy2.__type_params__ is proxy3.__type_params__ is ident.__type_params__

Beispiele

import functools
def source(n): return n + 1
def proxy(n): return 2 * source(n)

functools.update_wrapper(proxy, source)
print(proxy.__name__, proxy(3), proxy.__wrapped__(3))

Ergebnis

source 8 4

Nach Übernahme des Namens source bleibt der Rumpf von proxy erhalten und liefert für 3 die 8, das Original 4.

Quellen