CKTIS / Python
dataclasses.dataclass
Gera por predefinição o inicializador, a representação e a comparação por valor a partir das anotações dos campos.
Versão: Python 3.14; repository image, production runtime not attested
Sintaxe
@dataclasses.dataclass(frozen=True)Gera por predefinição o inicializador, a representação e a comparação por valor a partir das anotações dos campos.
O método gerado não garante que os valores dos campos admitam hash. hash de Item([]) gera TypeError devido à lista incluída no cálculo. Sem __hash__ explícito, eq=True com frozen=True gera o hash, uma classe mutável com eq=True não admite hash e eq=False mantém a regra herdada. unsafe_hash=True força a geração. slots=True devolve uma classe nova. Os campos das bases seguem a MRO inversa e um campo redefinido mantém a posição. A igualdade gerada compara os campos selecionados de instâncias da mesma classe exata. Dois Point(4) são iguais.
Com frozen=True reatribuir p.x gera FrozenInstanceError, mas uma lista dentro de um campo congelado pode mudar.
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
Exemplos
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__)
Resultado
True FrozenInstanceError
Com frozen=True reatribuir p.x gera FrozenInstanceError, mas uma lista dentro de um campo congelado pode mudar.