Python dataclasses are a feature introduced in Python 3.7 that simplify the creation of classes primarily used to store data. They reduce boilerplate code by automatically generating common special methods like __init__, __repr__, __eq__, and __hash__ based on field type annotations.

Key Features

• Automatic Method Generation: The @dataclass decorator generates __init__, __repr__, and __eq__ methods, enabling instantiating, printing, and comparing objects without writing them manually.

• Default Values: Fields can have default values using standard Python syntax. Non-default fields must come before default ones.

• Customization: Use the field() function to control behavior like repr, compare, default_factory, or init (e.g., field(default_factory=list) for mutable defaults).

• Immutability: Set frozen=True to make instances immutable and enable hashing, allowing use as dictionary keys.

• Memory Efficiency: Use slots=True to reduce memory usage by limiting instance attributes to defined fields.

• Keyword-Only Arguments: Use kw_only=True to require all arguments to be passed as keywords.

Common Use Cases

• Data containers (e.g., Person, Book, Point).

• Configuration objects.

• API response models.

• Representing structured data in pipelines or databases.

Conversion Methods

• asdict() – Convert a dataclass instance to a dictionary.

• astuple() – Convert to a tuple of values.

• replace() – Create a new instance with specified fields updated.

Example

from dataclasses import dataclass, field
from typing import List

@dataclass
class Person:
    name: str
    age: int
    hobbies: List[str] = field(default_factory=list)
    is_active: bool = True

    def __post_init__(self):
        if self.age < 0:
            raise ValueError("Age cannot be negative")

person = Person("Alice", 30, ["reading"])
print(person)  # Person(name='Alice', age=30, hobbies=['reading'], is_active=True)
print(asdict(person))  # {'name': 'Alice', 'age': 30, 'hobbies': ['reading'], 'is_active': True}

Dataclasses are ideal for clean, readable, and maintainable code when working with structured data.