أصناف البيانات

أغلب الأصناف تحمل بيانات فقط: __init__ ينسخ المعاملات إلى self، ثم تكرّر __repr__ و__eq__ الحقول نفسها. وحين تضيف حقلًا وتنسى تحديث __eq__ يصير الخطأ صامتًا.

@dataclass يولّد هذه الدوال من الحقول المُعلَنة بأنواعها. تكتب done: bool = False فيصير معاملًا بقيمة افتراضية، وتحصل على repr يعرض الحقول ومقارنة بالقيمة بلا سطر إضافي. وfrozen=True يمنع التعديل بعد الإنشاء، ويجعل الكائن صالحًا للمجموعات ولمفاتيح القواميس.

وهو يحميك من فخّ قديم: القيمة الافتراضية القابلة للتغيير. tags=[] في __init__ تُنشأ مرّة واحدة عند تعريف الدالة، فتتشاركها كل الكائنات. لذلك يرفضها @dataclass، والبديل field(default_factory=list) الذي يصنع قائمة جديدة لكل كائن.