A maioria das classes que analistas escrevem são registros: alguns campos com nome e pouco comportamento. @dataclass escreve o código repetitivo para você. Você lista os campos com os tipos, e ele gera __init__, __repr__ e __eq__:
from dataclasses import dataclass, field
@dataclass
class Order:
id: str
total: float
tags: list = field(default_factory=list)
Os campos podem ter valores padrão, mas um padrão do tipo lista ou dicionário deve usar field(default_factory=list), para que cada objeto receba o seu.
@dataclass(order=True) permite ordenar objetos; eles são comparados campo a campo, na ordem em que foram escritos. @dataclass(frozen=True) deixa os objetos somente leitura, o que também permite colocá-los em conjuntos e usá-los como chaves de dicionário.
__post_init__ é executado depois do __init__ gerado, e é o lugar para limpar ou verificar valores. asdict(obj) transforma uma dataclass em um dicionário, pronto para JSON ou CSV.
Saída: (Order(id='SO-1', total=42.0), True, {'id': 'SO-1', 'total': 42.0}). repr, == e asdict vêm prontos.