База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Python

dataclasses.dataclass

От анотациите на полетата по подразбиране създава инициализатор, представяне и сравнение по стойност.

Версия: Python 3.14; repository image, production runtime not attested

Синтаксис

@dataclasses.dataclass(frozen=True)

От анотациите на полетата по подразбиране създава инициализатор, представяне и сравнение по стойност.

Генерираният метод не гарантира хешируеми стойности на полетата. hash за Item([]) поражда TypeError поради списъка, включен в изчислението. Без собствен __hash__ eq=True с frozen=True създава хешираща функция, изменяем клас с eq=True не е хешируем, а eq=False запазва наследеното правило. unsafe_hash=True налага генериране. slots=True връща нов клас. Полетата на базите се събират по обратния MRO, а предефинирано поле запазва позицията си. Генерираното равенство сравнява избраните полета на екземпляри от точно един и същ клас. Два Point(4) са равни.

При frozen=True присвояването на p.x поражда FrozenInstanceError, но списък в замразено поле може да се променя.

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

Примери

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__)

Резултат

True
FrozenInstanceError

При frozen=True присвояването на p.x поражда FrozenInstanceError, но списък в замразено поле може да се променя.

Източници