Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Python

dataclasses.dataclass

Genera por defecto inicializador, representación e igualdad por valor a partir de las anotaciones de campos.

Versión: Python 3.14; repository image, production runtime not attested

Sintaxis

@dataclasses.dataclass(frozen=True)

Genera por defecto inicializador, representación e igualdad por valor a partir de las anotaciones de campos.

El método generado no garantiza que los valores de los campos sean hashables. hash sobre Item([]) produce TypeError por la lista incluida en el cálculo. Sin __hash__ explícito, eq=True con frozen=True genera el hash, una clase mutable con eq=True queda sin hash y eq=False conserva la regla heredada. unsafe_hash=True fuerza su generación. slots=True devuelve una clase nueva. Los campos base se reúnen en MRO inverso y un campo redefinido conserva su posición. La igualdad generada compara los campos seleccionados entre instancias de la misma clase exacta. Dos Point(4) son iguales.

Con frozen=True reasignar p.x produce FrozenInstanceError, aunque una lista dentro de un campo congelado puede cambiar.

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

Ejemplos

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

Con frozen=True reasignar p.x produce FrozenInstanceError, aunque una lista dentro de un campo congelado puede cambiar.

Fuentes