CKTIS / Python
dataclasses.replace
Tworzy nową instancję tego samego typu z podanymi zmianami pól.
Wersja: Python 3.14; repository image, production runtime not attested
Składnia
dataclasses.replace(obj, /, **changes)Tworzy nową instancję tego samego typu z podanymi zmianami pól.
CPython 3.14.9 zgłasza TypeError zarówno dla pola init=False, jak i przy pominięciu wymaganego InitVar. Dokumentacja 3.14 dla pierwszego przypadku wymienia ValueError. Wygenerowany inicjalizator ponownie wywołuje __post_init__, więc wartości pochodne mogą zostać przeliczone. Zmiana pola init=False zgłasza TypeError, a InitVar bez wartości domyślnej trzeba podać.
Nowy Job ma priorytet 8, a pierwotny nadal 2.
from dataclasses import dataclass, field, replace
@dataclass
class Price:
base: int
total: int = field(init=False)
def __post_init__(self):
self.total = self.base * 2
p = Price(3)
assert replace(p, base=5).total == 10 and p.total == 6
try:
replace(p, total=99)
except TypeError:
pass
else:
raise AssertionError
from dataclasses import InitVar
@dataclass
class Seed:
value: InitVar[int]
try:
replace(Seed(4))
except TypeError:
pass
else:
raise AssertionError
Przykłady
import dataclasses
@dataclasses.dataclass(frozen=True)
class Job:
priority: int
a = Job(2)
b = dataclasses.replace(a, priority=8)
print(a.priority, b.priority, a is b)
Wynik
2 8 False
Nowy Job ma priorytet 8, a pierwotny nadal 2.