Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

dataclasses.dataclass

Na podstawie adnotacji pól generuje domyślnie inicjalizator, reprezentację i porównanie wartości.

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

Składnia

@dataclasses.dataclass(frozen=True)

Na podstawie adnotacji pól generuje domyślnie inicjalizator, reprezentację i porównanie wartości.

Wygenerowana metoda nie zapewnia haszowalności wszystkich wartości pól. Dla Item([]) wywołanie hash podnosi TypeError przez listę uczestniczącą w obliczeniu. Bez własnego __hash__ kombinacja eq=True i frozen=True generuje skrót, samo eq=True dla klasy mutowalnej blokuje haszowanie, a eq=False pozostawia regułę klasy bazowej. unsafe_hash=True wymusza wygenerowanie metody. slots=True zwraca nową klasę. Pola baz są zbierane w odwrotnej kolejności MRO, a nadpisane pole zachowuje pozycję. Wygenerowana równość porównuje wybrane pola obiektów dokładnie tej samej klasy. Dwa Point(4) są więc równe.

Przy frozen=True przypisanie p.x zgłasza FrozenInstanceError, choć lista przechowywana w zamrożonym polu nadal może się zmieniać.

from dataclasses import dataclass, FrozenInstanceError
@dataclass(frozen=True)
class Item:
    tags: list
x = Item([])
x.tags.append("ok")
assert x == Item(["ok"])
try:
    x.tags = []
except FrozenInstanceError:
    pass
else:
    raise AssertionError
class C: pass
assert dataclass(slots=True)(C) is not C
assert dataclass()(type("A", (), {})).__hash__ is None
assert callable(dataclass(frozen=True)(type("B", (), {})).__hash__)
try:
    hash(Item([]))
except TypeError:
    pass
else:
    raise AssertionError

Przykłady

import dataclasses
@dataclasses.dataclass(frozen=True)
class Point:
    x: int

p = Point(4)
print(p == Point(4))
try:
    p.x = 9
except dataclasses.FrozenInstanceError as error:
    print(type(error).__name__)

Wynik

True
FrozenInstanceError

Przy frozen=True przypisanie p.x zgłasza FrozenInstanceError, choć lista przechowywana w zamrożonym polu nadal może się zmieniać.

Źródła