アナリストが書くクラスのほとんどはレコードです:名前の付いたいくつかのフィールドと、わずかな振る舞いです。@dataclassは決まりきったコードを代わりに書いてくれます。型を付けてフィールドを並べると、__init__、__repr__、__eq__が作られます:
from dataclasses import dataclass, field
@dataclass
class Order:
id: str
total: float
tags: list = field(default_factory=list)
フィールドには既定値を付けられますが、リストや辞書の既定値にはfield(default_factory=list)を使わなければなりません。そうすれば、各オブジェクトがそれぞれのものを持ちます。
@dataclass(order=True)を使うとオブジェクトを並べ替えられます。書かれた順にフィールドごとに比べられます。@dataclass(frozen=True)はオブジェクトを読み取り専用にし、集合に入れたり辞書のキーとして使ったりできるようにもします。
__post_init__は作られた__init__の後に実行され、値をきれいにしたり確かめたりする場所です。asdict(obj)はデータクラスを辞書にし、JSONやCSVに使えるようにします。
Out: (Order(id='SO-1', total=42.0), True, {'id': 'SO-1', 'total': 42.0})。repr、==、asdictが自動で付いてきます。